Analyze YouTube Affiliate Performance (Alpha)

Mit der Reports 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 wie Verkäufe, Provisionen, Bestellungen, Aufrufe und Klicks abfragen, die verschiedenen Creatorn, Videoinhalten und einzelnen Produkten zugeordnet sind.

Mit 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 von YouTube-Affiliates 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 Creator mit dem höchsten Umsatz zwischen dem 1. und 2. Mai 2025 abrufen können.

SELECT
  title,
  channel_id,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY 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 abgerufen, die nach dem Umsatzmesswert im angegebenen Zeitraum sortiert sind.

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 Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

SELECT
  title,
  video_id,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '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.

Wichtige Aspekte

• Datumsangaben: Filtern Sie Ihre Abfragen immer nach date und geben Sie den Berichtszeitraum mit WHERE-Klauseln an. Datumsangaben werden im Format YYYY-MM-DD angegeben.
• Latenz: Die Latenz von Abfragen hängt vom angeforderten Datenvolumen ab. Große Abfragen dauern länger und können zu Zeitüberschreitungen führen.