Google Ads (AdWords) 数据连接器

关注
Avatar
Vaibhav Gupta
Updated
设置 Google Ads（AdWords）
成本聚合
设置数据连接器

 

快速详情

数据连接器技术 API (Google Ads API v19)
数据分类（细分）

在默认配置下，您的数据按以下维度分类：

  • 国家
  • 广告系列
  • 子广告系列 (Ad Group)
  • 子广告网络 (Ad Network Type).

如需选择其他配置，请参阅下方的 数据映射。
我们从多长时间前提取数据 Singular 每天提取过去 7 天的数据。每周一还会提取过去 30 天的数据。
时区 由客户在 Google 设置中按账户定义
创意（广告）层面的数据可用吗？ 是
Singular 是否会显示您的创意资产？ 是（YouTube 视频除外，Singular 仅显示其缩略图）
已知限制
  • 创意层面不提供国家粒度。
  • 在创意报表中，资产粒度下的 Installs 指标 映射自 biddable_app_install_conversions"，这与使用以下指标的其他粒度不同："metrics.conversions"

数据映射

您可以按多种分类配置之一获取数据，每种配置提供不同的维度集合，各有其优势和限制。

  • 默认配置为 Country。如需选择其他配置，请联系 Singular 支持团队。
  • Metro (DMA) 配置仅适用于面向美国的广告投放（DMA 信息仅在美国可用）。如果您的部分或全部广告系列在美国境外投放，请改用 City 配置。
  • Keyword 和 Publisher 配置 不包含 UAC 广告系列的数据，这是由于 Google Ads API 的限制。
  • 虽然 Keyword 和 Publisher 配置不包含国家或其他位置维度，但 Singular 可能会根据定向国家设置提供国家信息。
  • 年龄 或 性别 分类可作为单独的人口统计分类提供（例如 女性/男性、20-29 等）。   

术语提示：

  • Singular 的 Creative 对应 Google Ads 的 Ad。
  • Singular 新增的 Asset 维度对应 Google Ads 的 Asset。之所以增加这一新的粒度层级，是因为在 Google 中某些广告类型（例如 UAC 移动应用广告）包含多个资产。
  • 有关 Singular 报表中所有字段的说明，请参阅 Singular 指标与维度术语表。
  • 有关在 Google 中运行创意报表的更多提示，请参阅 如何在 Meta 和 Google Ads 中运行创意报表？
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

Singular 也支持提取此合作伙伴的广告系列属性， 请点击此处查看更多详情。

特殊设置说明

身份验证

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

设置 AdWords 数据连接器时，系统会要求您使用 Google Ads 账户登录。 我们强烈建议使用 Google Ads 管理员账户（原称 MCC 账户）登录。

Google 管理员账户（MCC）可让我们一次性访问您的所有广告账户。之后您可以从列表中选择要纳入 Singular 报表的账户。如果不使用管理员账户（MCC），您就必须为每个广告账户单独添加一个数据连接器。

要查找您的客户 ID（管理员账户和单个账户均适用）：

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

转化事件

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

如果您需要资产层面的更详细洞察，可以考虑将 'biddable-app-post-install-conversion' 添加为事件。这些数据提取自 Google Ads 的 API。此功能可让您将 '应用内操作' 事件的额外数据归入相应的广告系列。请注意，转化事件不含同期群数据，仅与 '实际' 同期群周期关联。

要在 Singular 中设置 转化事件，请执行以下步骤：

  1. 在 Singular 中，前往 Settings > Events。如果同时存在 Custom Events 和 Conversion Events 两个标签页，请选择 Conversion Events。
  2. 点击 New Event。

  3. 在 AdWords 下拉菜单中，您会看到 AdWords 提供的可用指标列表。您可以将每项活动映射到单独的 Singular 事件，也可以将多个指标合并为一个事件。

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

  4. 在 Singular 为新的转化事件填充数据后，当您在 Reports 页面运行报表时，请从 Events 下拉菜单中选择相应的转化事件。

常见问题与故障排查

如何查找我的 管理员账户 ID（MCC ID）？

要查找您的客户 ID（管理员账户和单个账户均适用）：

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

更多信息，请参阅 Google 文档中的 关于 Google Ads 管理员账户。

为什么我无法 验证 我的 Google Ads 管理员账户？

在您的 Google Ads 管理员账户中，前往 Settings > Network Settings。请确保您已开启 API access。然后在 Singular 中重新验证您的 Google Ads 管理员账户。

google_auth.png

为什么即使我使用了其他分类维度，报表中有时仍会显示 国家数据？

当您使用不提供国家信息的分类维度时，Singular 仍会尝试提供国家粒度，方法是查看 Google 中该 广告系列 的定向设置 和/或 追踪器数据 （如果我们有的话）：

  1. 如果该广告系列只定向一个国家，我们会在报表中显示该国家。
  2. 如果定向了多个国家，且我们也有同一广告系列的追踪器数据，我们会根据追踪器数据中各国的安装占比来估算各国成本。请参阅 如何按国家计算成本指标？
Singular 如何提取 AdWords 广告系列的 Network Installs？

Google Ads 会追踪各种它称之为“转化操作”的类型，包括应用下载、用户注册、购买等。由于我们大多数客户关注的是应用安装，因此默认情况下我们提取类型为 download 的转化，并在报表的 Network Installs 字段中展示其指标。

注意： Network Installs 是 Singular 中反映广告网络所报告安装量的指标，不应与 Installs混淆，后者通常基于归因追踪器的数据。对于 AdWords， Network Installs 是 AdWords 报告的 "first_open" 转化次数。

构建报表查询时，您可以在 Network Installs Source Metrics 部分选择该指标。更多信息请参阅 什么是 Source Metrics？。

Singular 会从 AdWords 提取 创意 吗？

是的，Singular 既提取创意指标，也提取创意本身（图片、文本、视频等）。无论您使用旧版还是新版 AdWords 集成都是如此。不过，只有新版集成会展示 UAC 广告系列的创意。

在 AdWords 语境中， "creative" 指的是什么？ “creative”与“asset”有什么区别？

Singular 的 Creative 对应 Google Ads 的 Ad。

Singular 新增的 Asset 维度对应 Google Ads 的 Asset。之所以增加这一新的粒度层级，是因为在 Google 中某些广告类型（例如 UAC 移动应用广告）包含多个资产。资产层面报告的安装量提取自 "biddable_app_install_conversions" 指标，这与使用以下指标的其他粒度不同："metrics.conversions"

Singular 支持哪些 Google 广告类型？

Singular 支持以下 Google 广告类型：

广告类型 包含的广告资产
文本 图片 视频
Gmail 包含    
Hotel 包含    
Local 包含    
Text 包含    
Expanded Text 包含    
Expanded Dynamic Search 包含    
Shopping Product 包含    
Shopping Smart 包含    
Call Only 包含    
HTML5 Upload 包含    
Dynamic HTML5 包含    
Responsive Search 包含    
Legacy Responsive Search 包含    
Legacy App Install 包含    
Responsive Display   包含  
Video     包含
VIDEO BUMPER     包含
VIDEO NON SKIPPABLE IN STREAM     包含
VIDEO OUTSTREAM     包含
VIDEO TRUEVIEW DISCOVERY     包含
VIDEO TRUEVIEW IN STREAM     包含
VIDEO RESPONSIVE     包含
App (UAC) 包含 包含 包含
App Engagement (UAC - deep linked ads) 包含 包含 包含
APP PRE REGISTRATION 包含 包含 包含

注意： Google 对广告类型的命名（例如“App Engagement”“Responsive Search”） 不会 出现在您的 Singular 报表中。您在报表中看到的 Creative Type 维度与此无关，它表示的是创意为图片、文本还是视频。

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

当 Google 在不同端点为同一广告系列提供的数据之间存在差异时，就可能出现这种情况。

Singular 从 Google Ads API 提取数据时会执行以下步骤：

  1. 从对应的 Google Ads API 端点提取您所选分类维度的数据，本例中即提供国家信息的 location_view 端点。
  2. 从 Google 的 campaign 端点提取同一批广告系列的数据，以获取完整指标。
  3. 比较每个广告系列的指标，并在必要时 添加一行以对齐数据。示例请参见下图。请注意， 广告系列层面的数据被视为可信来源。

Screen_Shot_2019-12-01_at_19.29.13.png

为什么我在创意报表中看不到 视频？

Google 的隐私政策不允许我们下载 YouTube 视频。因此，对于视频创意，我们提供视频缩略图以及指向 YouTube 视频的链接。

video views 和 video views - 25%, 50%, 75%有什么区别？ video views 会高于或低于 video views - completed吗？

video views 指标统计的是已开始播放的视频观看次数。无论视频是被完整观看还是只看了一秒，它都会统计视频的所有展示。

video views - 25%, 50%, and 75% 指标 计算的是 这些展示中分别有多少人将视频观看到 25%、50% 或 75% 的位置。同样地， completed video views 指标只 计算 视频被完整观看的那些展示。计算这些数值时，我们采用 Google 建议的公式： impressions * video_view_rate.

根据您的需求，您可能希望使用百分比指标之一，而不是视频观看次数指标。请参阅 Google 文档中的 "Video played to" 部分。

注意： YouTube 视频的观看次数与 Google Ads 账户中显示的观看次数之间存在固有差异。两者采用不同的指标进行计算。

  • YouTube 将观看计为有人观看视频至少 30 秒，或观看至视频结束（以先到者为准）。
  • Google Ads 将观看计为一次广告展示，即广告在 YouTube 或合作伙伴网站上展示时计入。
  • 因此，YouTube 分析中报告的观看次数与 Google Ads 账户中显示的观看次数之间可能存在差异。
  • 此外，YouTube 分析为实时更新，而 Google Ads 数据最多可能需要 48 小时才会更新。

再者，YouTube 广告及其观看指标的运作方式与传统在线广告不同。投放 YouTube 广告时，只有当有人观看广告达 30 秒，或以某种方式与广告互动（例如点击行动号召浮层或伴随横幅）时才会产生费用。 因此，评估 YouTube 广告效果时，应重点关注互动指标，例如观看率（view-through rate）和获得的互动（earned actions）， 而不仅仅是观看次数。

为什么我在创意报表中看不到 Media Bundles？

Media Bundle 是与 "Image"、"Text" 和 "Video" 并列的另一种创意类型。如果您的广告创意中包含媒体包，您可以查看这些创意的指标，但无法查看创意本身，因为 Google Ads API 不提供该创意。

为什么 Creative Name 维度并非始终可用？

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