本文介绍了如何使用 Management API 来管理授权用户的 AdWords 帐户与 Google Analytics(分析)帐户之间的关联。
简介
Management API 中的“AdWords 关联”让您可以获取、列出、创建、更新和删除 Google AdWords 帐户与 Google Analytics(分析)媒体资源之间的关联,并确定哪些数据视图(配置文件)中要出现 AdWords 数据。
要详细了解 AdWords 关联功能的工作原理和好处,请参阅将 Google Analytics(分析)与 AdWords 关联起来(AdWords 帮助中心)以及关联/取消关联 Google Analytics(分析)和 AdWords(Google Analytics(分析)帮助中心)。
开始之前
所有 Google Analytics(分析)API 的访问方法都基本相同。在开始使用 Management API 之前,您应该:
每个客户端库提供单个 Analytics 服务对象来访问所有的 Management API 数据。要创建服务对象,您通常需要完成以下步骤:
- 在 Google Developers Console 中注册您的应用。
- 授予访问 Google Analytics(分析)数据的权限。
- 创建一个 Analytics 服务对象。
如果您未能完成上述步骤,请停止操作,并阅读了解 Google Analytics(分析)API 教程。该教程将为您详细介绍构建 Google Analytics(分析)API 应用的最初几个步骤。完成这些步骤后,您将了解如何访问 Google Analytics(分析)API 以执行实际任务。
使用情形
使用 Management API 的 AdWords 关联功能,以下使用情形将自动得到执行:
- 列出媒体资源的所有 Google Analytics(分析)与 AdWords 之关联
- 创建 Google Analytics(分析)与 AdWords 的新关联
- 删除 Google Analytics(分析)与 AdWords 的关联
- 将数据视图(配置文件)添加/关联到现有的 Analytics/AdWords 关联
- 将数据视图(配置文件)从 Analytics/AdWords 关联中移除
列出媒体资源的所有 Google Analytics(分析)与 AdWords 之关联
要列出媒体资源的所有有效的 Analytics/AdWords 关联,请按以下步骤操作:
- 使用 Management API 或网络界面获取帐户 Id 和媒体资源 Id。
- 执行
entityAdWordsLinks
资源的list
方法。
请参阅 API 参考,详细了解 entityAdWordsLinks
资源的 list
方法。
创建 Google Analytics(分析)与 AdWords 的新关联
要创建 Google Analytics(分析)媒体资源与 AdWords 帐户之间的关联,请按以下步骤操作:
- 使用 AdWords API 或网络界面获取 Customer Id。
- 使用 Google Analytics(分析)Management API 或网络界面获取要与 AdWords 帐户关联的帐户及媒体资源的 Id。
- 通过执行
entityAdWordsLinks
资源的insert
方法,创建 AdWords 与 Google Analytics(分析)之间的关联。
请参阅 API 参考,详细了解 entityAdWordsLinks
资源的 insert
方法。
除 Google Analytics(分析)与 AdWords 的关联
要删除 Google Analytics(分析)媒体资源与 AdWords 帐户之间的关联,请按以下步骤操作:
- 使用 Google Analytics(分析)Management API 或网络界面获取要删除关联的帐户及媒体资源的 Id。
- 使用 Management API 获取“AdWords 关联”的 Id。
- 通过执行
entityAdWordsLinks
资源的delete
方法,删除该关联。
请参阅 API 参考,详细了解 entityAdWordsLinks
资源的 delete
方法。
将数据视图(配置文件)添加到现有的 Analytics/AdWords 关联
要为数据视图(配置文件)报告启用 AdWords 数据,请按以下步骤操作:
- 使用 Google Analytics(分析)Management API 或网络界面获取帐户、媒体资源和数据视图(配置文件)的 Id。
- 使用 Management API 获取要关联到数据视图(配置文件)的“AdWords 关联”的 Id。
- 通过执行
entityAdWordsLinks
资源的patch
方法,添加数据视图(配置文件)。
请参阅 API 参考,详细了解 entityAdWordsLinks
资源的 patch
方法。
将数据视图(配置文件)从 Analytics/AdWords 关联中移除
要为数据视图(配置文件)报告取消关联并移除 AdWords 数据,请按以下步骤操作:
- 使用 Google Analytics(分析)Management API 或网络界面获取帐户、媒体资源和数据视图(配置文件)的 Id。
- 使用 Management API 获取要移除的数据视图(配置文件)所关联的“AdWords 关联”的 Id。
- 执行
entityAdWordsLinks
资源的get
方法,获取“AdWords 关联”的配置文件 Id 列表。 - 从上述第 3 步中获取的列表中删除相应的配置文件 Id。
- 使用第 4 步中的列表,通过执行
entityAdWordsLinks
资源的patch
方法,移除数据视图(配置文件)。
请参阅 API 参考,详细了解 entityAdWordsLinks
资源的 get
方法。
代码示例
AdWords Links
资源让授权用户可以列出、获取、删除、更新、修补和插入“AdWords 关联”。要进行这些操作,您首先需要创建一个 Analytics
服务对象,如开始之前部分所述。
要查看代码示例,了解如何使用“AdWords 关联”,请访问下面的方法参考:
管理“AdWords 关联”
- list — 列出用户可以访问的“AdWords 关联”。
- get — 获取用户可以访问的“AdWords 关联”。
- insert — 创建新的“AdWords 关联”。
- patch — 修补现有的“AdWords 关联”。
- update - 更新现有的“AdWords 关联”。
- delete - 删除现有的“AdWords 关联”。