Analyze Youtube Affiliate Performance (Alpha)

Mit der Reporting Sub-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 der Merchant Center Query Language (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, prüfen Sie Folgendes:

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

Alpha-Endpunkt abfragen

Da sich das Produkt 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-SELECTAnweisung, mit der Sie die drei Creator mit der besten Leistung nach Verkäufen zwischen dem 1. und 2. Mai 2025abrufen 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 für den Bruttoumsatz sortiert sind.

Leistung nach Inhalt ansehen

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, übergeben Sie die folgende MCQL-Anweisung an die accounts.reports.search Methode:

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.

Getaggte Produkte mit den meisten Interaktionen ansehen

Wenn Sie wissen möchten, welche getaggten Produkte die meisten Nutzerinteraktionen und ‑bindungen und Verkäufe erzielen, können Sie die Ansicht youtube_product_tagged_stats_view abfragen. In dieser Ansicht werden Messwerte nach einzelnen getaggten Produkten zusammengefasst. Sie enthält auch Titel und Angebots-IDs.

Hier ist ein Beispiel für eine MCQL-SELECTAnweisung, mit der Sie die zehn Produkte mit den meisten Aufrufen zwischen dem 20. und 21. Januar 2026abrufen können:

SELECT
  title,
  offer_id,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10

Diese Abfrage ruft die Titel, die Anzahl der getaggten Videos und die wichtigsten Messwerte für die zehn Produkte ab, die im angegebenen Zeitraum nach der Gesamtzahl der views sortiert sind.

Meistverkaufte Produkte ansehen

Wenn Sie wissen möchten, welche Produkte die meisten Verkäufe erzielen, können Sie die Ansicht youtube_product_sold_stats_view abfragen.

Hier ist ein Beispiel für eine MCQL-SELECTAnweisung, mit der Sie die zehn Produkte mit dem höchsten Bruttoumsatz zwischen dem 20. und 21. Januar 2026 abrufen können:

SELECT
  title,
  offer_id,
  gross_sales,
  net_sales,
  commissions,
  orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10

Diese Abfrage ruft die Verkaufsdaten, Provisionen und wichtigsten Messwerte für die zehn Produkte ab, die im angegebenen Zeitraum nach dem Bruttoumsatz sortiert sind.

Wichtige Hinweise

• Datumsangaben: Filtern Sie Ihre Abfragen immer nach date und geben Sie den Berichtszeitraum mit WHERE Klauseln an. Datumsangaben haben das YYYY-MM-DD Format.
• Latenz: Die Latenz von Abfragen hängt von der Menge der angeforderten Daten ab. Abfragen, die große Datensätze umfassen, dauern länger und können zu Zeitüberschreitungen führen.