Mit der Funktion „Creator-Statistiken“ können Sie Statistiken 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:Rufe Statistiken zu Creatorn in Bezug auf eine bestimmte Marke ab.
- 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 Standard-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, Markenstatistiken zu Creatorn oder Creator-Statistiken abrufen möchten. Sie müssen die Länder angeben, aus denen Sie Daten abrufen möchten.
- Auffindbarkeit von Creatorn:Sie können eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Interessen (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen) 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.
- Markenstatistiken 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 Channels 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
- Anzahl 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
- Sprachen, die mit den Kanalinhalten verknüpft sind
- Relevanzwert (nur für Suchanfragen zu Thementrends)
Trendstatistiken generieren
Wenn Sie Statistiken zu Trends generieren möchten, senden Sie eine Anfrage an die Methode ContentCreatorInsightsService.GenerateTrendingInsights. Für diese Methode gilt ein Limit von 5 Abfragen pro Sekunde (QPS). Je nachdem, ob Sie Zielgruppen- oder Thementrends abrufen möchten, sind zwei Arten von Eingaben erforderlich.
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 (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen) angeben. Die API gibt eine Liste mit Trend-Insights für diese Zielgruppen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.
- Thementrends:Geben Sie eine Liste mit Inhaltsthemen an. Die API gibt eine Liste mit Trendinformationen für diese Themen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.