Mit der Reporting-Unter-API können Sie wichtige Leistungsmesswerte für Ihre Produkte abrufen, die am YouTube-Affiliate-Programm teilnehmen. In dieser Anleitung wird beschrieben, wie Sie YouTube-spezifische Affiliate-Daten abfragen, z. B. Verkäufe, Provisionen, Bestellungen, Aufrufe und Klicks, die verschiedenen Creatorn, Videoinhalten, einzelnen Produkten und zielgerichteten Kampagnen zugeordnet sind.
Die Verwendung von YouTube-Affiliate-Programm-APIs und zugehörigen Daten muss den Richtlinien für Entwickler*innen von YouTube Shopping entsprechen.
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, müssen folgende Voraussetzungen erfüllt sein:
- Das Konto, mit dem API-Aufrufe authentifiziert werden, hat die Rolle Leistung und Statistiken, die Zugriff auf Leistungsmesswerte gewährt.
- Ihr Google Merchant Center-Konto nimmt am YouTube-Affiliate-Programm teil.
Alpha-Endpunkt abfragen
Da sich diese Funktion in der öffentlichen Alphaphase befindet, unterscheidet sich der Endpunkt. Wenn Sie Leistungsdaten für YouTube-Affiliate-Links abrufen möchten, müssen Sie die POST-Anfrage an den Endpunkt v1alpha senden. Weitere Informationen zum Abrufen von Berichten finden Sie unter accounts.reports.search.
Hier ein Beispiel für eine Anfrage:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "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"
}
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' \
--header 'Content-Type: application/json' \
--data '{
"query": "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"
}' \
--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 der besten Leistung nach Umsatz 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 mit dem höchsten Bruttoumsatz 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.
Wenn Sie die drei Videos mit den meisten Aufrufen zwischen dem 1. und 2. Mai 2025 abrufen möchten, übergeben Sie die folgende MCQL-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 Videotitel, die Video-ID und die wichtigsten Messwerte für die drei Videos mit der höchsten Gesamtzahl von views im angegebenen Zeitraum abgerufen.
Produkte mit Tags mit den meisten Interaktionen ansehen
Wenn Sie wissen möchten, mit welchen getaggten Produkten am meisten interagiert wird und welche die meisten Verkäufe generieren, können Sie die youtube_product_tagged_stats_view abfragen.
In dieser Ansicht werden Messwerte nach einzelnen getaggten Produkten zusammengefasst, einschließlich ihrer Titel und Angebots-IDs.
Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die 10 Produkte mit den meisten Aufrufen zwischen dem 20. und 21. Januar 2026 abrufen 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
Mit dieser Abfrage werden die Titel, die Anzahl der getaggten Videos und die wichtigsten Messwerte für die zehn beliebtesten Produkte abgerufen, die nach der Gesamtzahl der views im angegebenen Zeitraum sortiert sind.
Bestseller ansehen
Wenn Sie wissen möchten, welche Produkte am häufigsten verkauft werden, können Sie die youtube_product_sold_stats_view abfragen.
Hier ist ein Beispiel für eine MCQL-SELECT-Anweisung, mit der Sie die 10 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
Mit dieser Abfrage werden die Verkaufsdaten, Provisionen und wichtigsten Messwerte für die zehn umsatzstärksten Produkte im angegebenen Zeitraum abgerufen.
Leistung aller Kampagnen ansehen
Wenn Sie wissen möchten, wie erfolgreich Ihre Affiliate-Kampagnen insgesamt sind, fragen Sie die youtube_campaigns_stats_view ab.
In dieser Ansicht werden Messwerte für alle Kampagnen zusammengefasst, einschließlich Kampagnennamen, Start- und Enddatum, Anzahl der aktiven Creator sowie Umsatz- und Engagement-Messwerte.
Mit der folgenden MCQL-Anweisung SELECT werden die 10 Kampagnen mit den meisten Bestellungen am 23. April 2026 abgerufen:
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
Mit dieser Abfrage werden die Kampagnen-ID, der Kampagnenname, der Zeitraum, die Anzahl der aktiven Creator und die wichtigsten Leistungsmesswerte für die zehn besten Kampagnen abgerufen, die nach der Gesamtzahl der orders am angegebenen Datum sortiert sind.
Kampagnenleistung nach Creator ansehen
Wenn Sie die Leistung einzelner Creator analysieren möchten, die an einer bestimmten Kampagne teilnehmen, fragen Sie die youtube_individual_campaign_stats_view ab.
In dieser Ansicht werden Messwerte pro Creator innerhalb einer Kampagne zusammengefasst, darunter Kanaltitel, Anzahl der Videos und Titel der getaggten Produkte.
Mit der folgenden MCQL-Anweisung SELECT erhalten Sie die 10 Creator mit den meisten Aufrufen für eine bestimmte Kampagne am 23. April 2026:
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Mit dieser Abfrage werden der Titel des Creator-Kanals, die Anzahl der Videos, die Produkttitel und die wichtigsten Leistungsmesswerte für die 10 Creator mit den meisten Aufrufen in der angegebenen Kampagne und dem angegebenen Zeitraum abgerufen.
Kampagnenleistung nach Video ansehen
Wenn Sie sehen möchten, wie bestimmte Creator-Videos in einer Kampagne abschneiden, fragen Sie youtube_campaign_videos_stats_view ab.
In dieser Ansicht finden Sie Leistungsmesswerte auf Videoebene für einen Creator in einer Kampagne, einschließlich Videotitel, Videoformate und getaggte Produkte.
Mit der folgenden MCQL-Anweisung SELECT erhalten Sie die 10 Videos mit den meisten Aufrufen für einen bestimmten Creator und eine bestimmte Kampagne am 20. Mai 2026:
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
Mit dieser Abfrage werden der Videotitel, das Videoformat (content_type), die Titel der getaggten Produkte und die wichtigsten Leistungsmesswerte für die 10 besten Videos abgerufen, die nach der Gesamtzahl der views für den angegebenen Creator-Kanal, die Kampagne und das Datum sortiert sind.
Kampagnenleistung nach Produkt ansehen
Wenn Sie wissen möchten, wie einzelne Produkte in einer Kampagne abschneiden, fragen Sie die youtube_campaign_products_stats_view ab.
In dieser Ansicht finden Sie Leistungsmesswerte auf Produktebene innerhalb einer Kampagne, einschließlich Produkttitel, zugehöriger Videodetails und Umsatzmesswerte.
Mit der folgenden MCQL-SELECT-Anweisung erhalten Sie die zehn Produkte mit den meisten Aufrufen für eine bestimmte Kampagne am 20. Juni 2026:
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Mit dieser Abfrage werden der Titel des Creator-Kanals, der Produkttitel, der Videotitel, die Video-URL und die wichtigsten Leistungsmesswerte für die 10 Top-Produkte abgerufen, die nach der Gesamtzahl der views in der angegebenen Kampagne und dem angegebenen Datum sortiert sind.
Wichtige Hinweise
- Datumsangaben: Filtern Sie Ihre Abfragen immer nach
datemitWHERE-Klauseln, um den Berichtszeitraum anzugeben. Datumsangaben sind im FormatYYYY-MM-DD. - Erforderliche Filter: Für einige Kampagnenansichten sind zusätzliche Filter in der
WHERE-Klausel erforderlich:youtube_individual_campaign_stats_view:campaign_idunddate.youtube_campaign_videos_stats_view:campaign_id,channel_idunddate.youtube_campaign_products_stats_view:campaign_idunddate.
- Latenz: Die Latenz von Abfragen hängt vom angeforderten Datenvolumen ab. Abfragen, die große Datensätze umfassen, dauern länger und können zu Zeitüberschreitungen führen.