版本说明

v0（2025 年 11 月 10 日）

新的网址字段

我们正在添加

UserLocationView 的新指标

查询 user_location_view 资源时，现在可以使用以下指标：

资源名称更正

以下有效标签资源的资源名称模式已更正为使用 owner_customer_id，以确保其中包含拥有相应标签的客户 ID：

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel（位于 AdGroupCriterionEffectiveLabel）
  • AdGroupAdEffectiveLabel

示例：CampaignEffectiveLabel 的模式从 customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} 更改为 customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}。

v0（2025 年 6 月 12 日）

此更新包含 customer 资源的新字段。 请务必更新客户端库，以便充分利用所有这些更改。

新字段

我们正在添加

帮助您遍历 Search Ads 360 账号层次结构。

v0（2025 年 1 月 21 日）

此更新包含一个用于配置 MCC 扩展的新参数。

MCC 扩展

查询 bidding_strategy 时，您现在可以在 PARAMETERS 部分中设置布尔值 (enable_mcc_expansion)。

启用此参数后，系统会在响应中返回以 customer_id 为根的账号层次结构中所有账号的数据。

v0（2024 年 11 月 8 日）

此更新包含新字段和新资源。请务必更新客户端库，以便利用所有这些更改。

新字段

我们正在添加 ad_group_ad.effective_labels 和 ad_group_criterion.effective_labels。

有效标签是指继承或直接分配的标签。

新资源

用户位置视图

将其与地理位置细分一起使用可获取与地区、都市圈和城市相关的指标。

请参阅 user_location_view 资源详情。

与新的 effective_labels 字段相关的是，有两个新资源用于保存有效标签与 ad_group_ad (ad_group_ad_effective_label) 或 ad_group_criterion (ad_group_criterion_effective_label 之间的关联元数据。

v0（2024 年 10 月 7 日）

此更新包含新指标、资源、字段和一些新的映射定义。请务必更新客户端库，以便利用所有这些更改。

已添加指标

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 metrics.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 年 8 月 23 日）

在此更新中，自定义列元数据添加了 renderType 字段。

请参阅 CustomColumnRenderType 详情。

已向 campaign_label、ad_group_label、ad_group_ad_label 和 ad_group_criterion_label 资源添加新的 owner_customer_id 字段。

请务必更新客户端库，以便利用这些新字段。

v0（2024 年 8 月 1 日）

此更新包括按小时细分和多个新字段

按小时细分

现在可以在查询中指定每小时细分。如需了解详情，请参阅segments.hour。

如需了解详情，请参阅 customer_manager_link.start_time

已将 MULTIMEDIA_AD 添加到 ad_group_ad.ad.type

现在可以选择具有 MULTIMEDIA_AD 类型的指标和细分。此版本不支持查询特定于多媒体的属性。

向 campaign.advertising_channel_type 添加了 SOCIAL 广告系列类型，并向 campaign.advertising_channel_sub_type 添加了 SOCIAL_FACEBOOK_TRACKING_ONLY 子类型

现在，您可以为社交广告系列类型和 SOCIAL_FACEBOOK_TRACKING_ONLY 子类型选择指标和细分。此版本不支持查询 SOCIAL 或 SOCIAL_FACEBOOK_TRACKING_ONLY 特定属性。

添加了对 average_quality_score 的支持

如需了解更多详情，请参阅指标

v0（2024 年 4 月 18 日）

此更新包括 Accessible Bidding Strategy 资源

可用的出价策略

表示客户拥有和共享的 BiddingStrategies 的视图。与 BiddingStrategy 不同，此资源不仅包含相应客户拥有的出价策略，还包含相应客户的经理拥有的并与相应客户共享的出价策略。此资源不提供指标，仅公开 BiddingStrategy 属性的有限子集。

请参阅 accessible_bidding_strategy 资源详情。

v0（2024 年 2 月 12 日）

此更新包括对自定义列和自定义 Floodlight 变量的访问权限

自定义列

现在可以在查询中指定自定义转化列和自定义公式列。如需了解详情，请参阅“自定义列”文档。

自定义 Floodlight 变量

现在，您可以在查询中指定自定义 Floodlight 变量，以获取 2024 年 1 月 30 日之后的统计信息。如需了解详情，请参阅自定义 Floodlight 变量文档。

v0（2023 年 11 月 9 日）

此更新包含以下资源。 点击链接可查看可针对这些资源查询的字段，以及可与这些字段搭配使用的指标和细分。

素材资源组

请参阅 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 年 8 月 15 日）

此更新包含以下资源和一个用于配置指标币种换算的新参数。

点击链接可查看可针对这些资源查询的字段，以及可与这些字段搭配使用的指标和细分。

广告组素材资源

请参阅 ad_group_asset 资源详情。

广告组素材资源集

请参阅 ad_group_asset_set 资源详细信息。

素材资源

查看资产资源详情。

素材资源组

请参阅 asset_set 资源详情。

素材资源组的素材资源

请参阅 asset_set_asset 资源详情。

广告系列素材资源

请参阅 campaign_asset 资源详情。

广告系列素材资源组

请参阅 campaign_asset_set 资源详情。

客户素材资源

请参阅 customer_asset 资源详情。

客户素材资源组

请参阅 customer_asset_set 资源详情。

货币换算

您可以在 PARAMETERS 部分使用 metrics_currency 指定用于计算指标的币种。

列出可访问的客户

使用 ListAccessibleCustomers 方法列出所有可访问的账号

v0（2023 年 5 月 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 资源详情。

标签

请参阅 label 资源详情。

v0（2022 年 12 月 5 日）

v0 版本包含以下资源和服务。 点击链接可查看每个资源可查询的字段，以及可与该资源搭配使用的指标和细分。

广告组

请参阅 ad_group 资源详细信息。

出价

请参阅 bidding_strategy 资源详情。

广告系列

查看广告系列资源详细信息。

转化操作

请参阅 conversion_action 资源详情。

客户

请参阅客户资源详情。

关键字

请参阅 keyword_view 资源详情。

产品组

请参阅 product_group_view 资源详情。

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service 旨在通过单个查询检索多个资源。可查询的资源包括：

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • 您还可以使用 SearchAds360Service 为以下资源检索展示次数和点击次数等指标：

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service 可按字段（例如日期字段）进行细分。了解详情。