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 Statistiken“ 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 Endpunkt v1alpha 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 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 den besten Verkaufszahlen 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 „Bruttoumsatz“ 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 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,
  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

Diese Abfrage ruft den Videotitel, die Video-ID und die wichtigsten Messwerte für die drei Videos ab, die im angegebenen Zeitraum nach der Gesamtzahl der views sortiert sind.

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 von der angeforderten Datenmenge ab. Bei großen Abfragen dauert es länger und es kann zu Zeitüberschreitungen kommen.