Testy porównawcze w YouTube

BenchmarksService umożliwia reklamodawcom i agencjom porównywanie skuteczności reklam w YouTube z testami porównawczymi w branży. Dzięki tej usłudze możesz oceniać skuteczność swoich kampanii w porównaniu z branżami lub wszystkimi reklamodawcami w określonych kategoriach produktów i usług.

Najważniejsze funkcje

Za pomocą BenchmarksService możesz:

  • Porównywanie skuteczności: oceniaj średnie wskaźniki stawek klienta (np. CPM, CPV, CTR i widoczność) na tle zagregowanych średnich branżowych.
  • Analizowanie udziału w rynku: poznaj względną obecność klienta na rynku dzięki udziałowi w odsłonach (względne wyświetlenia) i udziałowi w wydatkach.
  • Ocena pozycji konkurencyjnej: mierz pozycję konkurencyjną klienta za pomocą danych procentowych, które klasyfikują skuteczność w kluczowych wymiarach w odniesieniu do poziomów konkurencyjności (np. lider rynku lub konkurent).
  • Segmentowanie według czasu: grupuj dane porównawcze według tygodni, miesięcy lub kwartałów.
  • Odkrywanie obsługiwanych wymiarów porównawczych: możesz wysyłać zapytania o dostępne zakresy dat, lokalizacje geograficzne, usługi reklamowe i źródła danych porównawczych (branże lub kategorie produktów i usług).

Metody wykrywania

Zanim wygenerujesz dane porównawcze, użyj metod wykrywania, aby pobrać prawidłowe parametry i kryteria zakresu dla swoich żądań.

Wyświetlanie dostępnych dat

Metoda ListBenchmarksAvailableDates zwraca historyczne zakresy dat, które obsługują dane porównawcze w ListBenchmarksAvailableDatesResponse.

Odpowiedź zawiera 2 różne zakresy dat:

  • supported_dates: ogólny zakres dat, w którym obsługiwane są dane porównawcze (włącznie). Żądania dotyczące wartości porównawczych mogą dotyczyć dat z tego zakresu.
  • supported_dates_for_all_metrics: podzbiór supported_dates, który obsługuje pełny zestaw danych porównawczych. Niektóre rodzaje danych – w szczególności dane dotyczące udziału klientów (share_of_voice i share_of_spend) oraz dane dotyczące średniego kursu z źródła danych porównawczych – są dostępne tylko w tym zakresie dat ze względu na ograniczoną dostępność danych. Te dane są pomijane w odpowiedzi, jeśli żądany zakres date_range nie mieści się w całości w zakresie supported_dates_for_all_metrics.

Wyświetlenie listy lokalizacji

Metoda ListBenchmarksLocations zwraca listę lokalizacji geograficznych (np. krajów), które obsługują dane porównawcze.

Każdy element BenchmarksLocation w odpowiedzi zawiera:

  • location_name: Unikalna nazwa lokalizacji w języku angielskim (np. "United States").
  • location_type: typ lokalizacji odpowiadający wartości target_type w interfejsie Google Ads API (np. "Country").
  • location_info: obiekt LocationInfo zawierający stałą kierowania geograficznego (np. geo_target_constant: "geoTargetConstants/2840").

Wyświetl listę produktów

Metoda ListBenchmarksProducts zwraca listę produktów i celów marketingowych dostępnych do porównywania z danymi konkurencji.

Każdy wpis BenchmarksProductMetadata zawiera:

  • product_name: przyjazna dla użytkownika nazwa produktu.
  • product_code: ciąg unikalnego identyfikatora produktu używany podczas tworzenia ProductFilter.
  • marketing_objective: powiązany cel marketingowy (BenchmarksMarketingObjective):
    • AWARENESS: kampanie zaprojektowane w celu zwiększenia świadomości marki lub produktu.
    • CONSIDERATION: kampanie zaprojektowane tak, aby zachęcać potencjalnych klientów do rozważenia zakupu produktów Twojej marki.
    • ACTION: kampanie zaprojektowane z myślą o zachęcaniu do konkretnego działania powodującego konwersję.

Wyświetl źródła testów porównawczych

Metoda ListBenchmarksSources pobiera dostępne źródła testów porównawczych. Określ typy źródeł do pobrania za pomocą parametru BenchmarksSourceType:

  • INDUSTRY_VERTICAL: klasyfikacje segmentów branżowych (np. „Technologia” lub „Finanse”);
  • CATEGORY: Kategorie produktów i usług (np. „/Ubrania/Odzież”). Kategorie można stosować jako filtry, aby ograniczać zakres testów porównawczych podczas porównywania wyników ze wszystkimi reklamodawcami.

Odpowiedź zwraca listę obiektów BenchmarksSourceMetadata zawierających:

  • IndustryVerticalInfo: zawiera industry_vertical_name, industry_vertical_id i parent_industry_vertical_id (w stosownych przypadkach).
  • CategoryInfo: zawiera category_name, category_id i category_path (pełna hierarchia kategorii).

Generowanie danych porównawczych

Wywołaj funkcję GenerateBenchmarksMetrics, aby porównać dane reklam w YouTube klienta z wartościami referencyjnymi w branży.

Parametry żądania

GenerateBenchmarksMetricsRequest Zakresy analizy. Musisz podać co najmniej customer_id klienta, location lokalizację geograficzną, benchmarks_source (np. konkretną branżę lub wszystkich reklamodawców w zakresie category_filter) i product_filter. Możesz opcjonalnie podać date_range, pogrupować dane za pomocą breakdown_definition, określić currency_code lub poprosić o dodatkowe funkcje, takie jak PERCENTILE_DATA, za pomocą supplemental_data.

Pełne definicje parametrów i wymagania znajdziesz w dokumentacji referencyjnej GenerateBenchmarksMetricsRequest.

Podziały według daty

Możesz grupować dane, ustawiając breakdown_definition.date_breakdown za pomocą BenchmarksTimeGranularity:

  • WEEK: agreguje dane według tygodnia. date_range musi zaczynać się w niedzielę i kończyć w sobotę (zwróć uwagę, że różni się to od formatu ISO 8601).
  • MONTH: agreguje dane według miesięcy. date_range musi rozpoczynać się pierwszego dnia miesiąca i kończyć ostatniego dnia miesiąca.
  • QUARTER: agreguje dane według kwartału kalendarzowego. date_range musi rozpoczynać się pierwszego dnia kwartału i kończyć ostatniego dnia kwartału.

Dane odpowiedzi

GenerateBenchmarksMetricsResponse zwraca:

Pełne specyfikacje pól znajdziesz w GenerateBenchmarksMetricsResponsedokumentacji.

Dane percentylowe

Dane percentylowe przedstawiają pozycję konkurencyjną klienta w postaci przedziałów percentylowych na tle innych reklamodawców w ramach analizy o określonym zakresie.

Wymagania wstępne

Aby pobrać dane procentowe, Twoja prośba musi spełniać te wymagania:

  1. Źródło testów porównawczych: musisz wybrać benchmarks_sourceall_advertisers = true.
  2. Filtr kategorii: category_filter musi zawierać co najmniej 1 prawidłowy category_ids pobrany z ListBenchmarksSources.
  3. Dane dodatkowe: musisz dodać PERCENTILE_DATA do pola supplemental_data w GenerateBenchmarksMetricsRequest.

Poziomy percentylowe

Skuteczność klienta jest klasyfikowana w jednej z wartości wyliczeniowych BenchmarksCustomerPercentileTier (od DEVELOPING w przypadku niższych poziomów do MARKET_LEADER w przypadku reklamodawców o najwyższej skuteczności). Opis każdego poziomu i jego granice procentowe znajdziesz w dokumentacji referencyjnej BenchmarksCustomerPercentileTier.

Przykładowe żądanie

Poniższy przykład ilustruje ładunek żądania REST w formacie JSON, który służy do generowania danych porównawczych z poziomami percentyli dla użytkownika porównującego skuteczność reklam w YouTube swojego klienta z reklamami innych reklamodawców wyświetlanymi w kategorii /Odzież/Ubrania:

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

Odpowiedź zawierająca dodatkowe dane procentowe:

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

Obsługa błędów

Podczas wywoływania funkcji BenchmarksService możesz napotkać błędy związane z zapytaniami dotyczącymi testów porównawczych w BenchmarksError:

  • MAX_QUERY_COMPLEXITY_EXCEEDED: kombinacja żądanych danych wejściowych jest zbyt złożona, aby można ją było przetworzyć. Aby zmniejszyć złożoność zapytania:
    • Wybierz bardziej szczegółowe źródło danych porównawczych lub filtr kategorii.
    • Skróć żądany date_range.
    • Zmniejsz liczbę produktów w product_filter.
  • NO_METRICS_FOUND: nie znaleziono danych dla żądanej kombinacji danych wejściowych (np. kategorii niszowej w określonej lokalizacji i zakresie dat, w których żaden reklamodawca nie prowadził kampanii). Spróbuj dostosować kategorię, lokalizację, zakres dat lub produkty.

Ogólne informacje o obsłudze błędów interfejsu API i sprawdzone metody znajdziesz w przewodniku po obsłudze błędów.

Wstecz
Statystyki twórców YouTube