Điểm chuẩn trên YouTube

Quan trọng: Tính năng này chỉ dành cho những tài khoản có trong danh sách cho phép. Hãy liên hệ với người đại diện của Google nếu bạn cần được cấp quyền sử dụng tính năng này.

BenchmarksService giúp nhà quảng cáo và công ty quảng cáo so sánh hiệu suất quảng cáo trên YouTube với điểm chuẩn của ngành. Khi sử dụng dịch vụ này, bạn có thể đánh giá hiệu suất của chiến dịch so với các ngành dọc hoặc so với tất cả nhà quảng cáo trong các danh mục sản phẩm và dịch vụ cụ thể.

Các chức năng chính

Với BenchmarksService, bạn có thể:

• So sánh hiệu suất: Đánh giá các chỉ số về tỷ lệ trung bình của khách hàng (chẳng hạn như CPM, CPV, CTR và khả năng xem) so với mức trung bình tổng hợp của ngành.
• Phân tích thị phần: Tìm hiểu mức độ hiện diện tương đối của khách hàng trên thị trường thông qua thị phần khoảng không quảng cáo (số lượt hiển thị tương đối) và mức chi tiêu.
• Đánh giá vị thế cạnh tranh: Đo lường vị thế cạnh tranh của khách hàng bằng cách sử dụng các chỉ số phân vị để phân loại hiệu suất theo các phương diện chính thành các cấp độ cạnh tranh (chẳng hạn như Dẫn đầu thị trường hoặc Đối thủ cạnh tranh).
• Phân đoạn theo thời gian: Nhóm các chỉ số điểm chuẩn theo độ chi tiết của thời gian là hằng tuần, hằng tháng hoặc hằng quý.
• Khám phá các phương diện điểm chuẩn được hỗ trợ: Truy vấn phạm vi ngày, vị trí địa lý, sản phẩm quảng cáo và nguồn điểm chuẩn (ngành dọc hoặc danh mục sản phẩm và dịch vụ) có sẵn.

Lưu ý: Bạn phải cung cấp mã khách hàng của khách hàng trong yêu cầu của mình. Mã khách hàng của tài khoản người quản lý sẽ không trả về các chỉ số khách hàng vì tài khoản người quản lý không trực tiếp chạy chiến dịch quảng cáo.

Phương thức khám phá

Trước khi tạo chỉ số điểm chuẩn, hãy sử dụng các phương thức khám phá để truy xuất các tham số hợp lệ và tiêu chí xác định phạm vi cho yêu cầu của bạn.

Liệt kê các ngày có hàng

Phương thức ListBenchmarksAvailableDates trả về các phạm vi ngày trước đây hỗ trợ dữ liệu điểm chuẩn trong ListBenchmarksAvailableDatesResponse.

Phản hồi cung cấp hai phạm vi ngày riêng biệt:

• supported_dates: Phạm vi ngày tổng thể mà các chỉ số điểm chuẩn được hỗ trợ (bao gồm cả ngày bắt đầu và ngày kết thúc). Yêu cầu về điểm chuẩn có thể truy vấn ngày trong phạm vi này.
• supported_dates_for_all_metrics (trong phiên bản 25 trở lên): Một nhóm nhỏ của supported_dates hỗ trợ toàn bộ các chỉ số điểm chuẩn. Một số chỉ số nhất định (cụ thể là các chỉ số về tỷ lệ khách hàng (share_of_voice và share_of_spend) và các chỉ số về tỷ lệ trung bình của nguồn điểm chuẩn) chỉ có trong phạm vi ngày này do dữ liệu có giới hạn. Các chỉ số này sẽ bị bỏ qua trong phản hồi nếu date_range được yêu cầu không hoàn toàn nằm trong supported_dates_for_all_metrics.

Liệt kê vị trí

Phương thức ListBenchmarksLocations trả về danh sách các vị trí địa lý (chẳng hạn như quốc gia) hỗ trợ dữ liệu điểm chuẩn.

Mỗi BenchmarksLocation trong phản hồi bao gồm:

• location_name: Tên địa điểm duy nhất bằng tiếng Anh (ví dụ: "United States").
• location_type: Loại vị trí tương ứng với target_type trong Google Ads API (ví dụ: "Country").
• location_info: Đối tượng LocationInfo chứa hằng số mục tiêu vị trí địa lý (chẳng hạn như geo_target_constant: "geoTargetConstants/2840").

Liệt kê sản phẩm

Phương thức ListBenchmarksProducts trả về danh sách sản phẩm và mục tiêu tiếp thị có sẵn để đo điểm chuẩn.

Mỗi mục BenchmarksProductMetadata bao gồm:

• product_name: Tên sản phẩm thân thiện với người dùng.
• product_code: Chuỗi giá trị nhận dạng riêng biệt cho sản phẩm, được dùng khi tạo ProductFilter.
• marketing_objective: Mục tiêu tiếp thị liên quan (BenchmarksMarketingObjective):
  • AWARENESS: Các chiến dịch được thiết kế để tăng mức độ nhận biết về thương hiệu hoặc sản phẩm.
  • CONSIDERATION: Chiến dịch được thiết kế để khuyến khích khách hàng tiềm năng cân nhắc thương hiệu hoặc sản phẩm.
  • ACTION: Chiến dịch được thiết kế để thúc đẩy một hành động chuyển đổi cụ thể.

Liệt kê các nguồn điểm chuẩn

Phương thức ListBenchmarksSources truy xuất các nguồn điểm chuẩn có sẵn. Chỉ định các loại nguồn cần truy xuất bằng cách sử dụng BenchmarksSourceType:

• INDUSTRY_VERTICAL: Phân loại các phân khúc ngành (ví dụ: "Technology" hoặc "Finance").
• CATEGORY (trong phiên bản 25 trở lên): Danh mục sản phẩm và dịch vụ (ví dụ: "/Apparel/Clothing"). Bạn có thể dùng danh mục làm bộ lọc để xác định phạm vi đo điểm chuẩn khi so sánh với tất cả nhà quảng cáo.

Phản hồi trả về danh sách các đối tượng BenchmarksSourceMetadata chứa:

• IndustryVerticalInfo: Chứa industry_vertical_name, industry_vertical_id và parent_industry_vertical_id (nếu có).
• CategoryInfo (trong phiên bản 25 trở lên): Chứa category_name, category_id và category_path (toàn bộ hệ phân cấp danh mục).

Tạo chỉ số điểm chuẩn

Gọi GenerateBenchmarksMetrics để so sánh các chỉ số quảng cáo trên YouTube của khách hàng với đo điểm chuẩn ngành.

Tham số yêu cầu

GenerateBenchmarksMetricsRequest xác định phạm vi phân tích. Tối thiểu, bạn phải chỉ định một customer_id ứng dụng, location địa lý (LocationInfo), benchmarks_source (industry_vertical_id hoặc trong phiên bản 25 trở lên, all_advertisers trong phạm vi category_filter) và product_filter. Bạn có thể tuỳ ý:

• Cung cấp date_range (nếu bỏ qua, dữ liệu sẽ được trả về cho quý gần đây nhất có dữ liệu).
• Nhóm các chỉ số bằng breakdown_definition.
• Chỉ định mã ISO 4217 gồm 3 ký tự currency_code (nếu bỏ qua, các chỉ số tiền tệ như CPM và chi phí sẽ mặc định là USD).
• Chỉ định tên customer_benchmarks_group do người dùng xác định cho khách hàng đang được lập kế hoạch.
• Yêu cầu các tính năng bổ sung như PERCENTILE_DATA thông qua supplemental_data (trong phiên bản 25 trở lên).

Để biết đầy đủ định nghĩa và yêu cầu về tham số, hãy tham khảo tài liệu tham khảo GenerateBenchmarksMetricsRequest.

Thông tin chi tiết theo ngày

Bạn có thể nhóm các chỉ số theo chế độ cài đặt breakdown_definition.date_breakdown bằng cách sử dụng BenchmarksTimeGranularity. Khi bạn đặt date_breakdown, bạn bắt buộc phải đặt date_range trong GenerateBenchmarksMetricsRequest và phải phù hợp với ranh giới của mức độ chi tiết đã chọn:

• WEEK: Tổng hợp các chỉ số theo tuần. date_range phải bắt đầu vào Chủ Nhật và kết thúc vào Thứ Bảy (lưu ý rằng điều này khác với ISO 8601).
• MONTH: Tổng hợp các chỉ số theo tháng. date_range phải bắt đầu vào ngày đầu tiên của tháng và kết thúc vào ngày cuối cùng của tháng.
• QUARTER: Tổng hợp các chỉ số theo quý dương lịch. date_range phải bắt đầu vào ngày đầu tiên của quý và kết thúc vào ngày cuối cùng của quý.

Chỉ số phản hồi

GenerateBenchmarksMetricsResponse trả về:

• customer_metrics (thuộc loại CustomerMetrics trong phiên bản 25 trở lên; thuộc loại Metrics chỉ chứa average_rate_metrics trong phiên bản 24 trở xuống): Các chỉ số thể hiện hiệu suất quảng cáo trên YouTube của khách hàng, bao gồm:
  • average_rate_metrics: Chỉ số về giá trung bình của khách hàng.
  • share_metrics (trong phiên bản 25 trở lên): Các chỉ số về mức độ hiện diện tương đối trên thị trường (share_of_voice và share_of_spend). Chỉ được điền sẵn khi benchmarks_source chọn all_advertisers = true (đã đặt category_filter) và date_range nằm trong supported_dates_for_all_metrics.
  • aggregate_metrics (trong phiên bản 25 trở lên): Tổng số liệu tổng hợp cho khách hàng (chẳng hạn như cost, impressions, clicks và video_trueview_views).
  • percentile_metrics (trong phiên bản 25 trở lên): Các bậc phân vị về vị thế cạnh tranh theo các phương diện chính.
• average_benchmarks_metrics: Chỉ số tỷ lệ tổng hợp (RateMetrics) trên nguồn điểm chuẩn đã chọn.
• breakdown_metrics: Danh sách các chỉ số được phân đoạn theo thông tin chi tiết được xác định trong breakdown_definition.

Để biết thông số kỹ thuật đầy đủ của trường, hãy tham khảo tài liệu tham khảo GenerateBenchmarksMetricsResponse.

Chỉ số phân vị

Lưu ý: supplemental_data (BenchmarksSupplementalData) và percentile_metrics có trong phiên bản 25 trở lên.

Chỉ số phân vị thể hiện vị thế cạnh tranh của khách hàng dưới dạng các bậc phân vị so với những nhà quảng cáo khác trong phạm vi phân tích.

Điều kiện tiên quyết

Để truy xuất chỉ số phân vị, yêu cầu của bạn phải đáp ứng các yêu cầu sau:

1. Nguồn điểm chuẩn: benchmarks_source phải chọn all_advertisers = true.
2. Bộ lọc danh mục: Bạn phải cung cấp category_filter, chứa một hoặc nhiều category_ids hợp lệ được truy xuất từ ListBenchmarksSources.
3. Dữ liệu bổ sung: Bạn phải thêm PERCENTILE_DATA vào trường supplemental_data trong GenerateBenchmarksMetricsRequest.

Bậc phân vị

Hiệu suất của khách hàng được phân loại thành một trong các giá trị enum BenchmarksCustomerPercentileTier sau:

• DEVELOPING: Dưới phân vị thứ 10 ([0%, 10%)).
• ENTRY_LEVEL: Phân vị thứ 10 đến 25 ([10%, 25%)).
• EMERGING_PLAYER: Phân vị thứ 25 đến 50 ([25%, 50%)).
• COMPETITOR: Phân vị thứ 50 đến 75 ([50%, 75%)).
• STRONG_COMPETITOR: Phân vị thứ 75 đến 90 ([75%, 90%)).
• MARKET_LEADER: Bằng hoặc cao hơn phân vị thứ 90 ([90%, 100%]).

Yêu cầu mẫu

Ví dụ sau đây minh hoạ một tải trọng yêu cầu REST JSON để tạo các chỉ số điểm chuẩn có các cấp phân vị cho một người dùng so sánh hiệu suất quảng cáo trên YouTube của khách hàng của họ với các nhà quảng cáo khác đang chạy quảng cáo trong danh mục /Apparel/Clothing:

{
  "customerId": "1234567890",
  "location": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "benchmarksSource": {
    "allAdvertisers": true
  },
  "categoryFilter": {
    "categoryIds": ["10176"]
  },
  "productFilter": {
    "marketingObjectiveList": {
      "marketingObjectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplementalData": [
    "PERCENTILE_DATA"
  ]
}

Phản hồi bao gồm dữ liệu phân vị bổ sung được yêu cầu:

{
  "customerMetrics": {
    "averageRateMetrics": {
      "averageCpm": 5.42,
      "clickThroughRate": 0.0185
    },
    "shareMetrics": {
      "shareOfVoice": 0.0345,
      "shareOfSpend": 0.0410
    },
    "aggregateMetrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentileMetrics": {
      "costPercentileTier": "STRONG_COMPETITOR",
      "impressionsPercentileTier": "STRONG_COMPETITOR",
      "clicksPercentileTier": "MARKET_LEADER",
      "videoTrueviewViewsPercentileTier": "COMPETITOR",
      "viewableImpressionsPercentileTier": "STRONG_COMPETITOR",
      "interactionsPercentileTier": "MARKET_LEADER",
      "engagementsPercentileTier": "COMPETITOR"
    }
  },
  "averageBenchmarksMetrics": {
    "averageRateMetrics": {
      "averageCpm": 6.15,
      "clickThroughRate": 0.0142
    }
  }
}

Xử lý lỗi

Khi gọi BenchmarksService, bạn có thể gặp phải lỗi liên quan đến cụm từ tìm kiếm điểm chuẩn trong BenchmarksError:

• MAX_QUERY_COMPLEXITY_EXCEEDED: Tổ hợp dữ liệu đầu vào được yêu cầu quá phức tạp để xử lý. Cách giảm độ phức tạp của truy vấn:
  • Chọn một nguồn điểm chuẩn hoặc bộ lọc danh mục cụ thể hoặc chi tiết hơn.
  • Rút ngắn date_range được yêu cầu.
  • Giảm số lượng sản phẩm trong product_filter.
• NO_METRICS_FOUND (trong phiên bản 25 trở lên): Không tìm thấy chỉ số nào cho tổ hợp dữ liệu đầu vào được yêu cầu (ví dụ: một danh mục ngách ở một vị trí và phạm vi ngày cụ thể mà không có nhà quảng cáo nào chạy chiến dịch). Hãy thử điều chỉnh danh mục, vị trí, phạm vi ngày hoặc sản phẩm.

Để biết cách xử lý lỗi API chung và các phương pháp hay nhất, hãy tham khảo Hướng dẫn xử lý lỗi.

Trình theo dõi sự cố của Google

Sử dụng Trình theo dõi sự cố của Google để đặt câu hỏi hỗ trợ, báo cáo lỗi hoặc gửi yêu cầu về tính năng. Google theo dõi, ưu tiên và đăng thông tin cập nhật về yêu cầu của bạn ngay trong Trình theo dõi sự cố. Để biết thêm thông tin, hãy xem bài viết Tạo vấn đề trong Trình theo dõi sự cố của Google.

Tạo một vấn đề bằng cách sử dụng một trong các mẫu Trình theo dõi sự cố sau:

• Đặt câu hỏi chung về dịch vụ hỗ trợ hoặc gửi ý kiến phản hồi về tài liệu
• Báo cáo lỗi kỹ thuật
• Gửi yêu cầu về tính năng API

Điền thông tin chi tiết vào tất cả các trường trong mẫu để Google có thể tái hiện và ưu tiên yêu cầu của bạn. Google có thể đóng các báo cáo chưa hoàn chỉnh và yêu cầu bạn gửi một vấn đề mới kèm theo thông tin còn thiếu.