快速详细信息
数据连接器技术 | API (Google AdsAPI v10) |
数据分类(细分) |
在默认配置中,您的数据将按以下方式细分:
要选择不同的配置,请参阅下面的数据映射。 |
我们从多长时间前提取数据 | 每天,Singular 都会提取 7 天前的数据。每周一,Singular 会提取 30 天前的数据。 |
时区 | 由客户在谷歌设置中按账户定义 |
创意(广告)层面的数据可用吗? | 有 |
Singular 是否显示您的创意资产? | 是(YouTube 视频除外,Singular 仅显示其缩略图) |
已知限制 |
|
数据映射
您可以通过几种细分配置之一获取数据,每种配置提供一组不同的维度,各有其优势和局限性。
- 默认配置为国家。要选择其他配置,请联系 Singular 支持。
- 都会区(DMA)配置只适用于美国的广告(DMA 信息只适用于美国)。如果您的部分或全部广告活动在美国以外地区开展,请使用城市配置。
- 由于 Google Ads API 的限制,关键字 和 发布者 配置不包括 UAC广告系列的数据。
- 虽然关键字和发布者配置不包括国家或其他位置维度,但 Singular 可能会根据目标国家设置提供国家。
- 年龄或性别 细分可作为单独的人口统计细分(如女性/男性、20-29 岁等。)
术语提示:
- Singular的 "创意"与谷歌广告的 "广告"相对应。
- Singular的新资产维度与谷歌广告的资产相对应。我们之所以添加这一新的粒度,是因为在谷歌中,某些类型的广告(如 UAC(移动应用程序)广告)包含多个资产。
- 有关 Singular 报告中所有字段的说明,请参阅Singular Metrics and Dimensions Glossary。
- 有关如何在 Google 中运行创意报告的更多提示,请参阅如何在 Meta 和 Google Ads 中运行创意报告?
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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
Singular UI 中的字段 | Singular API 中的字段 | Google Metro 细分中的字段 |
维度 | ||
账户 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 |
DMA 名称 |
字段 |
geo_target_metro |
最终 URL | 最终 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(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
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 |
活动 URL | adn_campaign_url | ad.finalUrl 如果不可用,则使用 ad.trackingUrlTemplate |
城市 |
city_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 |
区域 |
区域字段 |
geo_target_region |
重定向 | 保留 | campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_' 子广告网络 |
子广告网络 | adn_subadnetwork | segments.adNetworkType |
目标国家 | target_countries_str | 查看国家 |
文本 | 创意文本 | 要创建此字段,我们需要使用广告中任何可用的文本字段,这些字段可能因广告类型而异。例如,对于 UAC,Google Ads 中的字段是 asset.textAsset.text。如果有多个文本(如标题+描述),我们会将它们连接成一个字符串。 |
时区 | adn_timezone | customer.timeZone(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
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 |
创意格式 | 创意格式 | 广告类型 |
创意 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 |
关键字 | 关键字 | ad_group_criterion.keyword.text |
关键词 ID | keyword_id | ad_group_criterion.criterion_id |
关键字匹配类型 | 关键字匹配类型 | ad_group_criterion.keyword.match_type |
网络广告系列 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(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
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 |
创意格式 | 创意格式 | 广告类型 |
创意 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 |
关键字 | 关键字 | ad_group_criterion.keyword.text |
关键词 ID | keyword_id | ad_group_criterion.criterion_id |
关键字匹配类型 | 关键字匹配类型 | ad_group_criterion.keyword.match_type |
网络广告系列 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(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
搜索印象份额(谷歌) | search_impression_share | 搜索印象份额 |
搜索最高印象份额(谷歌) | search_top_impression_share | 搜索最高印象份额 |
搜索绝对最高印象份额(谷歌) | 搜索绝对最高印象份额 | 搜索绝对最高印象份额 |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
Singular UI 中的字段 | Singular API 中的字段 | Google Publisher Breakdown 中的字段 |
尺寸 | ||
账户 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 |
创意格式 | 创意格式 | 广告类型 |
创意 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 |
发布者网站名称 | 发布者网站名称 | adGroupCriterion.placement.url |
重定向 | 保留 | campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_' 子广告网络 |
子广告网络 | adn_subadnetwork | segments.adNetworkType |
目标国家 | target_countries_str | 查看国家 |
文本 | 创意文本 | 要创建此字段,我们需要使用广告中任何可用的文本字段,这些字段可能因广告类型而异。例如,对于 UAC,Google Ads 中的字段是 asset.textAsset.text。如果有多个文本(如标题+描述),我们会将它们连接成一个字符串。 |
时区 | adn_timezone | customer.timeZone(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
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 |
城市 |
city_field |
地理目标城市 |
国家 | 字段 | geographicView.countryCriterionId |
创意格式 | 创意格式 | 广告类型 |
创意 ID | creative_id | adGroupAd.ad.id |
创意名称 | 创意名称 | adGroupAd.ad.name |
创意报告 URL | creative_reported_url | adGroupAd.ad.finalUrls.0 |
日期 | 日期字段 | segments.date |
DMA 名称 |
字段 |
geo_target_metro |
最终 URL | 最终 URL | campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls |
关键字 | 关键字 | ad_group_criterion.keyword.text |
商家 ID | merchant_id | merchant_id |
网络广告系列 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 | 产品项目 ID | 产品项目 ID |
公共 ID | site_public_id | campaign.appCampaignSetting.appId |
发布者网站名称 | 发布者网站名称 | adGroupCriterion.placement.url |
重定向 | 保留 | campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_' 子广告网络 |
子广告网络 | adn_subadnetwork | segments.adNetworkType |
目标国家 | target_countries_str | 查看国家 |
文本 | 创意文本 | 要创建此字段,我们需要使用广告中任何可用的文本字段,这些字段可能因广告类型而异。例如,对于 UAC,Google Ads 中的字段是 asset.textAsset.text。如果有多个文本(如标题+描述),我们会将它们连接成一个字符串。 |
时区 | adn_timezone | customer.timeZone(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
指标 | ||
成本 | adn_cost | 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 还支持为该合作伙伴提取营销活动属性,详情请点击此处。
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 |
城市 |
city_field |
地理目标城市 |
国家 | 字段 | geographicView.countryCriterionId |
创意格式 | 创意格式 | 广告类型 |
创意 ID | creative_id | adGroupAd.ad.id |
创意名称 | 创意名称 | adGroupAd.ad.name |
创意报告 URL | creative_reported_url | adGroupAd.ad.finalUrls.0 |
日期 | 日期字段 | segments.date |
DMA 名称 |
字段 |
geo_target_metro |
最终 URL | 最终 URL | campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls |
关键字 | 关键字 | ad_group_criterion.keyword.text |
网络广告系列 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 |
发布者网站名称 | 发布者网站名称 | adGroupCriterion.placement.url |
重定向 | 保留 | campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_' 子广告网络 |
子广告网络 | adn_subadnetwork | segments.adNetworkType |
目标国家 | target_countries_str | 查看国家 |
文本 | 创意文本 | 要创建此字段,我们需要使用广告中任何可用的文本字段,这些字段可能因广告类型而异。例如,对于 UAC,Google Ads 中的字段是 asset.textAsset.text。如果有多个文本(如标题+描述),我们会将它们连接成一个字符串。 |
时区 | adn_timezone | customer.timeZone(带有一些额外逻辑) |
跟踪 URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
视频 ID | videoo_id | 视频 |
视频频道 ID | 视频频道 ID | 视频频道 ID |
视频持续时间毫秒数 | videoo_duration_millis | 视频持续时间 |
视频标题 | 视频标题 | 视频标题 |
指标 | ||
成本 | adn_cost | 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(经理账户和个人账户):
- 登录Google Ads 帐户。
- 单击右上角的帮助图标。
- 在菜单底部找到客户 ID。
转换事件
除了上表中的默认指标外,Singular 还可以从 Google Ads 中提取您需要的任何指标,并在您的 Singular 报告中显示其统计数据。
如果您想了解资产层面更详细的信息,可以考虑添加 "biddable-app-post-install-conversion "作为事件。这些数据来自 Google Ad 的 API。通过该功能,您可以将 "应用内操作 "事件的其他数据添加到各自的广告系列中。值得注意的是,转换事件缺少队列数据,只与'实际'队列期相关联。"
要在 Singular 中设置转换事件,请采取以下步骤:
- 在 Singular 中,进入 "设置">"事件"。如果有 "自定义事件"和"转换事件"选项卡,请选择 "转换事件"。
- 单击 "新建事件"。
-
在AdWords下拉菜单中,您将看到 AdWords 提供的指标列表。您可以将每个活动映射到一个单独的 Singular 事件中,也可以将多个指标合并到一个事件中。
第二天,当 Singular 提取账户的每日数据时,也会提取这些活动的统计数据。
- 当 Singular 为新的转换事件填充了一些数据后,您在 "报告"页面运行报告时,就可以从 "事件"下拉菜单中选择转换事件。
常见问题和故障排除
要查找您的客户 ID(经理账户和个人账户均适用),请执行以下操作
- 登录Google Ads 帐户。
- 单击右上角的帮助图标。
- 在菜单底部查找客户 ID。
当您使用的分类不提供国家信息时,Singular会通过查看Google中的营销活动 目标设置 和/或跟踪器数据(如果我们有的话)来提供国家粒度:
- 如果营销活动只针对一个国家,我们就会在报告中显示这个国家。
- 如果有多个目标国家/地区,并且我们也有同一营销活动的跟踪器数据,我们将根据跟踪器数据中每个国家/地区的安装比例来估算每个国家/地区的成本。请参阅如何计算每个国家的成本指标?
Google Ads 会跟踪不同类型的所谓 "转换行为",包括应用程序下载、用户注册、购买等。默认情况下,由于我们的大多数客户都对应用程序的安装感兴趣,因此我们会提取下载类型的转换,并在报告的Network Installs字段中显示其指标。
注:NetworkInstalls 是 Singular 中的一个指标,反映的是广告网络报告的安装次数,不要与Installs 混淆,后者通常基于来自归因跟踪器的数据。对于 Adwords 而言,网络安装次数是 Adwords 报告的 "first_open "转化次数。
建立报告查询时,可以在 "来源指标 "部分选择 "网络安装量"。更多信息,请参阅什么是 "源指标"?
是的,Singular会提取创意指标以及创意本身(图片、文本、视频等)。无论是使用旧版 AdWords 集成还是新版 AdWords 集成,情况都是如此。但是,只有新版集成才会显示UAC 营销活动的创意。
Singular的 "创意"与谷歌广告的 "广告"相对应。
Singular的新 "资产"维度与谷歌广告的 "资产"相对应。我们之所以添加这一新的粒度,是因为在谷歌中,某些类型的广告(如 UAC(移动应用程序)广告)包含多个资产。资产的安装报告来自指标 "biddable_app_install_conversions";这与使用"metrics.conversions "的其他粒度不同。
Singular 支持以下谷歌广告类型:
广告类型 | 包含的广告资产 | ||
文本 | 图片 | 视频 | |
电子邮件 | |||
酒店 | |||
本地 | |||
文本 | |||
扩展文本 | |||
扩展动态搜索 | |||
购物产品 | |||
智能购物 | |||
仅呼叫 | |||
HTML5 上传 | |||
动态 HTML5 | |||
响应式搜索 | |||
传统响应式搜索 | |||
传统应用程序安装 | |||
响应式显示 | |||
视频 | |||
视频压盖 | |||
视频流中不可跳过的视频 | |||
视频外流 | |||
视频 trueview 发现 | |||
视频流中的 trueview | |||
视频响应 | |||
应用程序(UAC) | |||
应用程序参与(UAC - 深度链接广告) | |||
应用程序预注册 |
注意:Google 的广告类型名称("应用程序参与"、"响应式搜索 "等)不会出现在您的 Singular 报告中。您在报告中看到的 "创意类型"维度与此无关,它显示的是创意是图片、文本还是视频。
当谷歌在不同端点为同一营销活动提供的数据存在差异时,就会出现这种情况。
当Singular从谷歌广告API提取数据时,会执行以下步骤:
- 从相应的 Google Ads API 端点(本例中为location_view端点,提供国家信息)提取所选细分数据。
- 从 Google广告系列端点提取相同广告系列的数据,以获得完整指标。
- 比较每个广告系列的指标,如有必要,添加一行以调整数据。请参阅下面的示例。请注意,广告系列级数据被视为真实数据源。
Google 的隐私政策不允许我们下载 YouTube 视频。因此,对于视频创意,我们包括视频缩略图和 YouTube 上的视频链接。
视频浏览量指标是对视频浏览量的统计。它统计了视频的所有观看次数,无论视频是否被完整观看,还是只被观看了一秒钟。
视频浏览量 - 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。