Tolok ukur YouTube

Penting: Fitur ini hanya tersedia untuk akun yang ada 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 menggunakan layanan ini, Anda dapat mengevaluasi performa kampanye Anda dibandingkan dengan vertikal industri atau di semua pengiklan dalam kategori produk dan layanan tertentu.

Kemampuan utama

Dengan BenchmarksService, Anda dapat:

• Membandingkan performa: Evaluasi metrik rasio 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 (tayangan relatif) dan pangsa pembelanjaan.
• Mengevaluasi posisi kompetitif: Ukur posisi kompetitif pelanggan menggunakan metrik persentil yang mengklasifikasikan performa di berbagai dimensi utama ke dalam tingkat kompetitif (seperti Pemimpin Pasar atau Kompetitor).
• Segmentasikan menurut waktu: Kelompokkan metrik tolok ukur menurut perincian waktu mingguan, bulanan, atau triwulanan.
• Menemukan dimensi tolok ukur yang didukung: Buat kueri rentang tanggal, lokasi geografis, produk iklan, dan sumber tolok ukur (vertikal industri atau kategori produk dan layanan) yang tersedia.

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 yang valid dan kriteria cakupan untuk permintaan Anda.

Mencantumkan tanggal 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 mengkueri tanggal dalam rentang ini.
• supported_dates_for_all_metrics (di v25 dan yang lebih baru): Subset supported_dates yang mendukung kumpulan lengkap metrik tolok ukur. Metrik tertentu—khususnya metrik pangsa pelanggan (share_of_voice dan share_of_spend) dan metrik tarif rata-rata sumber tolok ukur—hanya tersedia dalam rentang tanggal ini karena ketersediaan data yang terbatas. Metrik ini dihilangkan dari 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 brand awareness atau awareness 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, "Technology" atau "Finance").
• CATEGORY (di v25 dan yang lebih baru): Kategori Produk & Layanan (misalnya, "/Apparel/Clothing"). Kategori dapat digunakan sebagai filter untuk menentukan cakupan tolok ukur saat membandingkan dengan semua pengiklan.

Respons akan menampilkan daftar objek BenchmarksSourceMetadata yang berisi:

• IndustryVerticalInfo: Berisi industry_vertical_name, industry_vertical_id, dan parent_industry_vertical_id (jika ada).
• CategoryInfo (di v25 dan yang lebih baru): 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

GenerateBenchmarksMetricsRequest mencakup analisis. Minimal, Anda harus menentukan customer_id klien, location geografis (LocationInfo), benchmarks_source (industry_vertical_id atau, di v25 dan yang lebih baru, all_advertisers yang dicakup oleh category_filter), dan product_filter. Anda dapat:

• Berikan date_range (jika dihilangkan, data akan ditampilkan untuk kuartal terbaru dengan data yang tersedia).
• Kelompokkan metrik dengan breakdown_definition.
• Tentukan currency_code ISO 4217 tiga karakter (jika dihilangkan, metrik moneter seperti CPM dan biaya akan ditetapkan secara default ke USD).
• Tentukan nama customer_benchmarks_group yang ditentukan pengguna untuk pelanggan yang sedang direncanakan.
• Minta fitur tambahan seperti PERCENTILE_DATA melalui supplemental_data (di v25 dan yang lebih baru).

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

Perincian tanggal

Anda dapat mengelompokkan metrik berdasarkan setelan breakdown_definition.date_breakdown menggunakan BenchmarksTimeGranularity. Jika date_breakdown ditetapkan, date_range di GenerateBenchmarksMetricsRequest diperlukan dan harus selaras dengan batas perincian yang dipilih:

• 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 dalam bulan tersebut dan berakhir pada hari terakhir dalam bulan tersebut.
• QUARTER: Menggabungkan metrik berdasarkan kuartal kalender. date_range harus dimulai pada hari pertama kuartal dan berakhir pada hari terakhir kuartal.

Metrik respons

GenerateBenchmarksMetricsResponse akan menampilkan:

• customer_metrics (dari jenis CustomerMetrics di v25 dan yang lebih baru; dari jenis Metrics yang hanya berisi average_rate_metrics di v24 dan yang lebih lama): Metrik yang mewakili performa iklan YouTube pelanggan, termasuk:
  • average_rate_metrics: Metrik tarif rata-rata untuk pelanggan.
  • share_metrics (di v25 dan yang lebih baru): Metrik kehadiran pasar relatif (share_of_voice dan share_of_spend). Hanya diisi jika benchmarks_source memilih all_advertisers = true (dengan category_filter ditetapkan) dan date_range berada dalam supported_dates_for_all_metrics.
  • aggregate_metrics (di v25 dan yang lebih baru): Total gabungan untuk pelanggan (seperti cost, impressions, clicks, dan video_trueview_views).
  • percentile_metrics (di v25 dan yang lebih baru): Tingkat persentil posisi kompetitif di seluruh dimensi utama.
• 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

Catatan: supplemental_data (BenchmarksSupplementalData) dan percentile_metrics tersedia di v25 dan yang lebih baru.

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

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 berikut:

• DEVELOPING: Di bawah persentil ke-10 ([0%, 10%)).
• ENTRY_LEVEL: Persentil ke-10 hingga ke-25 ([10%, 25%)).
• EMERGING_PLAYER: Persentil ke-25 hingga ke-50 ([25%, 50%)).
• COMPETITOR: Persentil ke-50 hingga ke-75 ([50%, 75%)).
• STRONG_COMPETITOR: Persentil ke-75 hingga ke-90 ([75%, 90%)).
• MARKET_LEADER: Pada atau di atas persentil ke-90 ([90%, 100%]).

Contoh permintaan

Contoh berikut mengilustrasikan 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:

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

Respons yang menyertakan data persentil tambahan yang diminta:

{
  "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
    }
  }
}

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 kompleks untuk diproses. Untuk mengurangi kompleksitas kueri:
  • Pilih sumber tolok ukur atau pemfilteran kategori yang lebih spesifik atau terperinci.
  • Mempersingkat date_range yang diminta.
  • Kurangi jumlah produk di product_filter.
• NO_METRICS_FOUND (di v25 dan yang lebih baru): Tidak ada metrik yang ditemukan untuk kombinasi input yang diminta (misalnya, kategori khusus di lokasi dan rentang tanggal tertentu tempat tidak ada pengiklan yang menjalankan kampanye). Coba sesuaikan kategori, lokasi, rentang tanggal, atau produk.

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

Google Issue Tracker

Gunakan Issue Tracker Google untuk mengajukan pertanyaan dukungan, melaporkan bug, atau mengirimkan permintaan fitur. Google melacak, memprioritaskan, dan memposting info terbaru tentang permintaan Anda langsung di Issue Tracker. Untuk mengetahui informasi selengkapnya, lihat Membuat laporan masalah di Issue Tracker Google.

Laporkan masalah menggunakan salah satu template Issue Tracker berikut:

• Mengajukan pertanyaan dukungan umum atau mengirimkan masukan terkait dokumentasi
• Melaporkan bug teknis
• Mengirimkan permintaan fitur API

Isi semua kolom dalam template dengan informasi mendetail agar Google dapat mereproduksi dan memprioritaskan permintaan Anda. Google mungkin akan menutup laporan yang tidak lengkap dan meminta Anda mengirimkan masalah baru dengan detail yang tidak ada.