Analyze Youtube Affiliate Performance (Alpha)

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

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:

• Das Konto, mit dem API-Aufrufe authentifiziert werden, hat die Rolle Leistung und Statistiken, die Zugriff auf Leistungsmesswerte gewährt.
• Ihr Google Merchant Center-Konto nimmt am YouTube-Affiliate-Programm teil.

Alpha-Endpunkt abfragen

Da sich der Endpunkt in der öffentlichen Alphaphase befindet, ist er anders. Wenn Sie Leistungsdaten für YouTube-Affiliate-Links abrufen möchten, müssen Sie die POST-Anfrage an den Endpunkt v1alpha senden. Hier ein Beispiel für eine Anfrage:

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

  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' \
  --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 Creatortitel und Kanal-IDs.

Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die drei umsatzstärksten Creator 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

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

Leistung nach Inhalt ansehen

Wenn Sie sehen möchten, welche YouTube-Videos am besten abschneiden, können Sie die youtube_content_performance_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen YouTube-Videos zusammengefasst. Sie enthält Videotitel und ‑IDs.

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

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

Mit dieser Abfrage werden der Videotitel, die Video-ID und die wichtigsten Messwerte für die drei Videos mit der höchsten Gesamtzahl von views im angegebenen Zeitraum abgerufen.

Produkte mit Tags mit den meisten Interaktionen ansehen

Wenn Sie wissen möchten, mit welchen getaggten Produkten am meisten interagiert wird und welche die meisten Verkäufe generieren, 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-SELECT-Anweisung, mit der Sie die 10 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 beliebtesten Produkte abgerufen, die nach der Gesamtzahl der views im angegebenen Zeitraum sortiert sind.

Bestseller ansehen

Wenn Sie wissen möchten, welche Produkte den höchsten Umsatz 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 10 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 wichtigsten Messwerte für die zehn umsatzstärksten Produkte im angegebenen Zeitraum abgerufen.

Wichtige Hinweise

• Datumsangaben: Filtern Sie Ihre Abfragen immer nach date mit WHERE-Klauseln, um den Berichtszeitraum anzugeben. Datumsangaben sind im Format YYYY-MM-DD.
• Latenz: Die Latenz von Abfragen hängt vom angeforderten Datenvolumen ab. Abfragen, die große Datensätze umfassen, dauern länger und können zu Zeitüberschreitungen führen.