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 Sie Folgendes tun:

• Das Konto, das zur Authentifizierung von API-Aufrufen verwendet wird, muss die Rolle „Leistung und Analysen“ haben, die Zugriff auf Leistungsmesswerte gewährt.
• Ihr Google Merchant Center-Konto muss am YouTube-Affiliate-Programm teilnehmen.

Alpha-Endpunkt abfragen

Da sich die API in der öffentlichen Alpha-Phase befindet, unterscheidet sich der Endpunkt. Wenn Sie Leistungsdaten zum YouTube-Affiliate-Programm abrufen möchten, müssen Sie die POST-Anfrage an den v1alpha Endpunkt senden. 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 aufschlüsseln

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,
  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 Creatortitel, die Kanal-ID und die wichtigsten Leistungsmesswerte für die drei Creator mit der besten Leistung nach dem Messwert „Verkäufe“ im angegebenen Zeitraum abgerufen.

Leistung nach Inhalt aufschlüsseln

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.

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 besten Leistung nach der Gesamtzahl der views im angegebenen Zeitraum abgerufen.

Wichtige Hinweise

• Datumsangaben: Filtern Sie Ihre Abfragen immer nach date und geben Sie mit WHERE-Klauseln den Berichtszeitraum an. Datumsangaben müssen im Format YYYY-MM-DD angegeben werden.
• Latenz: Die Latenz von Abfragen hängt vom Umfang der angeforderten Daten ab. Bei großen Abfragen dauert es länger und es kann zu Zeitüberschreitungen kommen.