Analizowanie wyników programu partnerskiego YouTube (wersja alfa)

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, poszczególnych produktów i kampanii kierowanych na określone grupy odbiorców.

Korzystanie z interfejsów API programu partnerskiego YouTube i powiązanych z nimi danych musi być zgodne z zasadami dla deweloperów dotyczącymi Zakupów na YouTube.

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.

Wersja eksperymentalna: widoki wyników partnera YouTube w podinterfejsie API Raportowanie sprzedawcy są dostępne w wersji alfa. Funkcje i funkcjonalności mogą ulec zmianie, a także zostać zaktualizowane lub wycofane.

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

Ponieważ ta funkcja jest dostępna w 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. Więcej informacji o pobieraniu raportów znajdziesz w sekcji accounts.reports.search. Przykładowe żądanie:

HTTP

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

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --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 według poszczególnych twórców YouTube, w tym tytuły twórców i identyfikatory kanałów.

Oto przykładowe zapytanie MCQLSELECT, 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 dane o skuteczności 3 najlepszych twórców uszeregowanych 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 zawiera zbiorcze 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ż do metody accounts.reports.search to zapytanie MCQL:

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 dane dotyczące 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 zaangażowaniem i generują największą sprzedaż, możesz wysłać zapytanie do usługi youtube_product_tagged_stats_view. Ten widok zawiera zagregowane dane według poszczególnych otagowanych produktów, w tym ich tytuły i identyfikatory ofert.

Oto przykład instrukcji MCQLSELECT, której możesz użyć, 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
    

Pobierze ono dane o sprzedaży, prowizjach i kluczowych danych dotyczące 10 najpopularniejszych produktów uporządkowanych według sprzedaży brutto w określonym zakresie dat.

Sprawdzanie skuteczności wszystkich kampanii

Aby dowiedzieć się, jak ogólnie radzą sobie Twoje kampanie stowarzyszone, wyślij zapytanie do youtube_campaigns_stats_view. Ten widok zawiera zagregowane dane ze wszystkich kampanii, w tym nazwy kampanii, daty rozpoczęcia i zakończenia, liczbę aktywnych twórców oraz dane o sprzedaży i zaangażowaniu.

Użyj tego wyrażenia MCQLSELECT, aby uzyskać 10 najskuteczniejszych kampanii pod względem zamówień z 23 kwietnia 2026 r.:

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10
    

To zapytanie pobiera identyfikator kampanii, nazwę kampanii, zakres dat, liczbę aktywnych twórców i kluczowe dane o skuteczności w przypadku 10 najskuteczniejszych kampanii uszeregowanych według łącznej liczby orders w określonym dniu.

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

Aby przeanalizować skuteczność poszczególnych twórców biorących udział w konkretnej kampanii, wyślij zapytanie do tabeli youtube_individual_campaign_stats_view. Ten widok zawiera zbiorcze dane według twórcy w ramach kampanii, w tym tytuły kanałów, liczbę filmów i tytuły otagowanych produktów.

Użyj tego zapytania MCQL SELECT, aby uzyskać listę 10 najpopularniejszych twórców według wyświetleń w przypadku konkretnej kampanii z 23 kwietnia 2026 r.:

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

To zapytanie pobiera tytuł kanału twórcy, liczbę filmów, tytuły produktów i kluczowe dane o skuteczności w przypadku 10 najlepszych twórców uszeregowanych według łącznej liczby wyświetleń w określonej kampanii i dacie.

Sprawdzanie skuteczności kampanii według filmu

Aby sprawdzić skuteczność konkretnych filmów twórców w kampanii, wyślij zapytanie do youtube_campaign_videos_stats_view. Ten widok zawiera dane o skuteczności poszczególnych filmów twórcy w kampanii, w tym tytuły filmów, formaty filmów i otagowane produkty.

Użyj tego zapytania MCQLSELECT, aby uzyskać 10 najpopularniejszych filmów według liczby wyświetleń w przypadku konkretnego twórcy i kampanii w dniu 20 maja 2026 r.:

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10
    

To zapytanie pobiera tytuł filmu, format filmu (content_type), tytuły otagowanych produktów i kluczowe wskaźniki wydajności dla 10 najpopularniejszych filmów posortowanych według łącznej liczby views dla określonego kanału twórcy, kampanii i daty.

Sprawdzanie skuteczności kampanii według produktu

Aby sprawdzić skuteczność poszczególnych produktów w kampanii, wyślij zapytanie do usługi youtube_campaign_products_stats_view. Ten widok zawiera dane o skuteczności na poziomie produktu w ramach kampanii, w tym tytuły produktów, powiązane szczegóły filmów i dane o sprzedaży.

Użyj tego zapytania MCQLSELECT, aby uzyskać 10 najpopularniejszych produktów w określonej kampanii w dniu 20 czerwca 2026 r.:

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

To zapytanie pobiera tytuł kanału twórcy, tytuł produktu, tytuł filmu, adres URL filmu i kluczowe dane o skuteczności 10 najpopularniejszych produktów uszeregowanych według łącznej liczby views w określonej kampanii i dacie.

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.
• Wymagane filtry: niektóre widoki kampanii wymagają dodatkowych filtrów w klauzuli WHERE:
  • youtube_individual_campaign_stats_view: campaign_id i date.
  • youtube_campaign_videos_stats_view: campaign_id, channel_id i date.
  • youtube_campaign_products_stats_view: campaign_id i date.
• 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.