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 diesem Leitfaden 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 Nutzung der APIs des YouTube-Affiliate-Programms und der zugehörigen Daten muss den Entwicklerrichtlinien für YouTube Shopping entsprechen.

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, müssen folgende Voraussetzungen erfüllt sein:

Alpha-Endpunkt abfragen

Da sich diese Funktion in der öffentlichen Alphaversion befindet, unterscheidet sich der Endpunkt. Wenn Sie Leistungsdaten zum YouTube-Affiliate-Programm 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. Hier 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 herausfinden 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 Creator-Titel und Kanal-IDs.

Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die drei Creator mit den höchsten Umsätzen zwischen dem 1. Mai und dem 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

Mit dieser Abfrage werden der Titel des Creators, die Kanal-ID und die wichtigsten Leistungsmesswerte für die drei besten Creator im angegebenen Zeitraum abgerufen, sortiert nach dem Bruttoumsatz.

Leistung nach Inhalt ansehen

Wenn Sie wissen möchten, welche YouTube-Videos am besten abschneiden, können Sie den Bericht youtube_content_performance_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen YouTube-Videos zusammengefasst. Sie enthält Videotitel und ‑IDs. Fügen Sie für Marktplätze account_id hinzu, um die Leistung nach einzelnen Unterkonten von Verkäufern aufzuschlüsseln. Wenn Sie die von Unterverkäufern und der Marktplatzplattform finanzierten Provisionsbeträge sehen möchten, fügen Sie seller_commissions und platform_commissions hinzu.

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

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

Mit dieser Abfrage werden der Videotitel, die Video-ID, die Konto-ID des Unterverkäufers (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 mit der höchsten Gesamtzahl an views im angegebenen Zeitraum abgerufen. 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 du wissen möchtest, welche getaggten Produkte die meisten Interaktionen und Verkäufe erzielen, kannst du 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-SELECT-Anweisung, 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

Mit dieser Abfrage werden die Titel, die Anzahl der getaggten Videos und die wichtigsten Messwerte für die zehn Produkte mit der höchsten Gesamtzahl an views im angegebenen Zeitraum abgerufen.

Leistung nach getaggter Produktkategorie ansehen

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

Verwenden Sie die folgende MCQL-Anweisung (SELECT), um die 10 getaggten Produktkategorien mit dem höchsten Bruttoumsatz am 1. September 2026 abzurufen: 

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

Mit dieser Abfrage werden die Produktkategorie (product_type), die Anzahl der getaggten Creator, die Anzahl der getaggten Videos und die wichtigsten Leistungsmesswerte für die zehn besten Produktkategorien abgerufen, sortiert nach gross_sales am angegebenen Datum.

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-SELECT-Anweisung, mit der Sie die zehn Produkte mit dem höchsten Bruttoumsatz zwischen dem 20. und 21. Januar 2026 abrufen können: 

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

Mit dieser Abfrage werden die Verkaufsdaten, Provisionen und wichtigen Messwerte für die zehn Produkte mit dem höchsten Bruttoumsatz im angegebenen Zeitraum abgerufen.

Leistung aller Kampagnen ansehen

Wenn Sie die Gesamtleistung Ihrer Affiliate-Kampagnen analysieren möchten, fragen Sie die youtube_campaigns_stats_view ab. In dieser Ansicht werden Messwerte für alle Kampagnen zusammengefasst, einschließlich Kampagnennamen, Start- und Enddaten, Anzahl der aktiven Creator sowie Verkaufs- und Interaktionsmesswerte.

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

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

Mit dieser Abfrage werden die Kampagnen-ID, der Kampagnenname, der Zeitraum, die Anzahl der aktiven Creator und die wichtigsten Leistungsmesswerte für die zehn besten Kampagnen abgerufen, sortiert nach der Gesamtzahl der orders am angegebenen Datum.

Kampagnenleistung nach Creator ansehen

Wenn du die Leistung einzelner Creator analysieren möchtest, die an einer bestimmten Kampagne teilnehmen, frage die youtube_individual_campaign_stats_view ab. In dieser Ansicht werden die Messwerte pro Creator innerhalb einer Kampagne zusammengefasst, einschließlich Kanaltiteln, Anzahl der Videos und getaggten Produkttiteln.

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

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

Mit dieser Abfrage werden der Titel des Creator-Kanals, die Anzahl der Videos, die Produkttitel und die wichtigsten Leistungsmesswerte für die zehn besten Creator abgerufen, sortiert nach der Gesamtzahl der Aufrufe innerhalb der angegebenen Kampagne und des angegebenen Datums.

Kampagnenleistung nach Video ansehen

Wenn Sie die Leistung bestimmter Creator-Videos in einer Kampagne sehen möchten, 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 Videotiteln, Videoformaten und getaggten Produkten.

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

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

Mit dieser Abfrage werden der Videotitel, das Videoformat (content_type), die Titel der getaggten Produkte und die wichtigsten Leistungsmesswerte für die zehn Videos mit der höchsten Anzahl an views für den angegebenen Creator-Kanal, die angegebene Kampagne und das angegebene Datum abgerufen.

Kampagnenleistung nach Produkt ansehen

Wenn Sie wissen möchten, wie einzelne Produkte in 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 Produkttiteln, zugehörigen Videodetails und Verkaufsmesswerten.

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

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

Mit dieser Abfrage werden der Titel des Creator-Kanals, der Produkttitel, der Videotitel, die Video-URL und die wichtigsten Leistungsmesswerte für die zehn Produkte mit den meisten views in der angegebenen Kampagne und im angegebenen Zeitraum abgerufen.

Wichtige Hinweise

  • Datumsangaben: Filtern Sie Ihre Abfragen immer nach date und verwenden Sie WHERE-Klauseln, um den Berichtszeitraum anzugeben. Datumsangaben sind im Format YYYY-MM-DD angegeben.
  • 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 Datasets abdecken, dauern länger und können zu Zeitüberschreitungen führen.
Zurück
Explore your competitive landscape
Weiter
Analyze UCP agentic performance (Alpha)