Google ADs

1.1 应用场景

Google ADs 平台的用户计划对广告账户数据进行分析，以帮助他们更好的了解业务数据，为未来的决策提供有力支撑。

1.2 功能简介

本产品支持直接与 Google ADs  平台对接获取数据，对取到的数据进行分析，且获取的数据报告类型在不断的丰富中。

1.3 注意事项

「Google ADs」为付费数据源，请管理员开通试用或者购买该数据源。

连接 Google ADs 数据源需要获取下图中的授权信息，请根据本小节步骤获取。

2.1 申请 Developer token

1）使用 Google Ads Manager Account 登录 Google Ads ，在上方搜索栏中搜索「API」，点击进入「API center」。如下图所示：

2）请填写 Google Ads API Token Application 完成 Developer token 的申请。您必须提供访问权限为 Basic Level 的 Developer Token，即完成申请后的 Developer Token，不能使用权限为 Test Account 的 Developer Token。

为了方便您更为快速地完成申请，我们整理了申请表单中的一些问题解答，你可以访问 Google AD 开发者权限申请材料 进行查看。另外，您还可以参考 Google Ads 官方文档 获取更多 Developer token 的信息。

3）填完申请表格之后，需等待 Token Review Team 批准你的 Developer Token。审核大多数会在 1 个工作日内完成，一般不会超过 3 天。

4）申请成功后，再次进入「API center」，即可查看您的开发者令牌以及访问等级。请复制 Developer Token 信息，填写在本产品中。

2.2 生成 Client ID 与 Client Secret

在您获取 Developer Token 的同时，您还需要创建 API 的访问凭据，即 Client ID 与 Client Secret。

在创建 API 凭据之前，您需要在 Google Cloud Platform 中拥有一个项目，并且该项目开启了 Google Ads API。

2.2.1 在 Google Cloud Platform 内创建一个项目

1）如果您在 Google Cloud Platform 中还没有创建过项目，则可以登录 Google Cloud Platform ，点击「CREATE PROJECT」创建项目。如果您已经创建过一个项目，可以跳过此步骤。 

2）根据提示填写信息后，点击「CREATE」，完成创建。如下图所示：

2.2.2 开启 Google Ads API 权限

完成项目的创建后，接下来就需要开启 Google Ads API 权限。

1）在 Google Cloud Platform 后台的顶部搜索栏中搜索「Google Ads API」，进入到介绍页面。

2）如果页面中下图所示区域显示「ENABLE」，则说明项目尚未开启 Google Ads API 权限。点击「ENABLE」开启权限即可。 

2.2.3 创建 API 凭据，获取 Client ID 与 Client Secret

开启 Google Ads API 权限后，接下来需要创建一个具备 Google Ads API 权限的 API 凭据，即拉取数据时所需的 Client ID 与 Client Secret。

• 开启 Google Ads API 权限时，您应该会跳转到以下页面。此时点击「CREATE CREDENTIALS」即可进入到创建凭据的流程中。

• 如果您没有找到上述页面，也可以在页面左上角的菜单栏中，找到「APIs & Services>Enabled APIs & services」并进入。在页面下方列表中寻找「 Google Ads API」，点击进入。如下图所示：

此时选中「CREDENTIALS」标签页，点击「+ CREATE CREDENTIALS」，选择「Help me choose」，亦可进入到创建凭据的流程中。

进入到创建凭据流程，请按照以下步骤完成配置。

1）在 Credential Type 页面，依次选择 Google Ads API、 User Data，点击「NEXT」 。如下图所示：

2）在 Scopes 页，点击「ADD OR REMOVE SCOPES」，在列表中寻找 Google Ads API 并勾选，点击「UPDATE」将其加入到 Scope 列表。如下图所示：

3）点击「SAVE AND CONTINUE」 进入下一步。如下图所示：

4）在 OAuth Client ID 页面，Application type 处选择 「Web application」。如下图所示：

5）请 在Authorized redirect URIs 处配置回调地址：https://dm.shukuajing.com/sync/datasource/auth。如下图所示：

6）完成所有配置后，点击「CREATE」创建凭证。如下图所示：

7）在页面中将展示 Client ID 信息，点击「DOWNLOAD」下载文件，在文件中 Client Secret 信息。如下图所示：

8）可以用记事本打开下载的文件，获取 Client Secret 信息。请复制这两个信息，填写在本产品中。

9）最后，点击进入「OAuth consent screen」，在 Publishing status 栏目点击「PUBLISH APP」，将应用发布成正式版。如下图所示：

2.3 获取 Customer ID 和 Login Customer ID

最后，请您将要拉取数据的广告账户的 Customer ID，以及该用户的广告经理账号的 Customer ID（即后续调用中的 Login Customer ID）。您可以按照以下流程查看这些 ID。

1）进入 Google Ads 后台 ，登录将要拉取数据的广告账户，在左上角获取「Customer ID」。

2）如您需要获取多个广告账户的数据，请切换账号，获取 Customer ID。

2）切换到广告经理账号，同样在左上角获取 Customer ID，即为 Login Customer ID（您也可以直接从广告经理账号的管理员获得其 Customer ID）。 请复制所有的 Customer ID 和 Login Customer ID，信息，填写在本产品中。

1）进入数据连接市场，新增「Google ADs」数据源。如下图所示：

2）在页面填写相关信息，然后「点击授权」进入授权页。如下图所示：

3）使用相关账号授权，看到「已完成」提示，表示授权成功，点击「下一步」。如下图所示：

4）左侧列表中为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表，完成后点击「确定」。如下图所示：

5）在左侧会获取到数据列表。如下图所示：

1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：

2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据

数据源的创建者默认拥有数据源的管理权限，管理者可将此数据源分配给其他成员使用。

点击「权限设置」按钮，在弹窗中即可自定义配置数据源权限，详情参见文档：数据源权限设置

获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。