版本说明

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 metric.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 metric.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

向 ad_group_ad.ad.type 添加了 MULTIMEDIA_AD

现在，您可以使用 MULTIMEDIA_AD 类型选择指标和细分受众群。此版本不支持查询多媒体专用属性。

向 campaign.advertising_channel_type 添加了社交媒体广告系列类型，并向 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)

本次更新包含“无障碍出价策略”资源

可访问的出价策略

表示客户拥有并与其共享的 BiddingStrategies 视图。与 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 资源详情。

标签

请参阅 label 资源详细信息。

v0 (2022-12-05)

v0 版本包括以下资源和服务。访问这些链接可查看可针对每个资源查询的字段，以及可与该资源搭配使用的指标和细分。

广告组

请参阅 ad_group 资源详情。

出价

请参阅 bidding_strategy 资源详细信息。

广告系列

查看广告系列资源详情。

转化操作

请参阅 conversion_action 资源详细信息。

客户

请参阅客户资源详情。

Keyword

请参阅 keyword_view 资源详细信息。

产品组

请参阅 product_group_view 资源详情。

SearchAds360FieldService

SearchAds360Service

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

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

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

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

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