开始使用

本文档面向希望使用 AdSense Management API 获取其 AdSense 帐号相关信息的开发者。本文档假定您熟悉 Web 编程的概念和 Web 数据格式。

前期准备

获取 AdSense 账号

注册或登录您的 AdSense 账号即可开始。

熟悉 AdSense

如果您不熟悉 AdSense 概念,请在开始编码之前阅读 AdSense 介绍信息,并练习使用 AdSense 界面

选择您的客户端库

客户端库和示例页面中,您可以找到关于可用库和示例的信息。点击与您所选语言对应的标签页,然后点击相应链接下载源代码。 客户端库会为您处理以下事宜:

  • 身份验证
  • 服务发现
  • 构建向 API 发出的请求
  • 响应解析

请阅读相关说明,了解如何安装和配置您选择的客户端库(通常位于代码库根目录下的 README 文件中)。

如果您的实现有特殊需求(例如使用不受支持的语言),您可以向 API 发出直接请求,而不是使用客户端库。

注册应用

要使用 AdSense Management API,您必须通过创建项目并生成客户端 ID 来注册您开发的应用。

注册您的应用

使用您刚刚创建的新凭据,修改客户端库项目的配置文件。如需了解详情,请参阅客户端库文档。

注意:用于注册的 Google 帐号应该是您的开发者帐号,也就是您希望应用的用户将其视为应用开发者的帐号。此帐号无需与 AdSense 登录信息相关联,因为用户在使用该应用时将获得对自己帐号的访问权限。

快速入门教程

请按照以下步骤发出第一个请求。请注意,根据您所使用的库或语言,这些步骤可能会略有不同:

  1. 使用相应示例从 AdSense 帐号中获取广告客户列表。此请求会启动一个一次性过程,在此期间,AdSense 用户对您的项目进行身份验证和授权。

    广告客户代表 AdSense 帐号与 AdSense 产品(如内容广告或搜索广告)之间的关联。一个 AdSense 帐号可以有一个或多个广告客户。

    1. 对于 Web 应用,用户将被重定向到他们可以选择授予访问权限的网站。获得授权后,他们将被重定向到 Google API 控制台中定义的回调网址。
    2. 安装版应用的工作原理与之类似。客户端库将尝试打开浏览器窗口并使用授权代码。对于 Android、Chrome 和 iOS 应用,此方法因平台而异。
  2. 使用适用于 reports.generate 的 Google API Explorer 请求以下报告:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    您可以通过报告深入了解自己的收入,还能了解影响这些收入的因素。通过使用渠道,可以对整个帐号运行预测,也可以对广告单元的子集运行。

  3. 尝试从您的应用请求相同的报告。
  4. 您可以按广告单元过滤报告。使用 adunits.list 获取广告单元列表。请注意,您需要提供广告客户 ID(可在第 1 步中获取)。选择广告单元后,请在 reports.generatefilter 参数中使用其 ID:

    广告单元是用户为广告配置的占位符,用于定义所展示的广告的一些属性(如尺寸和形状)。

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. 请尝试按自定义渠道或网址渠道进行过滤,或混合使用多个过滤条件。

    通过渠道,您可以跟踪广告单元子集的广告效果。渠道有两种类型:网址渠道和自定义渠道。前者可以帮助您跟踪特定网页或网域的效果,而后者可以帮助您跟踪用户选择的特定广告单元组的效果。

在了解参考文档中的其他可用调用和资源后,您可以开始实现该功能。