Analyze Youtube Affiliate Performance (Alpha)

Za pomocą podrzędnego interfejsu API Reporting możesz pobierać najważniejsze dane o skuteczności produktów uczestniczących w programie partnerskim YouTube. Z tego przewodnika dowiesz się, jak wysyłać zapytania o dane partnerskie dotyczące 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 partnerskich YouTube, które działają jak tabele w zapytaniach.

Wymagania wstępne

Zanim zaczniesz korzystać 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 w wersji alfa

Pamiętaj, że ponieważ jest to publiczna wersja alfa, punkt końcowy jest inny. Aby pobrać dane o skuteczności partnera YouTube, musisz wysłać żądanie POST do punktu końcowego v1alpha. Oto 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 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 między 1 a 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 konkretne 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 najpopularniejsze filmy według wyświetleń między 1 a 2 maja 2025 r., przekaż tę instrukcję MCQL do accounts.reports.search metody:

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

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

Aby sprawdzić, które otagowane produkty mają największe zaangażowanie i sprzedaż, możesz wysłać zapytanie do youtube_product_tagged_stats_view. Ten widok agreguje dane według poszczególnych otagowanych produktów, w tym ich tytułów i identyfikatorów ofert.

Oto przykład instrukcji MCQL SELECT, której możesz użyć, aby uzyskać 10 najpopularniejszych produktów według wyświetleń między 20 a 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 najważniejsze dane dotyczące 10 najpopularniejszych produktów według łącznej liczby views w określonym zakresie dat.

Wyświetlanie najczęściej sprzedawanych produktów

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

Oto przykład instrukcji MCQL SELECT, której możesz użyć, aby uzyskać 10 najpopularniejszych produktów według sprzedaży brutto między 20 a 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, prowizje i najważniejsze dane dotyczące 10 najpopularniejszych produktów według sprzedaży brutto 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ą podawane 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.