Google Ads(AdWords)数据连接器

设置 Google 广告(AdWords)

 

快速详细信息

数据连接器技术 应用程序接口(谷歌广告应用程序接口 v10
数据分类(细分)

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

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

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

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

数据映射

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

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

术语提示

  • Singular的 "创意"与谷歌广告的 "广告"相对应。
  • Singular的新资产维度与谷歌广告的资产相对应。我们之所以添加这一新的粒度,是因为在谷歌中,某些类型的广告(如 UAC(移动应用程序)广告)包含多个资产。
  • 有关 Singular 报告中所有字段的说明,请参阅《Singular 指标和维度词汇表》。
Country Metro (DMA) City Keyword Keyword+Quality Score Publisher Shopping Video

Field in Singular UI Field in Singular API Field in Google Country Breakdown
Dimensions
Account ID adn_account_id customer.id
Account Name adn_account_name customer.descriptiveName
App Site ID app_site_id campaign.appCampaignSetting.appId
Asset ID asset_id asset.id
Asset Name asset_name asset.name (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL adn_campaign_url ad.finalUrl
if not available, then ad.trackingUrlTemplate
Country country_field geographicView.countryCriterionId
Creative Format creative_format ad.type
Creative ID creative_id adGroupAd.ad.id
Creative Name creative_name adGroupAd.ad.name
Creative Reported URL creative_reported_url adGroupAd.ad.finalUrls.0
Date date_field segments.date
Final URL final_url campaign.finalUrls OR
adGroupCriterion.finalUrls OR
adGroup.ad.finalUrls
Network Campaign ID adn_campaign_id campaign.id
Network Campaign Name adn_campaign_name campaign.name
Network Creative ID adn_creative_id adGroupAd.ad.id
Network Creative Name adn_creative_name adGroupAd.ad.name
Network Sub Campaign ID adn_sub_campaign_id adGroup.id
Network Sub Campaign Name adn_sub_campaign_name adGroup.name
OS os campaign.appCampaignSetting.appStore
Platform platform A combination of campaign.appCampaignSetting.appStore and segments.device
Public Id site_public_id campaign.appCampaignSetting.appId
Retargeting retention campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network adn_subadnetwork segments.adNetworkType
Target Countries target_countries_str See country
Text creative_text To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. 
Timezone adn_timezone customer.timeZone
(Singular receives time data from Adwords in the client's timezone and converts it to UTC.)
Tracking URL tracking_url adGroupAd.ad.trackingUrlTemplate
Asset Performance
asset_performance performance_label
Metrics
Cost adn_cost metrics.costMicro
Network Clicks adn_clicks metrics.clicks
Network Impressions adn_impressions metrics.impressions
Network Installs adn_installs metrics.conversions / metrics.allConversions
Original Cost adn_original_cost metrics.costMicro
Original Currency adn_original_currency customer.currencyCode
Video Views video_views metrics.videoViews
Completed Video Views completed_video_views metrics.video_quartile_p100_rate
Video Views - 25% video_views_25pct metrics.video_quartile_p25_rate
Video Views - 50% video_views_50pct metrics.video_quartile_p50_rate
Video Views - 75% video_views_75pct metrics.video_quartile_p75_rate

特殊设置说明

身份验证

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

设置 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会通过查看谷歌广告系列目标设置 和/或跟踪器数据(如果我们有的话)来提供国家粒度:

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

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

注:Network Installs 是 Singular 中的一个指标,反映的是广告网络报告的安装次数,不要与Installs 混淆,后者通常基于来自归因跟踪器的数据。 对于 Adwords,Network Installs是 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 Ads 数据可能需要 48 小时才能更新。

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

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

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

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

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