v0 (2024-10-07)
此更新包含新的指标、资源、字段和一些新的映射定义。请务必更新客户端库,以便充分利用所有这些更改。
添加了指标
cross_device_conversions_by_conversion_date
:按转化日期划分的跨设备转化次数。cross_device_conversions_value_by_conversion_date
:按转化日期细分的跨设备转化价值总和。general_invalid_click_rate
:从您的总点击次数(过滤后 + 未过滤的点击次数)中滤除的常规无效点击次数所占的百分比。general_invalid_clicks
:常规无效点击次数。
cross_device_conversions_by_conversion_date
和 cross_device_conversions_value_by_conversion_date
与以下资源兼容:ad_group_ad、ad_group_audience_view、ad_group、bidding_strategy、campaign、customer、campaign_audience_view、keyword_view 和 shopping_performance_view。
重新定义了字段映射
某些旧版报告的 dfaActions
、dfaActionsCrossEnv
、dfaRevenue
、dfaRevenueCrossEnv
、dfaTransactions
、dfaTransactionsCrossEnv
字段映射已更改。
字段 | 之前 | 新定义 |
---|---|---|
dfaActions |
metrics.all_conversions - metrics.cross_device_conversions | metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date |
dfaActionsCrossEnv |
metrics.all_conversions | metrics.all_conversions_by_conversion_date |
dfaRevenue |
metric.all_conversions_value - metrics.cross_device_conversions_value | metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date |
dfaRevenueCrossEnv |
metrics.all_conversions_value | metrics.all_conversions_value_by_conversion_date |
dfaTransactions |
metrics.all_conversions - metrics.cross_device_conversions | metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date |
dfaTransactionsCrossEnv |
metrics.all_conversions | metrics.all_conversions_by_conversion_date |
已更改字段映射的旧版报告的列表
新字段
我们将添加 campaign.effective_labels
和 ad_group.effective_labels
。
有效标签是指继承或直接分配的标签。
新资源
与新的 effective_labels 字段相关,新资源会保留有效标签与广告系列 (campaign_effective_label) 或广告组 (ad_group_effective_label) 之间的关联元数据。
v0 (2024-08-23)
在此更新中,自定义列元数据添加了 renderType 字段。
请参阅 CustomColumnRenderType 详情。
campaign_label、ad_group_label、ad_group_ad_label 和 ad_group_criterion_label 资源中新增了 owner_customer_id
字段。
请务必更新客户端库,以便使用这些新字段。
v0 (2024-08-01)
此次更新包括按小时细分和几个新字段
按小时细分
现在,您可以在查询中指定小时级细分。如需了解详情,请参阅 segments.hour。
向 customer_manager_link 资源添加了 start_time
如需了解详情,请参阅 customer_manager_link.start_time
向 ad_group_ad.ad.type 添加了 MULTIMEDIA_AD
现在,您可以使用 MULTIMEDIA_AD 类型选择指标和细分受众群。此版本不支持查询多媒体专用属性。
为 campaign.advertising_channel_type 添加了 SOCIAL 广告系列类型,并为 campaign.advertising_channel_sub_type 添加了 SOCIAL_FACEBOOK_TRACKING_ONLY 子类型。
现在,您可以选择 SOCIAL 广告系列类型和 SOCIAL_FACEBOOK_TRACKING_ONLY 子类型,以便选择指标和细分受众群体。此版本不支持查询 SOCIAL 或 SOCIAL_FACEBOOK_TRACKING_ONLY 特定属性。
添加了对 average_quality_score 的支持
如需了解详情,请参阅指标
v0 (2024-04-18)
本次更新包括“可访问的出价策略”资源
出价策略易于使用
表示由客户拥有并与客户共享的出价策略的视图。与 BiddingStrategy 不同,此资源除了包含客户拥有的策略之外,还包含客户经理拥有并与客户共享的策略。此资源不提供指标,仅公开 BiddingStrategy 属性的有限子集。
请参阅 accessible_bidding_strategy 资源详情。
v0 (2024-02-12)
本次更新包括对自定义列和自定义 Floodlight 变量的访问权限
自定义列
现在,您可以在查询中指定自定义转化列和自定义公式列。如需了解详情,请参阅“自定义列”文档。
自定义 Floodlight 变量
现在,您可以在查询中指定自定义 Floodlight 变量,以获取 2024 年 1 月 30 日之后的数据。如需了解详情,请参阅自定义 Floodlight 变量文档。
v0 (2023-11-09)
此更新包含以下资源。 访问这些链接,即可查看可针对这些资源查询的字段,以及可与这些资源搭配使用的指标和细分。
素材资源组
请参阅 asset_group 资源详细信息。
素材资源组素材资源
请参阅 asset_group_asset 资源详情。
素材资源组产品信息组过滤条件
请参阅 asset_group_listing_group_filter 资源详情。
素材资源组信号
请参阅 asset_group_signal 资源详细信息。
素材资源组效果最佳的组合视图
请参阅 asset_group_top_combination_view 资源详情。
购物车数据销售视图
请参阅 cart_data_sales_view 资源详情。
转化
请参阅转化资源详情。
购物广告效果视图
请参阅 shopping_performance_view 资源详情。
访问
请参阅访问资源详情。
v0 (2023-08-15)
此更新包含以下资源,以及用于为指标配置货币换算的新参数。
访问这些链接,即可查看可针对这些资源查询的字段,以及可与这些资源搭配使用的指标和细分。
广告组素材资源
请参阅 ad_group_asset 资源详细信息。
广告组素材资源组
请参阅 ad_group_asset_set 资源详细信息。
素材资源
请参阅素材资源详情。
素材资源组
请参阅 asset_set 资源详情。
素材资源组素材资源
请参阅 asset_set_asset 资源详细信息。
广告系列素材资源
请参阅 campaign_asset 资源详情。
广告系列素材资源组
请参阅 campaign_asset_set 资源详情。
客户素材资源
请参阅 customer_asset 资源详情。
客户素材资源组
请参阅 customer_asset_set 资源详情。
货币换算
您可以在“参数”部分使用 metrics_currency 指定指标计算所用的币种。
列出可访问的客户
使用 ListAccessibleCustomers 方法列出所有可访问的账号
v0 (2023-05-15)
此更新包含以下资源。 访问相应链接,查看针对该资源可以查询的字段,以及可用于该资源的指标和细分。
广告组广告
请参阅 ad_group_ad 资源详情。
v0 (2023-04-06)
此更新包含以下资源。 访问这些链接可查看可针对每个资源查询的字段,以及可与该资源搭配使用的指标和细分。
广告组受众群体视图
请参阅 ad_group_audience_view 资源详情。
广告组条件标签
请参阅 ad_group_criterion_label 资源详情。
广告组标签
请参阅 ad_group_label 资源详情。
年龄段视图
请参阅 age_range_view 资源详情。
广告系列条件
请参阅 campaign_criterion 资源详细信息。
广告系列标签
查看 campaign_label 资源详情
动态搜索广告搜索字词视图
请参阅 dynamic_search_ads_search_term_view 资源详情。
网页浏览
请参阅 webpage_view 资源详情。
标签
请参阅标签资源详情。
v0 (2022-12-05)
v0 版本包括以下资源和服务。访问这些链接可查看可针对每个资源查询的字段,以及可与该资源搭配使用的指标和细分。
广告组
请参阅 ad_group 资源详情。
出价
请参阅 bidding_strategy 资源详情。
广告系列
请参阅广告系列资源详细信息。
转化操作
请参阅 conversion_action 资源详细信息。
客户
请参阅客户资源详情。
Keyword
请参阅 keyword_view 资源详情。
产品组
请参阅 product_group_view 资源详情。
SearchAds360FieldService
- SearchAds360FieldService 提供包含所有可查询字段的目录。这些字段的元数据包括说明、类型以及与其他字段的兼容性。了解详情。
SearchAds360Service
SearchAds360Service
用于在单个查询中检索多个资源。可查询的资源包括:AdGroup
BiddingStrategy
Campaign
ConversionAction
Customer
Keyword
ProductGroup
您还可以针对以下资源使用
SearchAds360Service
检索展示次数和点击次数等指标:AdGroup
BiddingStrategy
Campaign
ConversionAction
Customer
Keyword
ProductGroup
SearchAds360Service
允许按字段(例如日期字段)进行细分。了解详情。