Analizowanie wyników programu partnerskiego YouTube (wersja alfa)

Za pomocą podrzędnego interfejsu API do raportowania możesz pobierać kluczowe wskaźniki skuteczności produktów biorących udział w programie partnerskim YouTube. Z tego przewodnika dowiesz się, jak wysyłać zapytania o dane partnerskie charakterystyczne dla 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.

Za pomocą języka zapytań Merchant Center (MCQL) możesz wybierać dane i wymiary z widoków partnerskich charakterystycznych dla YouTube, które w zapytaniach działają jak tabele.

Wymagania wstępne

Zanim zaczniesz korzystać z tego przewodnika, upewnij się, że:

  • konto używane do uwierzytelniania wywołań interfejsu API ma rolę „Skuteczność i statystyki” , która zapewnia dostęp do wskaźników skuteczności;
  • Twoje konto Google Merchant Center bierze udział w programie partnerskim YouTube .

Wysyłanie zapytań do punktu końcowego alfa

Ponieważ ta funkcja jest dostępna w 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. Więcej informacji o pobieraniu raportów znajdziesz w artykule accounts.reports.search. Oto 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

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ład instrukcji MCQL SELECT, której możesz użyć, aby uzyskać 3 najlepszych twórców według 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 kluczowe dane o skuteczności 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 mają 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ć dane o skuteczności według poszczególnych kont podsprzedawców. Aby wyświetlić kwoty prowizji finansowane przez podsprzedawców i platformę handlową, dodaj seller_commissions i platform_commissions.

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,
  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 podsprzedawcy (account_id), łączną kwotę prowizji (commissions), prowizje finansowane przez sprzedawcę (seller_commissions), prowizje finansowane przez platformę (platform_commissions) i inne kluczowe dane o skuteczności 3 najpopularniejszych filmów według łącznej liczby views w określonym zakresie dat. Uwaga: nie możesz używać account_id w klauzuli MCQL WHERE do filtrowania wyników.

Sprawdzanie otagowanych produktów z największym zaangażowaniem

Aby dowiedzieć się, 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 kluczowe dane o skuteczności dla 10 najpopularniejszych produktów według łącznej liczby views w określonym zakresie dat.

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

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

Użyj następującej 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ę produktów (product_type), liczbę otagowanych twórców, liczbę otagowanych filmów i kluczowe wskaźniki skuteczności 10 najpopularniejszych kategorii produktów według gross_sales w określonym dniu.

Sprawdzanie 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 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 kluczowe dane o skuteczności 10 najpopularniejszych produktów według sprzedaży brutto w określonym zakresie dat.

Sprawdzanie skuteczności we wszystkich kampaniach

Aby dowiedzieć się, jak ogólnie radzą sobie 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 o sprzedaży i wskaźnikach zaangażowania.

Użyj tej instrukcji MCQL SELECT aby uzyskać 10 najpopularniejszych kampanii według zamówień 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 wskaźniki skuteczności 10 najpopularniejszych kampanii według łącznej liczby orders w określonym dniu.

Sprawdzanie skuteczności kampanii według twórcy

Aby analizować skuteczność poszczególnych twórców biorących udział w konkretnej kampanii, wyślij zapytanie do youtube_individual_campaign_stats_view. Ten widok agreguje 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ć 10 najpopularniejszych twórców według wyświetleń w konkretnej kampanii 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 10 najpopularniejszych twórców według łącznej liczby wyświetleń w określonej kampanii i dacie.

Sprawdzanie skuteczności kampanii według filmu

Aby sprawdzić, jak radzą sobie konkretne filmy twórców w kampanii, wyślij zapytanie do youtube_campaign_videos_stats_view. Ten widok zawiera wskaźniki skuteczności na poziomie filmu dla twórcy w kampanii, w tym tytuły filmów, formaty filmów i otagowane produkty.

Użyj tej instrukcji MCQL SELECT, aby uzyskać 10 najpopularniejszych filmów według wyświetleń w przypadku konkretnego twórcy i kampanii 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 10 najpopularniejszych filmów według łącznej liczby views w przypadku określonego kanału twórcy, kampanii i daty.

Sprawdzanie skuteczności kampanii według produktu

Aby dowiedzieć się, jak radzą sobie poszczególne produkty w kampanii, wyś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 o sprzedaży.

Użyj tej instrukcji MCQL SELECT, aby uzyskać 10 najpopularniejszych produktów według wyświetleń w 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 10 najpopularniejszych produktów według łącznej liczby views w określonej kampanii i dacie.

Istotne kwestie

  • Daty: zawsze filtruj zapytania według date za pomocą 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.
  • 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.
Wstecz
Explore your competitive landscape
Dalej
Analyze UCP agentic performance (Alpha)