Ghi chú phát hành

v0 (10/11/2025)

Trường URL mới

Chúng tôi đang thêm

Các chỉ số mới cho UserLocationView

Hiện tại, bạn có thể sử dụng các chỉ số sau khi truy vấn tài nguyên user_location_view:

Chỉnh sửa tên tài nguyên

Mẫu tên tài nguyên cho các tài nguyên nhãn hiệu quả sau đây đã được sửa đổi để sử dụng owner_customer_id nhằm đảm bảo mẫu này chứa mã nhận dạng khách hàng sở hữu nhãn:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (trong AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Ví dụ: Mẫu cho CampaignEffectiveLabel đã thay đổi từ customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} thành customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12/06/2025)

Bản cập nhật này bao gồm các trường mới cho tài nguyên customer. Hãy nhớ cập nhật thư viện ứng dụng để tận dụng tất cả những thay đổi này.

Trường mới

Chúng tôi đang thêm

để giúp bạn di chuyển trong hệ thống phân cấp tài khoản Search Ads 360.

v0 (21/01/2025)

Bản cập nhật này bao gồm một tham số mới để định cấu hình việc mở rộng MCC.

Mở rộng MCC

Khi truy vấn bidding_strategy, giờ đây, bạn có thể đặt một giá trị boolean (enable_mcc_expansion) trong mục THAM SỐ.

Khi tham số này được bật, dữ liệu từ tất cả tài khoản trong hệ thống phân cấp tài khoản bắt nguồn từ customer_id sẽ được trả về trong phản hồi.

v0 (08/11/2024)

Bản cập nhật này bao gồm các trường mới và tài nguyên mới. Hãy nhớ cập nhật thư viện ứng dụng để tận dụng tất cả những thay đổi này.

Trường mới

Chúng tôi đang thêm ad_group_ad.effective_labels và ad_group_criterion.effective_labels.

Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp.

Tài nguyên mới

Chế độ xem vị trí của người dùng

Khi sử dụng chỉ số này với các phân khúc địa lý, bạn có thể nhận được các chỉ số liên quan đến khu vực, khu vực thành thị và thành phố.

Xem thông tin chi tiết về tài nguyên user_location_view.

Liên quan đến các trường effective_labels mới, có 2 tài nguyên mới lưu giữ siêu dữ liệu về mối liên kết giữa các nhãn có hiệu lực và ad_group_ad (ad_group_ad_effective_label) hoặc ad_group_criterion (ad_group_criterion_effective_label).

phiên bản 0 (07/10/2024)

Bản cập nhật này bao gồm các chỉ số, tài nguyên, trường mới và một số định nghĩa ánh xạ mới. Hãy nhớ cập nhật thư viện ứng dụng để tận dụng tất cả những thay đổi này.

Đã thêm chỉ số

cross_device_conversions_by_conversion_date và cross_device_conversions_value_by_conversion_date tương thích với các tài nguyên sau: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view và shopping_performance_view.

Định nghĩa lại mối liên kết đến trường

Ánh xạ trường cho dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv đã thay đổi đối với một số báo cáo cũ.

Trường Trước đây Định nghĩa mới
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

Danh sách các báo cáo cũ đã thay đổi mối liên kết đến trường

Trường mới

Chúng tôi đang thêm campaign.effective_labels và ad_group.effective_labels.

Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp.

Tài nguyên mới

Liên quan đến các trường effective_labels mới, các tài nguyên mới sẽ giữ siêu dữ liệu về mối liên kết giữa các nhãn có hiệu lực và chiến dịch (campaign_effective_label) hoặc nhóm quảng cáo (ad_group_effective_label).

v0 (23/8/2024)

Trong bản cập nhật này, siêu dữ liệu Cột tuỳ chỉnh sẽ thêm trường renderType.

Xem thông tin chi tiết về CustomColumnRenderType.

Một trường owner_customer_id mới đã được thêm vào các tài nguyên campaign_label, ad_group_label, ad_group_ad_label và ad_group_criterion_label.

Hãy nhớ cập nhật thư viện ứng dụng để tận dụng các trường mới này.

phiên bản 0 (01/08/2024)

Bản cập nhật này bao gồm tính năng phân đoạn theo giờ và một số trường mới

Phân đoạn theo giờ

Giờ đây, bạn có thể chỉ định phân đoạn theo giờ trong một truy vấn. Xem thêm thông tin chi tiết trong segments.hour.

Xem thêm thông tin chi tiết trong customer_manager_link.start_time

Đã thêm MULTIMEDIA_AD vào ad_group_ad.ad.type

Giờ đây, bạn có thể chọn Chỉ số và phân đoạn bằng loại MULTIMEDIA_AD. Phiên bản này không hỗ trợ việc truy vấn các thuộc tính dành riêng cho nội dung đa phương tiện.

Đã thêm loại chiến dịch MẠNG XÃ HỘI vào campaign.advertising_channel_type và loại chiến dịch phụ SOCIAL_FACEBOOK_TRACKING_ONLY vào campaign.advertising_channel_sub_type

Giờ đây, bạn có thể chọn chỉ số và phân khúc bằng loại chiến dịch XÃ HỘI và loại chiến dịch phụ SOCIAL_FACEBOOK_TRACKING_ONLY. Phiên bản này không hỗ trợ việc truy vấn các thuộc tính cụ thể SOCIAL hoặc SOCIAL_FACEBOOK_TRACKING_ONLY.

Thêm tính năng hỗ trợ cho average_quality_score

Xem thêm thông tin chi tiết trong các chỉ số

v0 (18/4/2024)

Bản cập nhật này bao gồm tài nguyên Chiến lược đặt giá thầu có thể truy cập

Chiến lược đặt giá thầu có thể sử dụng

Biểu thị chế độ xem BiddingStrategies do khách hàng sở hữu và chia sẻ. Không giống như BiddingStrategy, tài nguyên này bao gồm các chiến lược do người quản lý của khách hàng sở hữu và được chia sẻ với khách hàng này – ngoài các chiến lược do khách hàng này sở hữu. Tài nguyên này không cung cấp các chỉ số và chỉ hiển thị một tập hợp con hạn chế của các thuộc tính BiddingStrategy.

Xem thông tin chi tiết về tài nguyên accessible_bidding_strategy.

v0 (12/02/2024)

Bản cập nhật này bao gồm quyền truy cập vào Cột tuỳ chỉnh và Biến Floodlight tuỳ chỉnh

Cột tùy chỉnh

Giờ đây, bạn có thể chỉ định Cột lượt chuyển đổi tuỳ chỉnh và Cột công thức tuỳ chỉnh trong một truy vấn. Xem thêm thông tin chi tiết trong tài liệu về Cột tuỳ chỉnh.

Biến Floodlight tùy chỉnh

Giờ đây, bạn có thể chỉ định Biến Floodlight tuỳ chỉnh trong một truy vấn để xem số liệu thống kê sau ngày 30/1/2024. Xem thêm thông tin chi tiết trong tài liệu về biến Floodlight tuỳ chỉnh.

v0 (09/11/2023)

Bản cập nhật này bao gồm các tài nguyên sau. Hãy truy cập vào các đường liên kết để xem những trường có thể được truy vấn cho các tài nguyên này, cũng như những chỉ số và tiêu chí phân đoạn có thể được dùng với các tài nguyên đó.

Nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_group.

Thành phần trong nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_group_asset.

Bộ lọc nhóm trang thông tin của nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_group_listing_group_filter.

Tín hiệu nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_group_signal.

Chế độ xem tổ hợp hàng đầu của nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_group_top_combination_view.

Chế độ xem doanh số bán hàng theo dữ liệu giỏ hàng

Xem thông tin chi tiết về tài nguyên cart_data_sales_view.

Chuyển đổi

Xem thông tin chi tiết về tài nguyên lượt chuyển đổi.

Chế độ xem hiệu suất mua sắm

Xem thông tin chi tiết về tài nguyên shopping_performance_view.

Truy cập

Xem thông tin chi tiết về tài nguyên lượt truy cập.

v0 (15/08/2023)

Bản cập nhật này bao gồm các tài nguyên sau và một tham số mới để định cấu hình tính năng chuyển đổi đơn vị tiền tệ cho các chỉ số.

Hãy truy cập vào các đường liên kết để xem những trường có thể được truy vấn cho các tài nguyên này, cũng như những chỉ số và tiêu chí phân đoạn có thể được dùng với các tài nguyên đó.

Thành phần nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_asset.

Nhóm thành phần của nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_asset_set.

Thành phần

Xem thông tin chi tiết về tài nguyên tài sản.

Nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_set.

Thành phần trong nhóm thành phần

Xem thông tin chi tiết về tài nguyên asset_set_asset.

Thành phần của chiến dịch

Xem thông tin chi tiết về tài nguyên campaign_asset.

Nhóm thành phần của chiến dịch

Xem thông tin chi tiết về tài nguyên campaign_asset_set.

Thành phần của khách hàng

Xem thông tin chi tiết về tài nguyên customer_asset.

Nhóm thành phần của khách hàng

Xem thông tin chi tiết về tài nguyên customer_asset_set.

Quy đổi tiền tệ

Bạn có thể chỉ định đơn vị tiền tệ để tính toán chỉ số bằng cách sử dụng metrics_currency trong phần THÔNG SỐ.

Liệt kê khách hàng có thể truy cập

Liệt kê tất cả các tài khoản có thể truy cập bằng cách sử dụng phương thức ListAccessibleCustomers

v0 (15/05/2023)

Bản cập nhật này bao gồm tài nguyên sau. Hãy truy cập vào các đường liên kết để xem những trường có thể được truy vấn cho tài nguyên này, cũng như các chỉ số và tiêu chí phân đoạn có thể dùng với tài nguyên này.

Quảng cáo của nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_ad.

v0 (06/04/2023)

Bản cập nhật này bao gồm các tài nguyên sau. Hãy truy cập vào các đường liên kết để xem những trường có thể được truy vấn cho từng tài nguyên, cũng như các chỉ số và tiêu chí phân đoạn có thể được dùng với tài nguyên đó.

Chế độ xem đối tượng của nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_audience_view.

Nhãn tiêu chí nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_criterion_label.

Nhãn nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group_label.

Chế độ xem độ tuổi

Xem thông tin chi tiết về tài nguyên age_range_view.

Tiêu chí chiến dịch

Xem thông tin chi tiết về tài nguyên campaign_criterion.

Nhãn chiến dịch

Xem thông tin chi tiết về tài nguyên campaign_label

Chế độ xem cụm từ tìm kiếm của Quảng cáo tìm kiếm động

Hãy xem thông tin chi tiết về tài nguyên dynamic_search_ads_search_term_view.

Số lượt xem trang web

Xem thông tin chi tiết về tài nguyên webpage_view.

Hãng nhạc

Xem thông tin chi tiết về tài nguyên nhãn.

v0 (05/12/2022)

Phiên bản v0 bao gồm các tài nguyên và dịch vụ sau. Hãy truy cập vào các đường liên kết để xem những trường có thể được truy vấn cho từng tài nguyên, cũng như các chỉ số và tiêu chí phân đoạn có thể được dùng với tài nguyên đó.

Nhóm quảng cáo

Xem thông tin chi tiết về tài nguyên ad_group.

Đặt giá thầu

Xem thông tin chi tiết về tài nguyên bidding_strategy.

Chiến dịch

Xem thông tin chi tiết về tài nguyên chiến dịch.

Hành động chuyển đổi

Xem thông tin chi tiết về tài nguyên conversion_action.

Khách hàng

Xem thông tin chi tiết về tài nguyên customer.

Từ khóa

Xem thông tin chi tiết về tài nguyên keyword_view.

Nhóm sản phẩm

Xem thông tin chi tiết về tài nguyên product_group_view.

SearchAds360FieldService

  • SearchAds360FieldService cung cấp danh mục gồm tất cả các trường có thể truy vấn. Siêu dữ liệu trên các trường này bao gồm nội dung mô tả, loại và khả năng tương thích với các trường khác. Tìm hiểu thêm.

SearchAds360Service

  • SearchAds360Service dùng để truy xuất nhiều tài nguyên trong một truy vấn. Tài nguyên có thể truy vấn bao gồm:

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

  • Bạn cũng có thể truy xuất các chỉ số như số lượt hiển thị và số lượt nhấp bằng cách sử dụng SearchAds360Service cho các tài nguyên sau:

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

  • SearchAds360Service cho phép phân đoạn theo các trường, chẳng hạn như trường ngày. Tìm hiểu thêm.