Mit der Funktion „Creator-Insights“ können Sie Informationen zu YouTube-Creatorn abrufen. Das kann für Agenturen und Werbetreibende nützlich sein, die Creator finden möchten, die für ihre Zielgruppe relevant sind.
Die API hat vier Hauptfunktionen:
- Creator-Sichtbarkeit:Hier finden Sie die Top-Creator für eine bestimmte Gruppe von Themen, demografischen Merkmalen, Zielgruppen oder Creator-Attributen.
- Creator Brand Insights:Ruft Statistiken zu Creatorn ab, die sich auf eine bestimmte Marke beziehen.
- Creator-Insights:Rufe Statistiken zu bestimmten YouTube-Kanälen ab, z. B. die Anzahl der Abonnenten, die Anzahl der Aufrufe und die demografischen Merkmale der Zielgruppe.
- Trending Insights:Hier können Sie sich Statistiken zu bestimmten Trends basierend auf bestimmten Zielgruppen oder Themen ansehen.
Voraussetzungen
ContentCreatorInsightsService.GenerateCreatorInsights
ist eine private Komponente der Google Ads API, die mit einer nicht exklusiven, gebührenfreien Datenlizenz angeboten wird. Unterzeichnete Partner können die standardmäßigen Google Ads-Clientbibliotheken verwenden, um YouTube-Creator und ‑Inhalte zu finden. Damit Partner berechtigt sind, müssen sie die folgenden Bedingungen erfüllen:
- Sie haben ein Planungstool oder eine Benutzeroberfläche, in die die API eingebunden wird.
- Mit der API können Sie YouTube-Inhalte und ‑Creator nach potenziellen Werbemöglichkeiten durchsuchen.
- Führen Sie eine Vorabprüfung durch, um sicherzustellen, dass Sie die Voraussetzungen erfüllen.
- Sie müssen die Anforderungen an die Datennutzung einhalten und bereit sein, sich regelmäßigen Datenprüfungen zu unterziehen.
- Unterzeichnen Sie eine Datenlizenzvereinbarung, die die Anforderungen an die Datennutzung rechtlich durchsetzt.
- Akzeptieren Sie die Nutzungsbedingungen für die Google Ads API.
Weitere Informationen erhalten Sie von Ihrem Google-Ansprechpartner.
Statistiken zu Creatorn generieren
Wenn Sie Statistiken für Creator generieren möchten, senden Sie eine Anfrage an die Methode ContentCreatorInsightsService.GenerateCreatorInsights
. Diese Methode hat ein Limit von 5 Abfragen pro Sekunde (QPS) und erfordert drei Arten von Eingaben, je nachdem, ob Sie die Auffindbarkeit von Creatorn, Creator-Markenstatistiken oder Creator-Statistiken abrufen möchten. Sie müssen die Länder angeben, aus denen Sie Daten abrufen möchten.
- Creator-Sichtbarkeit:Sie können eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Interessen angeben. Die API gibt eine Liste von Creatorn zurück, deren Zielgruppen diesen Attributen entsprechen. Sie können auch Creator-Attribute angeben, um nach Creatorn zu filtern, deren Inhalte Ihren eingegebenen Creator-Attributen entsprechen.
- Marken-Insights für Creator:Geben Sie eine Marke ein, um nach Top-Creatorn zu suchen. Die API gibt Statistiken zu übereinstimmenden Channels zurück.
- Creator Insights:Gib eine Liste mit YouTube-Kanal-IDs an. Die API gibt Statistiken zu diesen spezifischen Kanälen zurück.
Die generateCreatorInsights
-Methode gibt ein GenerateCreatorInsightsResponse
-Objekt zurück. Dieses Objekt enthält eine Liste von YouTubeCreatorInsights
-Objekten. Jedes YouTubeCreatorInsights
-Objekt enthält die folgenden Informationen zu einem Creator:
- Name des Creators
- YouTube-Kanal
- Messwerte für Creator insgesamt
- Liste der YouTube-Kanalstatistiken
Das YouTubeMetrics
-Objekt enthält die folgenden Messwerte:
- Abonnentenzahl
- Zahl der Aufrufe
- Anzahl von Videos
- Aktiver Shorts-Creator
Das YouTubeChannelInsights
-Objekt enthält die folgenden Informationen zu einem YouTube-Kanal:
- Kanalname
- Kanal-ID
- Kanal-URL
- Kanalbeschreibung
- Messwerte für deinen Kanal
- Attribute der Kanalzielgruppe (z. B. Aufschlüsselung nach Alter, Geschlecht und Nutzerinteresse)
- Top-Videos
- Kanaltyp
Trendstatistiken generieren
Wenn Sie Statistiken zu Trends generieren möchten, senden Sie eine Anfrage an die Methode ContentCreatorInsightsService.GenerateTrendingInsights
. Diese Methode hat ein Limit von 5 Abfragen pro Sekunde (QPS) und erfordert zwei Arten von Eingaben, je nachdem, ob Sie Zielgruppen- oder Thementrends abrufen möchten.
Sie müssen das Land angeben, aus dem Sie Trends abrufen möchten.
- Zielgruppentrends:Sie können eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Interessen angeben. Die API gibt eine Liste mit Trend-Insights für diese Zielgruppen zurück.
- Thementrends:Geben Sie eine Liste mit Inhaltsthemen an. Die API gibt eine Liste mit aktuellen Statistiken zu diesen Themen zurück.