Analyze Youtube Affiliate Performance (Alpha)

Za pomocą interfejsu Reports API możesz pobierać najważniejsze dane o skuteczności produktów biorących udział w programie partnerskim YouTube. Z tego przewodnika dowiesz się, jak wysyłać zapytania o dane partnerskie charakterystyczne dla YouTube , takie jak sprzedaż, prowizje, zamówienia, wyświetlenia i kliknięcia , przypisane do różnych twórców, treści wideo i poszczególnych produktów.

Za pomocą MCQL możesz wybierać dane i wymiary z widoków „Wyświetlenia” w programie partnerskim YouTube, które w zapytaniach działają jak tabele.

Wymagania wstępne

Zanim zaczniesz korzystać z tego przewodnika, upewnij się, że:

• Konto używane do uwierzytelniania wywołań interfejsu API ma rolę Skuteczność i statystyki , która zapewnia dostęp do danych o skuteczności.
• Twoje konto Google Merchant Center bierze udział w programie partnerskim YouTube .

Uwaga: widoki skuteczności w programie partnerskim YouTube w interfejsie Merchant Reports API są dostępne w wersji alfa. Funkcje i funkcjonalność mogą ulec zmianie, a także zostać zaktualizowane lub wycofane.

Wysyłanie zapytań do punktu końcowego w wersji alfa

Pamiętaj, że ponieważ jest to publiczna wersja alfa, punkt końcowy jest inny. Aby pobrać dane o skuteczności w programie partnerskim YouTube, musisz wysłać żądanie POST do punktu końcowego v1alpha. Oto przykładowe żądanie:

HTTP

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

cURL

  curl -X POST \
  'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

Wyświetlanie skuteczności według twórcy

Aby sprawdzić, którzy twórcy YouTube generują najwięcej zaangażowania i sprzedaży, możesz wysłać zapytanie do youtube_creator_performance_view. Ten widok agreguje dane według poszczególnych twórców YouTube i zawiera tytuły twórców oraz identyfikatory kanałów.

Oto przykład instrukcji MCQL SELECT, której możesz użyć, aby uzyskać 3 najlepszych twórców pod względem sprzedaży w okresie od 1 do 2 maja 2025 r.

SELECT
  title,
  channel_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date <= '2025-05-02'
ORDER BY gross_sales DESC LIMIT 3

To zapytanie pobiera tytuł twórcy, identyfikator kanału i najważniejsze dane o skuteczności 3 najlepszych twórców według danych o sprzedaży brutto w określonym zakresie dat.

Wyświetlanie skuteczności według treści

Aby sprawdzić, które filmy w YouTube są najskuteczniejsze, możesz wysłać zapytanie do youtube_content_performance_view. Ten widok agreguje dane według poszczególnych filmów w YouTube i zawiera tytuły oraz identyfikatory filmów.

Aby pobrać 3 najlepsze filmy według wyświetleń w okresie od 1 do 2 maja 2025 r., przekaż tę instrukcję w języku zapytań Merchant Center do metody accounts.reports.search:

SELECT
  title,
  video_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views,
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date <= '2025-05-02'
ORDER BY views DESC LIMIT 3

To zapytanie pobiera tytuł filmu, identyfikator filmu i najważniejsze dane o skuteczności 3 najlepszych filmów według łącznej liczby views w określonym zakresie dat.

Istotne kwestie

• Daty: zawsze filtruj zapytania według date za pomocą klauzul WHERE, aby określić okres raportowania. Daty są w formacie YYYY-MM-DD.
• Opóźnienie: opóźnienie zapytań będzie zależeć od ilości żądanych danych. W przypadku dużych zapytań czas oczekiwania będzie dłuższy i może dojść do przekroczenia limitu czasu.