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 wird erläutert, 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, das zur Authentifizierung von API-Aufrufen verwendet wird, hat die Leistung und Analysen Rolle, die Zugriff auf Leistungsmesswerte gewährt.
• Ihr Google Merchant Center-Konto nimmt am YouTube-Affiliate-Programm teil.

Hinweis: Die Ansichten zur YouTube-Affiliate-Leistung in der Merchant Reports API sind in der Alpha-Version verfügbar. Funktionen und Features können sich ändern und aktualisiert oder eingestellt werden.

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:

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 auch die Titel der Creator und die Kanal-IDs.

Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die drei Creator mit den höchsten 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

Mit dieser Abfrage werden der Titel des Creators, die Kanal-ID und die wichtigsten Leistungsmesswerte für die drei Creator abgerufen, 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 die Titel und IDs der Videos.

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

Mit dieser Abfrage werden der Titel des Videos, die Video-ID und die wichtigsten Messwerte für die drei Videos abgerufen, 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 haben das Format YYYY-MM-DD.
• 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.