Mit der Funktion „Statistiken zu Creatorn“ kannst du 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:
- Auffindbarkeit von Creatorn:Hier findest du die Top-Creator für bestimmte Themen, demografische Merkmale, Zielgruppen oder Creator-Attribute.
- Markeninformationen zu Creatorn:Hier findest du Informationen zu Creatorn im Zusammenhang mit einer bestimmten Marke.
- Statistiken für Creator:Hier findest du Statistiken zu bestimmten YouTube-Kanälen, z. B. die Anzahl der Abonnenten, die Anzahl der Aufrufe und die demografischen Merkmale der Zielgruppe.
- Statistiken zu angesagten Themen:Hier findest du Statistiken zu bestimmten Trends, die auf bestimmten Zielgruppen oder Themen basieren.
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 entdecken. Partner müssen die folgenden Voraussetzungen erfüllen:
- Sie haben ein Planungstool oder eine Benutzeroberfläche, in die die API eingebunden werden kann.
- Mit der API kannst du YouTube-Inhalte und -Creator nach potenziellen Werbemöglichkeiten durchsuchen.
- Führen Sie eine Vorabprüfung durch, um die Berechtigung zu prüfen.
- Sie müssen die Anforderungen an die Datennutzung einhalten und sich regelmäßigen Datenprüfungen unterziehen.
- Unterzeichnen Sie eine Datenlizenzvereinbarung, die die Anforderungen an die Datennutzung gesetzlich erzwingt.
- Akzeptieren Sie die Nutzungsbedingungen für die Google Ads API.
Weitere Informationen erhalten Sie von Ihrem Google-Ansprechpartner.
Statistiken zu Creatorn erstellen
Wenn du Statistiken zu Creatorn erstellen möchtest, sende eine Anfrage an die Methode ContentCreatorInsightsService.GenerateCreatorInsights
. Bei dieser Methode sind maximal 5 Abfragen pro Sekunde zulässig. Es gibt drei Eingabetypen, je nachdem, ob du Informationen zur Sichtbarkeit von Creatorn, zu Creator-Marken oder zu Creatorn abrufen möchtest. Sie müssen die Länder angeben, aus denen Sie Daten abrufen möchten.
- Auffindbarkeit von Creatorn:Du kannst eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Interessen angeben. Die API gibt eine Liste von Creatorn zurück, deren Zielgruppen mit diesen Attributen übereinstimmen. Du kannst auch Creator-Attribute angeben, um nach Creatorn zu filtern, deren Inhalte genau mit deinen eingegebenen Creator-Attributen übereinstimmen.
- Statistiken zu Creator-Marken:Gib eine Marke an, um nach Top-Creatorn zu suchen. Die API gibt Statistiken zu ähnlichen Kanälen zurück.
- Statistiken für Creator:Gib eine Liste von YouTube-Kanal-IDs an. Die API gibt Statistiken zu diesen 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
- Du bist ein 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
- Zielgruppenattribute des Kanals (z. B. Alter, Geschlecht und Interessen der Nutzer)
- Top-Videos
- Kanaltyp
Statistiken zu angesagten Inhalten erstellen
Wenn Sie Statistiken zu angesagten Inhalten generieren möchten, senden Sie eine Anfrage an die Methode ContentCreatorInsightsService.GenerateTrendingInsights
. Bei dieser Methode ist die Anzahl der Abfragen pro Sekunde (QPS) auf 5 angesetzt. Es gibt 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 von Zielgruppenattributen angeben, z. B. Alter, Geschlecht und Interessen. Die API gibt eine Liste der angesagten Statistiken für diese Zielgruppen zurück.
- Thementrends:Geben Sie eine Liste von Inhaltsthemen an. Die API gibt eine Liste der angesagten Statistiken zu diesen Themen zurück.