谷歌广告(AdWords)数据连接器

文档
设置谷歌广告(AdWords)

快速详细信息

数据连接器技术 API (Google AdsAPI v10)
数据分类(细分)

在默认配置中,您的数据将按以下方式细分:

  • 国家
  • 广告系列
  • 广告系列(广告组)
  • 子广告网络(广告网络类型)。

要选择不同的配置,请参阅下面的数据映射

我们从多长时间前提取数据 每天,Singular 都会提取 7 天前的数据。每周一,Singular 会提取 30 天前的数据。
时区 由客户在谷歌设置中按账户定义
创意(广告)层面的数据可用吗?
Singular 是否显示您的创意资产? 是(YouTube 视频除外,Singular 仅显示其缩略图)
已知限制
  • 创意不提供国家粒度。
  • 在创意报告中,资产粒度中的安装指标是通过"biddable_app_install_conversions "映射的;这与使用"metrics.conversions"的其他粒度不同。

数据映射

您可以通过几种细分配置之一获取数据,每种配置提供一组不同的维度,各有其优势和局限性。

  • 默认配置为国家。要选择其他配置,请联系 Singular 支持。
  • 都会区(DMA)配置只适用于美国的广告(DMA 信息只适用于美国)。如果您的部分或全部广告活动在美国以外地区开展,请使用城市配置。
  • 由于 Google Ads API 的限制,关键字 发布者 配置不包括 UAC广告系列的数据
  • 虽然关键字发布者配置不包括国家或其他位置维度,但 Singular 可能会根据目标国家设置提供国家。
  • 年龄性别 细分可作为单独的人口统计细分(如女性/男性、20-29 岁等。)

术语提示:

  • Singular的 "创意"与谷歌广告的 "广告"相对应。
  • Singular的新资产维度与谷歌广告的资产相对应。我们之所以添加这一新的粒度,是因为在谷歌中,某些类型的广告(如 UAC(移动应用程序)广告)包含多个资产。
  • 有关 Singular 报告中所有字段的说明,请参阅Singular Metrics and Dimensions Glossary
  • 有关如何在 Google 中运行创意报告的更多提示,请参阅如何在 Meta 和 Google Ads 中运行创意报告?
国家/地区 都市 (DMA) 城市 关键词 关键词+质量得分 发布者 购物 视频

Singular UI 中的字段 Singular API 中的字段 谷歌国家分类中的字段
尺寸
帐户 ID adn_account_id customer.id
账户名称 adn_account_name customer.descriptiveName
应用程序站点 ID app_site_id campaign.appCampaignSetting.appId
资产 ID asset_id asset.id
资产名称 asset_name asset.name(对于视频类型的资产,我们使用 "asset.youtubeVideoAsset.youtubeVideoTitle)
活动 URL adn_campaign_url ad.finalUrl
如果不可用,则使用 ad.trackingUrlTemplate
国家/地区 country_field geographicView.countryCriterionId
创意格式 创意格式 广告类型
创意 ID creative_id adGroupAd.ad.id
创意名称 创意名称 adGroupAd.ad.name
创意报告 URL creative_reported_url adGroupAd.ad.finalUrls.0
日期 日期字段 segments.date
最终 URL final_url campaign.finalUrls OR
adGroupCriterion.finalUrls OR
adGroup.ad.finalUrls
网络广告系列 ID adn_campaign_id campaign.id
网络广告系列名称 adn_campaign_name campaign.name
网络创意 ID adn_creative_id adGroupAd.ad.id
网络创意名称 adn_creative_name adGroupAd.ad.name
网络子广告系列 ID adn_sub_campaign_id adGroup.id
网络子广告系列名称 adn_sub_campaign_name adGroup.name
OS 操作系统 campaign.appCampaignSetting.appStore
平台 平台 campaign.appCampaignSetting.appStore和segments.device的组合
公共 ID site_public_id campaign.appCampaignSetting.appId
重定向 保留 campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_' 子广告网络
子广告网络 adn_subadnetwork segments.adNetworkType
目标国家 target_countries_str 查看国家
文本 创意文本 要创建此字段,我们需要使用广告中任何可用的文本字段,这些字段可能因广告类型而异。例如,对于 UAC,Google Ads 中的字段是 asset.textAsset.text。如果有多个文本(如标题+描述),我们会将它们连接成一个字符串。
时区 adn_timezone customer.timeZone
(Singular从 Adwords 接收客户时区的时间数据并转换为 UTC)。
跟踪 URL tracking_url adGroupAd.ad.trackingUrlTemplate
资产性能
asset_performance performance_label
指标
成本 成本 metrics.costMicro
网络点击次数 adn_clicks metrics.clicks
网络印象 adn_impressions metrics.impressions
网络安装 网络安装 metrics.conversions / metrics.allConversions
原始成本 原始成本 metrics.costMicro
原始货币 原始货币 customer.currencyCode
视频浏览量 视频浏览量 metrics.videoViews
已完成的视频浏览量 已完成视频浏览量 metrics.videoo_quartile_p100_rate
视频浏览量 - 25 视频浏览量 - 25 metrics.video_quartile_p25_rate
视频浏览量 - 50% 视频观看次数_50 metrics.video_quartile_p50_rate
视频观看次数 - 75 视频观看次数_75 metrics.video_quartile_p75_rate

Singular 还支持为该合作伙伴提取营销活动属性,详情请点击此处

特殊设置说明

身份验证

有关设置数据连接器的一般信息,请参阅数据连接器常见问题

设置 AdWords 数据连接器时,系统会要求您使用 Google Ads 账户登录。我们强烈建议使用 Google Ads 管理员帐户(以前称为 MCC 帐户)登录。

使用谷歌广告管理器账户(MCC),我们可以同时访问您的所有广告账户。然后,您就可以从列表中选择要将哪些账户纳入 Singular 报告。如果不使用经理账户(MCC),则必须为每个广告账户添加单独的数据连接器。

查找客户 ID(经理账户和个人账户):

  1. 登录Google Ads 帐户
  2. 单击右上角的帮助图标。
  3. 在菜单底部找到客户 ID

转换事件

除了上表中的默认指标外,Singular 还可以从 Google Ads 中提取您需要的任何指标,并在您的 Singular 报告中显示其统计数据。

如果您想了解资产层面更详细的信息,可以考虑添加 "biddable-app-post-install-conversion "作为事件。这些数据来自 Google Ad 的 API。通过该功能,您可以将 "应用内操作 "事件的其他数据添加到各自的广告系列中。值得注意的是,转换事件缺少队列数据,只与'实际'队列期相关联。"

要在 Singular 中设置转换事件,请采取以下步骤:

  1. 在 Singular 中,进入 "设置">"事件"。如果有 "自定义事件"和"转换事件"选项卡,请选择 "转换事件"。
  2. 单击 "新建事件"。
  3. AdWords下拉菜单中,您将看到 AdWords 提供的指标列表。您可以将每个活动映射到一个单独的 Singular 事件中,也可以将多个指标合并到一个事件中。

    第二天,当 Singular 提取账户的每日数据时,也会提取这些活动的统计数据。

  4. 当 Singular 为新的转换事件填充了一些数据后,您在 "报告"页面运行报告时,就可以从 "事件"下拉菜单中选择转换事件。

常见问题和故障排除

如何找到我的经理账户 ID(MCC ID)

要查找您的客户 ID(经理账户和个人账户均适用),请执行以下操作

  1. 登录Google Ads 帐户
  2. 单击右上角的帮助图标。
  3. 在菜单底部查找客户 ID

有关详细信息,请参阅 Google 文档中的 "关于GoogleAds 管理员帐户"。

为什么无法验证我的 Google Ads Manager 帐户?

在 Google Ads Manager 帐户中,转到 "设置">"网络设置"。确保已打开API 访问。然后尝试在 Singular 中重新验证 Google Ads Manager 帐户。

google_auth.png

为什么有时即使我使用了不同的分类,在报告中仍能看到国家数据

当您使用的分类不提供国家信息时,Singular会通过查看Google中的营销活动 目标设置 和/或跟踪器数据(如果我们有的话)来提供国家粒度:

  1. 如果营销活动只针对一个国家,我们就会在报告中显示这个国家。
  2. 如果有多个目标国家/地区,并且我们也有同一营销活动的跟踪器数据,我们将根据跟踪器数据中每个国家/地区的安装比例来估算每个国家/地区的成本。请参阅如何计算每个国家的成本指标?
Singular 如何提取 AdWords 营销活动的网络安装量

Google Ads 会跟踪不同类型的所谓 "转换行为",包括应用程序下载、用户注册、购买等。默认情况下,由于我们的大多数客户都对应用程序的安装感兴趣,因此我们会提取下载类型的转换,并在报告的Network Installs字段中显示其指标。

注:NetworkInstalls 是 Singular 中的一个指标,反映的是广告网络报告的安装次数,不要与Installs 混淆,后者通常基于来自归因跟踪器的数据。对于 Adwords 而言,网络安装次数是 Adwords 报告的 "first_open "转化次数。

建立报告查询时,可以在 "来源指标 "部分选择 "网络安装量"。更多信息,请参阅什么是 "源指标"?

Singular会从AdWords中提取创意吗?

是的,Singular会提取创意指标以及创意本身(图片、文本、视频等)。无论是使用旧版 AdWords 集成还是新版 AdWords 集成,情况都是如此。但是,只有新版集成才会显示UAC 营销活动的创意

什么是 AdWords 中的"创意"创意 "和 "资产 "有什么区别

Singular的 "创意"与谷歌广告的 "广告"相对应。

Singular的新 "资产"维度与谷歌广告的 "资产"相对应。我们之所以添加这一新的粒度,是因为在谷歌中,某些类型的广告(如 UAC(移动应用程序)广告)包含多个资产。资产的安装报告来自指标 "biddable_app_install_conversions";这与使用"metrics.conversions "的其他粒度不同。

Singular 支持哪些Google 广告类型

Singular 支持以下谷歌广告类型:

广告类型 包含的广告资产
文本 图片 视频
电子邮件
酒店
本地
文本
扩展文本
扩展动态搜索
购物产品
智能购物
仅呼叫
HTML5 上传
动态 HTML5
响应式搜索
传统响应式搜索
传统应用程序安装
响应式显示
视频
视频压盖
视频流中不可跳过的视频
视频外流
视频 trueview 发现
视频流中的 trueview
视频响应
应用程序(UAC)
应用程序参与(UAC - 深度链接广告)
应用程序预注册

注意:Google 的广告类型名称("应用程序参与"、"响应式搜索 "等)不会出现在您的 Singular 报告中。您在报告中看到的 "创意类型"维度与此无关,它显示的是创意是图片、文本还是视频。

我正在提取国家分类。为什么我看到的行中没有国家信息

当谷歌在不同端点为同一营销活动提供的数据存在差异时,就会出现这种情况。

当Singular从谷歌广告API提取数据时,会执行以下步骤:

  1. 从相应的 Google Ads API 端点(本例中为location_view端点,提供国家信息)提取所选细分数据。
  2. 从 Google广告系列端点提取相同广告系列的数据,以获得完整指标。
  3. 比较每个广告系列的指标,如有必要,添加一行以调整数据。请参阅下面的示例。请注意,广告系列级数据被视为真实数据源

Screen_Shot_2019-12-01_at_19.29.13.png

为什么我的创意报告中看不到视频

Google 的隐私政策不允许我们下载 YouTube 视频。因此,对于视频创意,我们包括视频缩略图和 YouTube 上的视频链接。

视频浏览量视频浏览量 - 25%、50%、75% 之间有什么区别?视频浏览量是否可以高于或低于视频浏览量--已完成

视频浏览量指标是对视频浏览量的统计。它统计了视频的所有观看次数,无论视频是否被完整观看,还是只被观看了一秒钟。

视频浏览量 - 25%、50% 和 75%指标分别计算有多少人观看了您的视频达到 25%、50% 或 75%。同样,完整视频浏览量指标只计算完整观看视频的浏览量。要计算这些值,我们使用 Google 建议的公式:印象 * 视频观看率。

根据您的需要,您可能希望使用其中一个百分比指标来代替视频浏览量指标。请参阅Google 文档中的 "视频播放到 "部分。

注意:YouTube 视频的观看次数与 Google Ads 账户显示的观看次数之间存在固有差异。YouTube 观看次数和 Google Ads 账户观看次数使用不同的指标计算。

  • YouTube 将观看视频至少 30 秒或视频结束(以先到者为准)算作一次观看。
  • Google Ads 将观看次数算作广告印象,当广告在 YouTube 或合作伙伴网站上显示时,广告印象会被计算在内。
  • 因此,我们可能会看到 YouTube 分析中报告的观看次数与 Google Ads 账户中显示的观看次数存在差异。
  • 此外,YouTube 分析会实时更新,而 Google 广告数据可能需要 48 小时才能更新。

此外,YouTube 广告和浏览量指标的工作方式与传统在线广告不同。在运行 YouTube 广告时,只有当有人观看广告 30 秒或以某种方式与广告进行互动(如点击 "行动呼吁 "叠加或配套横幅)时,才会产生费用。因此,重要的是要关注参与度指标,如浏览率和赢得的行动, 而不仅仅是浏览量来衡量 YouTube 广告的效果。

在创意报告中看不到媒体捆绑包的哪些内容?

媒体捆绑是与 "图片"、"文本 "和 "视频 "一样的另一种创意类型。如果您的任何广告创意是媒体捆绑包,您将可以看到这些创意的指标,但看不到创意本身,因为 Google Ads API 不提供创意。

为什么 "创意名称"维度不总是可用?

对于 UAC 创意,Google 不提供名称,只提供 ID。