YouTube-Affiliate-Leistung analysieren (Alpha)

Mit der Reporting-Sub-API können Sie wichtige Leistungsmesswerte für Ihre Produkte abrufen, die am YouTube-Affiliate-Programm teilnehmen. In dieser Anleitung wird erläutert, wie Sie YouTube-spezifische Affiliate-Daten wie Verkäufe, Provisionen, Bestellungen, Aufrufe und Klicks abfragen, die verschiedenen Creatorn, Videoinhalten, einzelnen Produkten, Produktkategorien und angezielten Kampagnen zugeordnet sind.

Die Verwendung von APIs des YouTube-Affiliate-Programms und zugehörigen Daten muss den Richtlinien für Entwickler des YouTube Shopping-Programmsentsprechen.

Mit der Merchant Center Query Language (MCQL) können Sie Messwerte und Dimensionen aus speziellen YouTube-Affiliate -Ansichten auswählen, die in Ihren Abfragen wie Tabellen funktionieren.

Vorbereitung

Bevor Sie diese Anleitung verwenden, prüfen Sie Folgendes:

Alpha-Endpunkt abfragen

Da sich diese Funktion in der öffentlichen Alpha-Phase befindet, unterscheidet sich der Endpunkt. Wenn Sie Leistungsdaten des YouTube-Affiliate-Programms abrufen möchten, müssen Sie die POST-Anfrage an den Endpunkt v1alpha senden. Weitere Informationen zum Abrufen von Berichten finden Sie unter accounts.reports.search. Ein Beispiel für eine Anfrage:

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

Leistung nach Creator ansehen

Wenn Sie wissen möchten, welche YouTube-Creator die meisten Interaktionen und Verkäufe erzielen, können Sie die youtube_creator_performance_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen YouTube-Creatorn zusammengefasst. Sie enthält auch Creatortitel und Kanal-IDs.

Hier ist ein Beispiel für eine MCQL-SELECT Anweisung, mit der Sie die drei Creator mit der besten Leistung nach Verkäufen zwischen dem 1. und 2. Mai 2025 abrufen können: 

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

Diese Abfrage ruft den Creatortitel, die Kanal-ID und die wichtigsten Leistungsmesswerte für die drei Creator ab, die im angegebenen Zeitraum nach dem Messwert für den Bruttoumsatz eingestuft sind.

Leistung nach Inhalt ansehen

Wenn Sie sehen möchten, welche YouTube-Videos die beste Leistung erzielen, können Sie die youtube_content_performance_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen YouTube-Videos zusammengefasst. Sie enthält auch Videotitel und ‑IDs. Fügen Sie für Marktplätze account_id ein, um die Leistung nach einzelnen Unterverkäufer Konten aufzuschlüsseln. Wenn Sie die Provisionsbeträge sehen möchten, die von Unterverkäufern und der Marktplatzplattform finanziert werden, fügen Sie seller_commissions und platform_commissions ein.

Wenn Sie die drei Videos mit den meisten Aufrufen zwischen dem 1. und 2. Mai 2025, übergeben Sie die folgende MCQL-Anweisung an die accounts.reports.search Methode: 

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

Diese Abfrage ruft den Videotitel, die Video-ID, die Unterverkäuferkonto-ID (account_id), die Gesamtprovisionen (commissions), die vom Verkäufer finanzierten Provisionen (seller_commissions), die von der Plattform finanzierten Provisionen (platform_commissions) und andere wichtige Messwerte für die drei Videos ab, die im angegebenen Zeitraum nach der Gesamtzahl der views eingestuft sind. Hinweis: Sie können account_id nicht in der MCQL WHERE Klausel verwenden, um Ergebnisse zu filtern.

Getaggte Produkte mit den meisten Interaktionen ansehen

Wenn Sie wissen möchten, welche getaggten Produkte die meisten Interaktionen und Verkäufe erzielen, können Sie die youtube_product_tagged_stats_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen getaggten Produkten zusammengefasst, einschließlich ihrer Titel und Angebots-IDs.

Hier ist ein Beispiel für eine MCQL-SELECTAnweisung, mit der Sie die zehn Produkte mit den meisten Aufrufen zwischen dem 20. und 21. Januar 2026 abrufen können: 

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

Diese Abfrage ruft die Titel, die Anzahl der getaggten Videos und die wichtigsten Messwerte für die zehn Produkte ab, die im angegebenen Zeitraum nach der Gesamtzahl der views eingestuft sind.

Leistung nach getaggter Produktkategorie ansehen

Wenn Sie wissen möchten, welche getaggten Produktkategorien die meisten Interaktionen und Verkäufe erzielen, fragen Sie die youtube_product_category_tagged_stats_view ab. In dieser Ansicht werden Messwerte nach Produktkategorie (product_type) in Ihrer Produkttaxonomie zusammengefasst, einschließlich der Anzahl der verschiedenen Creator und Videos, in denen Produkte in jeder Kategorie getaggt wurden.

Verwenden Sie die folgende MCQL-SELECT Anweisung, um die zehn getaggten Produktkategorien abzurufen, die am 1. September 2026 den höchsten Bruttoumsatz erzielt haben: 

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

Diese Abfrage ruft die Produktkategorie (product_type), die Anzahl der getaggten Creator, die Anzahl der getaggten Videos und die wichtigsten Leistungsmesswerte für die zehn Produktkategorien ab, die am angegebenen Datum nach gross_sales eingestuft sind.

Meistverkaufte Produkte ansehen

Wenn Sie wissen möchten, welche Produkte die meisten Verkäufe erzielen, können Sie die youtube_product_sold_stats_view abfragen.

Hier ist ein Beispiel für eine MCQL-SELECTAnweisung, mit der Sie die zehn Produkte abrufen können, die zwischen dem 20. und 21. Januar 2026 den höchsten Bruttoumsatz erzielt haben: 

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

Diese Abfrage ruft die Verkaufsdaten, Provisionen und wichtigsten Messwerte für die zehn Produkte ab, die im angegebenen Zeitraum nach Bruttoumsatz sortiert sind.

Leistung aller Kampagnen ansehen

Wenn Sie wissen möchten, wie Ihre Affiliate-Kampagnen insgesamt abschneiden, fragen Sie die youtube_campaigns_stats_view ab. In dieser Ansicht werden Messwerte für alle Kampagnen zusammengefasst, einschließlich Kampagnen namen, Start- und Enddatum, Anzahl der aktiven Creator sowie Messwerte für Verkäufe und Interaktionen.

Verwenden Sie die folgende MCQL-SELECT Anweisung, um die zehn Kampagnen abzurufen, die am 23. April 2026 die meisten Bestellungen erzielt haben: 

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

Diese Abfrage ruft die Kampagnen-ID, den Kampagnennamen, den Zeitraum, die Anzahl der aktiven Creator und die wichtigsten Leistungsmesswerte für die zehn Kampagnen ab, die am angegebenen Datum nach der Gesamtzahl der orders eingestuft sind.

Kampagnenleistung nach Creator ansehen

Wenn Sie die Leistung einzelner Creator analysieren möchten, die an einer bestimmten Kampagne teilnehmen, fragen Sie die youtube_individual_campaign_stats_view ab. In dieser Ansicht werden Messwerte pro Creator innerhalb einer Kampagne zusammengefasst, einschließlich Kanaltitel, Anzahl der Videos und Titel der getaggten Produkte.

Verwenden Sie die folgende MCQL-SELECT Anweisung, um die zehn Creator abzurufen, die am 23. April 2026 für eine bestimmte Kampagne die meisten Aufrufe erzielt haben: 

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

Diese Abfrage ruft den Titel des Creator-Kanals, die Anzahl der Videos, die Produkt titel und die wichtigsten Leistungsmesswerte für die zehn Creator ab, die innerhalb der angegebenen Kampagne und des angegebenen Datums die meisten Aufrufe erzielt haben.

Kampagnenleistung nach Video ansehen

Wenn Sie sehen möchten, wie bestimmte Creator-Videos innerhalb einer Kampagne abschneiden, fragen Sie die youtube_campaign_videos_stats_view ab. In dieser Ansicht werden Leistungsmesswerte auf Videoebene für einen Creator in einer Kampagne angezeigt, einschließlich Videotitel, Videoformate und getaggte Produkte.

Verwenden Sie die folgende MCQL-SELECT Anweisung, um die zehn Videos abzurufen, die am 20. Mai 2026 für einen bestimmten Creator und eine bestimmte Kampagne die meisten Aufrufe erzielt haben: 

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

Diese Abfrage ruft den Videotitel, das Videoformat (content_type), die Titel der getaggten Produkte und die wichtigsten Leistungsmesswerte für die zehn Videos ab, die für den angegebenen Creator-Kanal, die angegebene Kampagne und das angegebene Datum die meisten views erzielt haben.

Kampagnenleistung nach Produkt ansehen

Wenn Sie wissen möchten, wie einzelne Produkte innerhalb einer Kampagne abschneiden, fragen Sie die youtube_campaign_products_stats_view ab. In dieser Ansicht werden Leistungsmesswerte auf Produktebene innerhalb einer Kampagne angezeigt, einschließlich Produkttitel, zugehörige Videodetails und Umsatzmesswerte.

Verwenden Sie die folgende MCQL-SELECT Anweisung, um die zehn Produkte abzurufen, die am 20. Juni 2026 für eine bestimmte Kampagne die meisten Aufrufe erzielt haben: 

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

Diese Abfrage ruft den Titel des Creator-Kanals, den Produkttitel, den Video Titel, die Video-URL und die wichtigsten Leistungsmesswerte für die zehn Produkte ab, die innerhalb der angegebenen Kampagne und des angegebenen Datums die meisten views erzielt haben.

Wichtige Hinweise

  • Datumsangaben: Filtern Sie Ihre Abfragen immer nach date und geben Sie den Berichtszeitraum mit WHERE Klauseln an. Datumsangaben haben das YYYY-MM-DD Format.
  • Erforderliche Filter: Für einige Kampagnenansichten sind zusätzliche Filter in der WHERE Klausel erforderlich:
    • youtube_individual_campaign_stats_view: campaign_id und date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id und date.
    • youtube_campaign_products_stats_view: campaign_id und date.
  • Latenz: Die Latenz von Abfragen hängt von der Menge der angeforderten Daten ab. Abfragen, die große Datensätze umfassen, dauern länger und können zu Zeitüberschreitungen führen.
Zurück
Explore your competitive landscape
Weiter
Analyze UCP agentic performance (Alpha)