菜单

Google Ads 广告集成方案

适用于 SA3.0.4 及以上版本。

该功能由独立 license 控制，若有需求，请联系您的客户经理。

若您的 APP 正在投放海外广告以获取新用户，希望获取海外广告平台的广告聚合数据（如展、点、消）到神策平台，可使用此功能。

功能概述

支持对接Google Ads，通过其开放的API完成广告层级数据，如展、点、消数据的拉取。拉取后以事件形式入库神策，可在分析模型中完成分析。同时可以与后链路中的用户行为数据关联分析。

接口
数据粒度
数据更新频率
归因
成本
展示
点击
转化
Reporting API 聚合数据 天粒度   ✅ ✅ ✅ ✅

功能入口

渠道追踪 > 三方数据集成 > 广告生态 > Google Ads

接入说明

Google Ads 数据说明

支持通过Google Ads API拉取 4种广告层级的广告数据，详情可参考官方文档：Google Ads API官方文档

内置 4个模版，涵盖广告常用的指标及维度。

  • Ad Group Ad 模板：Ad层级的广告数据，原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
metrics
  • metrics.all_conversions
  • metrics.all_conversions_value
  • metrics.active_view_impressions
  • metrics.active_view_cpm
  • metrics.active_view_ctr
  • metrics.impressions
  • metrics.clicks
  • metrics.conversions
  • metrics.cost_micros
  • metrics.cost_per_all_conversions
  • metrics.cost_per_conversion
  • metrics.average_cost
  • metrics.average_cpc
  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.average_cpv
  • metrics.ctr
  • metrics.value_per_all_conversions
  • metrics.value_per_all_conversions_by_conversion_date
  • metrics.value_per_conversion
  • metrics.value_per_conversions_by_conversion_date
group by
  • customer.id
  • customer.status
  • customer.time_zone
  • customer.currency_code
  • campaign.id
  • campaign.name
  • campaign.status
  • campaign.app_campaign_setting.app_id
  • campaign.advertising_channel_type
  • campaign.advertising_channel_sub_type
  • ad_group.id
  • ad_group.name
  • ad_group.status
  • ad_group.type
  • ad_group_ad.ad.id
  • ad_group_ad.ad.name
  • ad_group_ad.ad.type
  • ad_group_ad.status
  • segments.date
  • segments.ad_network_type
  • segments.slot
  • Campaign 模板：Campaign层级的广告数据，原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
metrics
  • metrics.all_conversions
  • metrics.all_conversions_value
  • metrics.active_view_impressions
  • metrics.active_view_cpm
  • metrics.active_view_ctr
  • metrics.impressions
  • metrics.clicks
  • metrics.conversions
  • metrics.cost_micros
  • metrics.cost_per_all_conversions
  • metrics.cost_per_conversion
  • metrics.average_cost
  • metrics.average_cpc
  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.average_cpv
  • metrics.ctr
  • metrics.value_per_all_conversions
  • metrics.value_per_all_conversions_by_conversion_date
  • metrics.value_per_conversion
  • metrics.value_per_conversions_by_conversion_date
  • metrics.view_through_conversions
  • metrics.current_model_attributed_conversions
  • metrics.current_model_attributed_conversions_value
group by
  • campaign.id
  • campaign.name
  • campaign.status
  • campaign.campaign_group
  • campaign.app_campaign_setting.app_id
  • campaign.advertising_channel_type
  • campaign.advertising_channel_sub_type
  • segments.date
  • segments.ad_network_type
  • customer.id
  • customer.status
  • customer.time_zone
  • customer.currency_code
  • Geographic View模版：Geographic层级的广告数据，原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
metrics
  • metrics.all_conversions
  • metrics.all_conversions_value
  • metrics.average_cost
  • metrics.average_cpc
  • metrics.average_cpm
  • metrics.average_cpv
  • metrics.ctr
  • metrics.clicks
  • metrics.conversions
  • metrics.conversions_value
  • metrics.cost_micros
  • metrics.cost_per_all_conversions
  • metrics.cost_per_conversion
  • metrics.impressions
  • metrics.interactions
group by
  • customer.id
  • customer.status
  • customer.time_zone
  • customer.currency_code
  • campaign.id
  • campaign.name
  • campaign.status
  • ad_group.id
  • ad_group.name
  • ad_group.status
  • ad_group.type
  • segments.ad_network_type
  • segments.date
  • geographic_view.country_criterion_id
  • geographic_view.country_name
  • geographic_view.location_type
  • geographic_view.resource_name
  • Conversion Action模版：转化行为的广告模版。原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
metrics
  • metrics.all_conversions
  • metrics.all_conversions_value
group by
  • customer.id
  • customer.status
  • customer.time_zone
  • customer.currency_code
  • conversion_action.app_id
  • conversion_action.id
  • conversion_action.mobile_app_vendor
  • conversion_action.name
  • conversion_action.origin
  • conversion_action.owner_customer
  • conversion_action.type
  • segments.date

接入前准备

需要完成与Google Ads的授权认证，方可通过Google Ads API获取广告数据。详情可参考官方文档：Google Ads API官方文档

如需进行 Google Ads API 调用，您应具备以下详细信息。

Google Ads Manager 经理账号：您需要拥有 Google Ads 经理账号才能申请 Google Ads API。

Developer Token 开发者令牌：此令牌可让您的应用连接到 Google Ads API。每个开发者令牌都分配有一个 API 访问权限级别，该级别控制着您每天可以进行的 API 调用次数以及可以进行调用的环境。获取开发者令牌：开发者令牌是一个包含 22 个字符的字母数字字符串，可让您的应用连接到 Google Ads API。在 Google 向您分配令牌后，您可以在 Google Ads 经理账号的 API 中心页面上查看该令牌或创建新令牌。

OAuth 2.0凭证 (Client & Secret)：Google API 控制台项目用于为您的应用生成 OAuth 2.0 凭据。然后，应用将使用这些凭据对用户进行身份验证，并获得用户授权来管理其 Google Ads 账号。此授权稍后将由您的应用用于向 Google Ads 账号发出 API 调用。项目还启用 API 以接受调用。

Google Ads account 广告客户账号：这是您要向其发出 API 调用的账号。您需要获得对相应账号的操作权限， 例如提取报告或更改广告系列的权限。您还需要您要向其发出 API 调用的账号的 10 位数账号。在 Google Ads 网页界面中，此值以 123-456-7890 的形式显示。此账号会作为参数传递给 Google Ads API 调用，但不含连字符：1234567890。

步骤 内容 说明
第一步 创建Google Ads Manager Account 经理账号 可参考：官方文档
第二步 用Google Ads Manager账号申请Developer Token

使用Google Ads Manager Account登录 Google Ads后台，左侧导航中选择Admin，然后选择API Center。填写表单后完成Developer Token的申请。
第三步 获取应用凭证，即Client ID与Secret

登录Google Cloud Platform，

1. 通过Create Project创建一个项目。然后选择 API & Services，再选择 Enable APIs and services，跳转到API Library之后，搜索Google Ads, 将其状态进行Enable。

2. 左侧导航中进入Credentials，选择 Create credentials, 下拉选项中选择 OAuth client ID. 需要先进行Consent Screen的配置。点击Configure，跳转至Branding页面，点击Get started开始配置。

3. 创建Client时，选择Application Type为 Web application,填写Authorized redirect URIs，此处可以先任意填一个地址，后续替换为神策产品中提供的地址即可。

4. 点击左侧导航栏的Audience，点击Publish App
第四步 授予Google Ads API权限

创建client ID成功后，左侧导航中进入Data Access，添加client允许访问的scope，搜索Google Ads API并进行添加
第五步 关联Google Ads Manager账号与Google Ads广告客户账号

以manager账号登录Google Ads，选择左侧导航栏Accounts-选择Sub-account settings,点击+,选择link existing account，填写后将向Google Ads广告账号发送验证链接。

以Google Ads广告账号登录，选择左侧导航栏Admin-选择Access and security，选择Mangers Tab，可以看到在上一步中发送的验证请求，选择Accept。后续Manager即可访问该广告账号

配置Google Ads接入方案

主要包括以下3个部分的配置：

1. 方案基本信息

2. 授权配置

该部分填入的字段主要用于与Google Ads进行鉴权以及明确要拉取的广告账号范围。请参考上一段落「接入前准备」中的内容，从Google Ads平台获取相应的字段。

最多支持拉取100个Google Ads广告账号的数据，如果用户有超过100个Google Ads广告账号，则可以创建多个拉取方案。

Client ID需全平台保证唯一性，如果提示重复，可以检查各个项目中是否存在相同的Client ID。

二次编辑时，Client ID不可修改。修改其他内容并保存时，会对填入内容进行校验，例如：填写的Developer Token无权访问Customer ID时，则会报错。

3. 数据拉取配置

 

点击「确认创建」后，需要完成与Google Ads的授权流程，方案方可创建成功。授权流程包括如下图中的三步。

点击蓝字「去授权」后，将跳转至Google Ads授权页面，登录Google账号。（注意此处登录时，需要以创建Google manager账号对应的Google账号登录）。由于在Google Cloud Console Publish App时，未完成Google 要求的认证流程，因此会出现此App不安全的提示，点击Advanced，选择继续。

以上步骤都完成后，在神策弹窗中选择「已完成授权」。如果此次授权不成功，将通过Error Code告知报错信息。

方案创建成功后，每天将按照模版内容定时拉取Google Ads数据。

数据回溯

Google Ads数据拉取方案支持「数据回溯」，可以选择最长180天时长的时间段，拉取该时间段内的广告数据。

数据入库说明

拉取的Google Ads和Meta Ads数据，统一以事件入库，原始字段将进行标准化，以sensors_ad开头作为属性入库。

注：该部分数据会被纳入集群的消耗事件量。

这部分事件将使用一个固定值作为其用户标识，可理解为用户标识是一个虚拟用户。

不同模版对应的入库事件如下：

Ad Group Ad 模板：google_ads_ad_group_ad

Campaign 模板：google_ads_campaign

Geographic View模版：google_ads_geographic

Conversion Action模版：google_ads_conversion_action

以下列举一些常见的原始数据及相应的入库属性：

原始字段 入库字段
customer.id sensors_ad_customer_id
customer.time_zone sensors_ad_customer_timezone
customer.currency_code sensors_ad_customer_currency
media_source sensors_ad_media_source
campaign.id sensors_ad_campaign_id
campaign.name sensors_ad_campaign_name
ad_group.id sensors_ad_ad_group_id
ad_group.name sensors_ad_ad_group_name
ad_group_ad.ad.id sensors_ad_ad_id
ad_group_ad.ad.name sensors_ad_ad_name
segments.date sensors_ad_segments_date
geographic_view.country_name sensors_ad_country
metrics.all_conversions sensors_ad_metrics_all_conversions
metrics.impressions sensors_ad_metrics_impressions
metrics.clicks sensors_ad_metrics_clicks
metrics.cost_micros sensors_ad_metrics_cost

在分析模型中进行分析

将Google Ads数据作为事件入库后，可在事件分析中选择相应事件，分析Google Ads的展示数、点击数、花费等指标。

权限

管理员角色默认可进行Google Ads方案的配置。也可将配置方案与查看方案的权限点分配给普通用户。

上一个
AppsFlyer Pull API
下一个
Meta Ads 广告集成方案
最近修改: 2026-01-29