Analyze Youtube Affiliate Performance (Alpha)

Za pomocą interfejsu Reporting API możesz pobierać kluczowe wskaźniki 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ą języka zapytań Merchant Center (MCQL) możesz wybierać dane i wymiary z dedykowanych widoków partnera YouTube, które w zapytaniach działają jak tabele.

Wymagania wstępne

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

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

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:

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

  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 w YouTube generują największe zaangażowanie i sprzedaż, możesz wysłać zapytanie do usługi 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ładowe zapytanie MCQL SELECT, które możesz wykorzystać, aby uzyskać informacje o 3 twórcach z najwyższą sprzedażą 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 kluczowe wskaźniki skuteczności w przypadku 3 najlepszych twórców uszeregowanych według wskaźnika sprzedaży brutto 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 zagregowane dane dotyczące poszczególnych filmów w YouTube, w tym tytuły i identyfikatory filmów.

Aby pobrać 3 filmy z największą liczbą wyświetleń w okresie od 1 do 2 maja 2025 r., przekaż to zapytanie MCQL 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 kluczowe statystyki 3 najpopularniejszych filmów uszeregowanych według łącznej liczby views w określonym zakresie dat.

Wyświetlanie otagowanych produktów z największym zaangażowaniem

Aby dowiedzieć się, które otagowane produkty cieszą się największym zainteresowaniem i generują największą sprzedaż, możesz wysłać zapytanie do youtube_product_tagged_stats_view. W tym widoku dane są agregowane według poszczególnych otagowanych produktów, w tym ich tytułów i identyfikatorów ofert.

Oto przykładowe zapytanie MCQLSELECT, które możesz wykorzystać, aby uzyskać 10 najpopularniejszych produktów według wyświetleń w dniach 20–21 stycznia 2026 r.:

SELECT
  title,
  offer_id,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10

To zapytanie pobiera tytuły, liczbę otagowanych filmów i kluczowe dane dotyczące 10 najpopularniejszych produktów uszeregowanych według łącznej liczby views w określonym zakresie dat.

Wyświetlanie najczęściej sprzedawanych produktów

Aby dowiedzieć się, które produkty mają największą sprzedaż, możesz wysłać zapytanie do youtube_product_sold_stats_view.

Oto przykład instrukcji MCQLSELECT, której możesz użyć, aby uzyskać 10 najpopularniejszych produktów uszeregowanych według sprzedaży brutto w dniach 20–21 stycznia 2026 r.:

SELECT
  title,
  offer_id,
  gross_sales,
  net_sales,
  commissions,
  orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10

To zapytanie pobiera dane o sprzedaży, prowizjach i kluczowych danych w przypadku 10 najpopularniejszych produktów zamówionych według sprzedaży brutto w określonym zakresie dat.

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. Zapytania obejmujące duże zbiory danych trwają dłużej i mogą powodować przekroczenie limitu czasu.