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 partnerów 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:

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 v1alpha punktu końcowego. 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,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY 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 uszeregowanych według danych sprzedaży 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,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3

To zapytanie pobiera tytuł filmu, identyfikator filmu i najważniejsze dane dotyczące 3 najlepszych filmów uszeregowanych 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. Duże zapytania będą trwały dłużej i mogą powodować przekroczenie limitu czasu.