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:

Alpha-Endpunkt abfragen

Da sich der Endpunkt in der öffentlichen Alphaphase befindet, ist er anders. Um Leistungsdaten von YouTube-Affiliates abzurufen, müssen Sie die POST-Anfrage an den Endpunkt v1alpha senden. Hier ein Beispiel für eine Anfrage:

HTTP

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

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' \
  --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 Creator mit den höchsten Umsätzen 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.

Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die drei Videos mit den meisten Aufrufen zwischen dem 1. und 2. Mai 2025 abrufen können.

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.

Leistung nach Produkt aufschlüsseln

Wenn Sie die Leistung einzelner Produkte im YouTube-Affiliate-Programm analysieren möchten, können Sie die youtube_product_performance_view abfragen. In dieser Ansicht werden Messwerte nach Produkt aggregiert. Sie enthält Produkttitel und Angebots-IDs.

Hier ist ein Beispiel für eine MCQL SELECT-Anweisung, mit der Sie die drei umsatzstärksten Produkte zwischen dem 1. und 2. Mai 2025 ermitteln können:

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

Mit dieser Abfrage werden der Produkttitel, die Angebots-ID und die Leistungsmesswerte für die drei Produkte mit der besten Leistung zurückgegeben, sortiert nach dem Messwert sales im angegebenen Zeitraum.

Wichtige Aspekte

  • Datumsangaben: Filtern Sie Ihre Abfragen immer nach date, indem Sie WHERE-Klauseln verwenden, um den Berichtszeitraum anzugeben. Datumsangaben sind im Format YYYY-MM-DD.
  • 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.