Analyze YouTube Affiliate Performance (Alpha)

Za pomocą interfejsu Reports API możesz pobierać kluczowe dane o skuteczności produktów uczestniczących w programie partnerskim YouTube. Z tego przewodnika dowiesz się, jak wysyłać zapytania o dane dotyczące programów partnerskich w 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 dedykowanych „widoków” YouTube Affiliate, które w zapytaniach działają jak tabele.

Wymagania wstępne

Zanim skorzystasz z tego przewodnika, upewnij się, że:

a także zostać zaktualizowane lub wycofane.

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

Pamiętaj, że w przypadku publicznej wersji alfa punkt końcowy jest inny. Aby pobrać dane o skuteczności programu partnerskiego YouTube, musisz wysłać żądanie POST do punktu końcowego v1alpha. 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 dowiedzieć się, którzy twórcy YouTube generują największe zaangażowanie i sprzedaż, możesz wysłać zapytanie do youtube_creator_performance_view. Ten widok zawiera zagregowane dane poszczególnych twórców YouTube, w tym tytuły twórców i identyfikatory kanałów.

Oto przykład instrukcji MCQL SELECT, której możesz użyć, aby uzyskać informacje o 3 najskuteczniejszych twórcach 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 kluczowe dane 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 konkretne filmy w YouTube są najskuteczniejsze, możesz wysłać zapytanie do youtube_content_performance_view. Ten widok zawiera zbiorcze dane dotyczące poszczególnych filmów w YouTube, w tym ich tytuły i identyfikatory.

Oto przykład instrukcji SELECT w MCQL, której możesz użyć, aby uzyskać 3 najpopularniejsze filmy według liczby wyświetleń w okresie od 1 do 2 maja 2025 r.

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 kluczowe dane dotyczące 3 najpopularniejszych filmów uszeregowanych według łącznej liczby views w określonym zakresie dat.

Wyświetlanie skuteczności według produktu

Aby analizować wyniki poszczególnych produktów w programie partnerskim YouTube, możesz wysyłać zapytania do youtube_product_performance_view. Ten widok zawiera zagregowane dane według produktu, w tym tytuły produktów i identyfikatory ofert.

Oto przykład instrukcji SELECT w MCQL, której możesz użyć, aby znaleźć 3 najpopularniejsze produkty według kwoty sprzedaży w okresie od 1 do 2 maja 2025 r.:

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

To zapytanie zwraca tytuł produktu, identyfikator oferty i dane o skuteczności 3 najpopularniejszych produktów w określonym przedziale czasu, uporządkowane według danych sales.

Istotne kwestie

  • Daty: zawsze filtruj zapytania według date, używając klauzul WHERE, aby określić okres raportowania. Daty są podane w formacie YYYY-MM-DD.
  • Opóźnienie: opóźnienie zapytań zależy 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.