Tolok ukur YouTube

Penting: Fitur ini hanya tersedia untuk akun dalam daftar yang diizinkan. Hubungi perwakilan Google Anda jika Anda memerlukan akses ke fitur ini.

BenchmarksService memungkinkan pengiklan dan agensi membandingkan performa iklan YouTube mereka dengan tolok ukur industri. Dengan layanan ini, Anda dapat mengevaluasi performa kampanye relatif terhadap vertikal industri atau di seluruh pengiklan dalam kategori produk dan layanan tertentu.

Kemampuan utama

Dengan BenchmarksService, Anda dapat:

• Membandingkan performa: Mengevaluasi metrik tarif rata-rata pelanggan (seperti CPM, CPV, CTR, dan visibilitas) terhadap rata-rata industri gabungan.
• Menganalisis pangsa pasar: Pahami kehadiran pasar relatif pelanggan melalui pangsa media (impresi relatif) dan pangsa pembelanjaan.
• Mengevaluasi posisi kompetitif: Ukur posisi kompetitif pelanggan menggunakan metrik persentil yang mengklasifikasikan performa di seluruh dimensi utama ke dalam tingkat kompetitif (seperti Pemimpin Pasar atau Kompetitor).
• Segmen menurut waktu: Kelompokkan metrik tolok ukur menurut perincian waktu mingguan, bulanan, atau kuartalan.
• Temukan dimensi tolok ukur yang didukung: Kueri rentang tanggal, lokasi geografis, produk iklan, dan sumber tolok ukur yang tersedia (kategori industri atau kategori produk dan layanan).

Catatan: Anda harus memberikan ID pelanggan klien dalam permintaan Anda. ID pelanggan akun pengelola tidak akan menampilkan metrik pelanggan karena akun pengelola tidak menjalankan kampanye iklan secara langsung.

Metode penemuan

Sebelum membuat metrik tolok ukur, gunakan metode penemuan untuk mengambil parameter dan kriteria cakupan yang valid untuk permintaan Anda.

Mencantumkan tanggal yang tersedia

Metode ListBenchmarksAvailableDates menampilkan rentang tanggal historis yang mendukung data tolok ukur dalam ListBenchmarksAvailableDatesResponse.

Respons memberikan dua rentang tanggal yang berbeda:

• supported_dates: Rentang tanggal keseluruhan tempat metrik tolok ukur didukung (inklusif). Permintaan tolok ukur dapat membuat kueri tanggal dalam rentang ini.
• supported_dates_for_all_metrics: Subkumpulan supported_dates yang mendukung kumpulan lengkap metrik benchmark. Metrik tertentu—khususnya metrik pangsa pelanggan (share_of_voice dan share_of_spend) serta metrik tarif rata-rata sumber tolok ukur—hanya tersedia dalam rentang tanggal ini karena ketersediaan data yang terbatas. Metrik ini tidak disertakan dalam respons jika date_range yang diminta tidak sepenuhnya berada dalam supported_dates_for_all_metrics.

Mencantumkan lokasi

Metode ListBenchmarksLocations menampilkan daftar lokasi geografis (seperti negara) yang mendukung data tolok ukur.

Setiap BenchmarksLocation dalam respons mencakup:

• location_name: Nama lokasi unik dalam bahasa Inggris (misalnya, "United States").
• location_type: Jenis lokasi yang sesuai dengan target_type di Google Ads API (misalnya, "Country").
• location_info: Objek LocationInfo yang berisi konstanta target geografis (seperti geo_target_constant: "geoTargetConstants/2840").

Membuat daftar produk

Metode ListBenchmarksProducts menampilkan daftar produk dan tujuan pemasaran yang tersedia untuk tolok ukur.

Setiap entri BenchmarksProductMetadata mencakup:

• product_name: Nama produk yang mudah digunakan.
• product_code: String ID unik untuk produk, yang digunakan saat membuat ProductFilter.
• marketing_objective: Tujuan pemasaran terkait (BenchmarksMarketingObjective):
  • AWARENESS: Kampanye yang dirancang untuk meningkatkan awareness merek atau produk.
  • CONSIDERATION: Kampanye yang dirancang untuk mendorong calon pelanggan mempertimbangkan merek atau produk.
  • ACTION: Kampanye yang dirancang untuk mendorong tindakan konversi tertentu.

Mencantumkan sumber tolok ukur

Metode ListBenchmarksSources mengambil sumber tolok ukur yang tersedia. Tentukan jenis sumber yang akan diambil menggunakan BenchmarksSourceType:

• INDUSTRY_VERTICAL: Klasifikasi segmen industri (misalnya, "Teknologi" atau "Keuangan").
• CATEGORY: Kategori Produk & Layanan (misalnya, "/Apparel/Clothing"). Kategori dapat digunakan sebagai filter untuk menentukan cakupan tolok ukur saat membandingkan dengan semua pengiklan.

Respons menampilkan daftar objek BenchmarksSourceMetadata yang berisi salah satu dari:

• IndustryVerticalInfo: Berisi industry_vertical_name, industry_vertical_id, dan parent_industry_vertical_id (jika ada).
• CategoryInfo: Berisi category_name, category_id, dan category_path (hierarki kategori lengkap).

Membuat metrik tolok ukur

Panggil GenerateBenchmarksMetrics untuk membandingkan metrik iklan YouTube pelanggan dengan tolok ukur industri.

Parameter permintaan

Cakupan GenerateBenchmarksMetricsRequest analisis. Minimal, Anda harus menentukan customer_id klien, location geografis, benchmarks_source (seperti vertikal industri tertentu atau semua pengiklan yang dicakup oleh category_filter), dan product_filter. Anda dapat secara opsional memberikan date_range, mengelompokkan metrik dengan breakdown_definition, menentukan currency_code, atau meminta fitur tambahan seperti PERCENTILE_DATA melalui supplemental_data.

Untuk mengetahui definisi dan persyaratan parameter lengkap, lihat dokumentasi referensi GenerateBenchmarksMetricsRequest.

Perincian tanggal

Anda dapat mengelompokkan metrik dengan menetapkan breakdown_definition.date_breakdown menggunakan BenchmarksTimeGranularity:

• WEEK: Menggabungkan metrik menurut minggu. date_range harus dimulai pada hari Minggu dan berakhir pada hari Sabtu (perhatikan bahwa ini berbeda dengan ISO 8601).
• MONTH: Menggabungkan metrik menurut bulan. date_range harus dimulai pada hari pertama bulan dan berakhir pada hari terakhir bulan.
• QUARTER: Menggabungkan metrik menurut kuartal kalender. date_range harus dimulai pada hari pertama kuartal dan berakhir pada hari terakhir kuartal.

Metrik respons

GenerateBenchmarksMetricsResponse akan menampilkan:

• customer_metrics: Metrik yang merepresentasikan performa iklan YouTube pelanggan, termasuk average_rate_metrics, share_metrics, aggregate_metrics, dan percentile_metrics.
• average_benchmarks_metrics: Metrik rasio gabungan (RateMetrics) di seluruh sumber tolok ukur yang dipilih.
• breakdown_metrics: Daftar metrik yang disegmentasikan menurut perincian yang ditentukan dalam breakdown_definition.

Untuk mengetahui spesifikasi kolom lengkap, lihat dokumentasi referensi GenerateBenchmarksMetricsResponse.

Metrik persentil

Metrik persentil menunjukkan posisi kompetitif pelanggan sebagai tingkat persentil di antara pengiklan lain dalam analisis yang tercakup.

Prasyarat

Untuk mengambil metrik persentil, permintaan Anda harus memenuhi persyaratan berikut:

1. Sumber tolok ukur: benchmarks_source harus memilih all_advertisers = true.
2. Filter kategori: category_filter harus diberikan, yang berisi satu atau beberapa category_ids valid yang diambil dari ListBenchmarksSources.
3. Data tambahan: Anda harus menambahkan PERCENTILE_DATA ke kolom supplemental_data di GenerateBenchmarksMetricsRequest.

Tingkatan persentil

Performa pelanggan diklasifikasikan ke dalam salah satu nilai enum BenchmarksCustomerPercentileTier (mulai dari DEVELOPING untuk tingkat yang lebih rendah hingga MARKET_LEADER untuk pengiklan dengan performa terbaik). Untuk mengetahui deskripsi setiap tingkat dan batas persentilnya, lihat dokumentasi referensi BenchmarksCustomerPercentileTier.

Contoh permintaan

Contoh berikut menggambarkan payload permintaan JSON REST untuk membuat metrik tolok ukur dengan tingkat persentil bagi pengguna yang membandingkan performa iklan YouTube pelanggannya dengan pengiklan lain yang menjalankan iklan dalam kategori /Apparel/Clothing:

{
  "customer_id": "1234567890",
  "location": {
    "geo_target_constant": "geoTargetConstants/2840"
  },
  "benchmarks_source": {
    "all_advertisers": true
  },
  "category_filter": {
    "category_ids": ["10176"]
  },
  "product_filter": {
    "marketing_objective_list": {
      "marketing_objectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplemental_data": [
    "PERCENTILE_DATA"
  ]
}

Respons yang menyertakan data persentil tambahan yang diminta:

{
  "customer_metrics": {
    "average_rate_metrics": {
      "average_cpm": 5.42,
      "click_through_rate": 0.0185
    },
    "share_metrics": {
      "share_of_voice": 0.0345,
      "share_of_spend": 0.0410
    },
    "aggregate_metrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentile_metrics": {
      "cost_percentile_tier": "STRONG_COMPETITOR",
      "impressions_percentile_tier": "STRONG_COMPETITOR",
      "clicks_percentile_tier": "MARKET_LEADER",
      "video_trueview_views_percentile_tier": "COMPETITOR",
      "viewable_impressions_percentile_tier": "STRONG_COMPETITOR",
      "interactions_percentile_tier": "MARKET_LEADER",
      "engagements_percentile_tier": "COMPETITOR"
    }
  },
  "average_benchmarks_metrics": {
    "average_rate_metrics": {
      "average_cpm": 6.15,
      "click_through_rate": 0.0142
    }
  }
}

Penanganan error

Saat memanggil BenchmarksService, Anda mungkin mengalami error khusus untuk kueri tolok ukur di BenchmarksError:

• MAX_QUERY_COMPLEXITY_EXCEEDED: Kombinasi input yang diminta terlalu rumit untuk diproses. Untuk mengurangi kompleksitas kueri:
  • Pilih filter kategori atau sumber tolok ukur yang lebih spesifik atau terperinci.
  • Memperpendek date_range yang diminta.
  • Kurangi jumlah produk di product_filter.
• NO_METRICS_FOUND: Tidak ada metrik yang ditemukan untuk kombinasi input yang diminta (misalnya, kategori khusus di lokasi dan rentang tanggal tertentu saat tidak ada pengiklan yang menjalankan kampanye). Coba sesuaikan kategori, lokasi, rentang tanggal, atau produk.

Untuk penanganan error dan praktik terbaik API umum, lihat Panduan penanganan error.