版本说明

v0 (2026-11-09)

新细分受众群

我们将添加以下细分受众群：

v0 (2026-08-01)

新字段

我们将向 ad 和 asset 资源添加 synthetic_content_info，以及支持性 SyntheticContentInfo 消息、SyntheticContentAttestationStatus 和 SyntheticContentSource 枚举。

v0 (2026-03-10)

新细分受众群

我们将添加以下细分受众群：

v0 (2025-12-05)

新指标

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

我们将添加以下含购物车数据的转化 (CwCD) 指标：

新细分受众群

现在可以在查询中指定邮政编码细分。如需了解详情，请参阅 segments.geo_target_postal_code。

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-06-12)

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

新字段

我们正在添加

，以帮助您浏览 Search Ads 360 账号层次结构。

v0 (2025-01-21)

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

MCC 扩展

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

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

v0 (2024-11-08)

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

新字段

我们将添加 ad_group_ad.effective_labels 和 ad_group_criterion.effective_labels。

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

新资源

用户地理位置视图

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

查看 user_location_view 资源详情。

与新的 effective_labels 字段相关，有 2 个新资源可保留有效标签与 ad_group_ad (ad_group_ad_effective_label) 或 ad_group_criterion (ad_group_criterion_effective_label) 之间的关联元数据。

v0 (2024-10-07)

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

已添加指标

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 (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

向 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)

此更新包含 AccessibleBiddingStrategy 资源

可用的出价策略

表示客户拥有和共享的出价策略视图。与 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 素材资源集详情。

货币换算

您可以在 PARAMETERS 部分中使用 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_view 资源详情。

产品组

查看 product_group_view 资源详情。

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service 用于在单个查询中检索多个资源。可查询的资源包括：

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

  • 您还可以使用 SearchAds360Service 检索这些资源的指标（例如展示次数和点击次数）：

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

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