Analizowanie wyników programu partnerskiego YouTube (wersja alfa)

Za pomocą podrzędnego interfejsu API raportowania 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 programu partnerskiego 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, kategorii produktów i wybranych kampanii.

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

Możesz używać języka zapytań Merchant Center (MCQL), aby wybierać dane i wymiary z dedykowanych widoków programu partnerskiego YouTube, które działają w zapytaniach jak tabele.

Wymagania wstępne

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

Wysyłanie zapytania do punktu końcowego w wersji alfa

Ta funkcja jest dostępna w publicznej wersji alfa, więc 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 artykule accounts.reports.search. Oto przykładowa treść wiadomości:

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

Sprawdzanie 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 agreguje dane według poszczególnych twórców YouTube i zawiera tytuły twórców oraz identyfikatory kanałów.

Oto przykładowa instrukcja MCQL SELECT, której możesz użyć, aby uzyskać listę 3 najlepszych twórców pod względem sprzedaży 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 dla 3 najlepszych twórców według danych o sprzedaży brutto w określonym zakresie dat.

Sprawdzanie skuteczności według treści

Aby sprawdzić, które filmy na YouTube osiągają najlepsze wyniki, możesz wysłać zapytanie do youtube_content_performance_view. Ten widok agreguje dane według poszczególnych filmów na YouTube i zawiera tytuły oraz identyfikatory filmów. W przypadku platform handlowych dodaj account_id, aby podzielić skuteczność według kont poszczególnych sprzedawców. Aby wyświetlić kwoty prowizji finansowane przez podsprzedawców i platformę handlową, uwzględnij seller_commissions i platform_commissions.

Aby pobrać 3 filmy z największą liczbą wyświetleń między 1 a 2 maja 2025 r., przekaż do metody accounts.reports.search to zapytanie MCQL: 

SELECT
  title,
  video_id,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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, identyfikator konta sprzedawcy podrzędnego (account_id), łączną prowizję (commissions), prowizję finansowaną przez sprzedawcę (seller_commissions), prowizję finansowaną przez platformę (platform_commissions) i inne kluczowe dane dotyczące 3 najpopularniejszych filmów uszeregowanych według łącznej liczby views w określonym zakresie dat. Uwaga: nie możesz używać account_id w klauzuli WHERE MCQL do filtrowania wyników.

Wyświetlanie otagowanych produktów, które cieszą się największym zainteresowaniem

Aby dowiedzieć się, które otagowane produkty cieszą się największym zaangażowaniem i generują największą 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 liczby 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 kluczowe dane dotyczące 10 najpopularniejszych produktów uporządkowanych według łącznej liczby views w określonym zakresie dat.

Sprawdzanie skuteczności według kategorii produktów otagowanych

Aby dowiedzieć się, które otagowane kategorie produktów generują największe zaangażowanie i sprzedaż, prześlij zapytanie do youtube_product_category_tagged_stats_view. Ten widok agreguje dane według kategorii produktów (product_type) w mapie kategorii, w tym liczbę różnych twórców i filmów, które otagowały produkty w każdej kategorii.

Użyj tej instrukcji MCQL SELECT, aby uzyskać 10 najpopularniejszych kategorii produktów otagowanych według sprzedaży brutto 1 września 2026 r.: 

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10

To zapytanie pobiera kategorię produktu (product_type), liczbę otagowanych twórców, liczbę otagowanych filmów i kluczowe wskaźniki skuteczności dla 10 najpopularniejszych kategorii produktów uporządkowanych według gross_sales w określonym dniu.

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 MCQL SELECT, której możesz użyć, aby uzyskać 10 najlepszych produktów pod względem sprzedaży brutto w okresie od 20 do 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 kluczowe dane dotyczące 10 najlepszych produktów uporządkowanych według sprzedaży brutto w określonym zakresie dat.

Sprawdzanie skuteczności we wszystkich kampaniach

Aby dowiedzieć się, jaką skuteczność osiągają ogólnie Twoje kampanie partnerskie, wyślij zapytanie do youtube_campaigns_stats_view. Ten widok agreguje dane ze wszystkich kampanii, w tym nazwy kampanii, daty rozpoczęcia i zakończenia, liczbę aktywnych twórców oraz dane dotyczące sprzedaży i wskaźników zaangażowania.

Aby uzyskać listę 10 najlepszych kampanii według zamówień z 23 kwietnia 2026 r., użyj tej instrukcji MCQL SELECT: 

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 wskaźniki skuteczności dla 10 najlepszych kampanii uszeregowanych według łącznej liczby orders w określonym dniu.

Sprawdzanie skuteczności kampanii według twórcy

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

Użyj tej instrukcji MCQL SELECT, aby uzyskać listę 10 najpopularniejszych twórców według liczby wyświetleń w ramach konkretnej kampanii w dniu 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 wskaźniki skuteczności dla 10 najlepszych twórców uszeregowanych według łącznej liczby wyświetleń w ramach określonej kampanii i daty.

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 wskaźniki skuteczności na poziomie filmu dotyczące twórcy w kampanii, w tym tytuły filmów, formaty filmów i otagowane produkty.

Użyj tego zapytania MCQL SELECT, aby uzyskać listę 10 filmów z największą liczbą wyświetleń dla 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 skuteczności dla 10 najpopularniejszych filmów uszeregowanych według łącznej liczby views dla określonego kanału twórcy, kampanii i daty.

Sprawdzanie skuteczności kampanii według produktu

Aby dowiedzieć się, jak skuteczne są poszczególne produkty w kampanii, prześlij zapytanie do youtube_campaign_products_stats_view. Ten widok zawiera wskaźniki skuteczności na poziomie produktu w kampanii, w tym tytuły produktów, powiązane szczegóły filmu i dane dotyczące sprzedaży.

Użyj tej instrukcji MCQL SELECT, aby uzyskać 10 najpopularniejszych produktów według wyświetleń w przypadku konkretnej kampanii 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 wskaźniki skuteczności dla 10 najlepszych produktów uporządkowanych według łącznej liczby views w ramach określonej kampanii i daty.

Istotne kwestie

  • Daty: zawsze filtruj zapytania według pola date, używając klauzul WHERE, aby określić okres raportowania. Daty są 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.
  • Czas oczekiwania: czas oczekiwania na wyniki 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.
Wstecz
Explore your competitive landscape
Dalej
Analyze UCP agentic performance (Alpha)