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-Markenstatistiken:Rufe Statistiken zu Creatorn ab, die sich auf eine bestimmte Marke beziehen.
- Creator-Statistiken:Rufe Statistiken zu bestimmten YouTube-Kanälen ab, z. B. die Anzahl der Abonnenten, die Anzahl der Aufrufe und die demografischen Merkmale der Zielgruppe.
- Trendanalysen:Hier können Sie Analysen zu bestimmten Trends abrufen, 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 finden.
Damit Partner berechtigt sind, müssen sie die folgenden Bedingungen erfüllen:
- Sie haben ein Planungstool oder eine Benutzeroberfläche, in die die Google Ads 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.
Auffindbarkeit von Creatorn:Sie können eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Nutzerinteressen (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.
Sie können verfügbare Zielgruppenattribute mit
AudienceInsightsService.ListAudienceInsightsAttributesabrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute benötigen, z. B.KNOWLEDGE_GRAPHfür Themen von Interesse.Ab der Google Ads API v23 können Sie mit
audience_combinationskomplexe Beziehungen zwischen Zielgruppenattributen angeben. In diesem Feld können Sie Zielgruppen mit boolescher Logik (UND/ODER) definieren, was mitaudience_attributesnicht möglich ist.audience_attributeseignet sich für das Targeting auf Grundlage einer Liste von Attributen, die mit OR kombiniert werden (z. B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER … interessieren).audience_combinationsbietet eine genauere Steuerung. JedeInsightsAudienceAttributeGroupinaudience_combinationskombiniert Attribute mit einem logischen ODER. Diese Gruppen werden dann mit einem logischen UND kombiniert.Wenn Sie beispielsweise eine Ausrichtung auf eine Zielgruppe vornehmen möchten, die sich für („Hautpflege“ ODER „Haarpflege“) UND auch für „Kosmetik“ interessiert, verwenden Sie zwei
InsightsAudienceAttributeGroup-Elemente inaudience_combinations. „Hautpflege“, „Haarpflege“ und „Kosmetik“ sind Themen, die durch Knowledge Graph-Entitäten dargestellt werden (z. B./m/014trlfür Kosmetik). Die erste Gruppe würde Knowledge Graph-Entitätsattribute für „Hautpflege“ und „Haarpflege“ enthalten, die zweite Gruppe das Knowledge Graph-Entitätsattribut für „Kosmetik“.Wenn Sie Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen in
audience_attributesangeben, können Sieaudience_combinationsnicht verwenden. Wenn Sieaudience_combinationsverwenden, müssen Sie diese Attribute inaudience_combinationsund nicht inaudience_attributesangeben. Sie könnenaudience_attributesjedoch weiterhin für andere Attributtypen wie demografische Daten in Verbindung mitaudience_combinationsverwenden.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 Objekt YouTubeMetrics enthält die folgenden Messwerte:
- Abonnentenzahl
- Anzahl der Aufrufe
- Anzahl von Videos
- Du bist ein aktiver Shorts-Creator.
- Zusammenarbeit (ab Version 23)
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. Alter, Geschlecht und Nutzerinteresse)
Aufschlüsselung)
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 Nutzerinteressen (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen) bereitstellen. 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.
Sie können verfügbare Zielgruppenattribute mit
AudienceInsightsService.ListAudienceInsightsAttributesabrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute benötigen, z. B.KNOWLEDGE_GRAPHfür Themen von Interesse.Ab der Google Ads API v23 können Sie mit
audience_combinationskomplexe Beziehungen zwischen Zielgruppenattributen angeben. In diesem Feld können Sie Zielgruppen mit boolescher Logik (UND/ODER) definieren, was mitaudience_attributesnicht möglich ist.audience_attributeseignet sich für das Targeting auf Grundlage einer Liste von Attributen, die mit OR kombiniert werden (z. B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER … interessieren).audience_combinationsbietet eine genauere Steuerung. JedeInsightsAudienceAttributeGroupinaudience_combinationskombiniert Attribute mit einem logischen ODER. Diese Gruppen werden dann mit einem logischen UND kombiniert.Wenn Sie beispielsweise eine Ausrichtung auf eine Zielgruppe vornehmen möchten, die sich für („Hautpflege“ ODER „Haarpflege“) UND auch für „Kosmetik“ interessiert, verwenden Sie zwei
InsightsAudienceAttributeGroup-Elemente inaudience_combinations. „Hautpflege“, „Haarpflege“ und „Kosmetik“ sind Themen, die durch Knowledge Graph-Entitäten dargestellt werden (z. B./m/014trlfür Kosmetik). Die erste Gruppe würde Knowledge Graph-Entitätsattribute für „Hautpflege“ und „Haarpflege“ enthalten, die zweite Gruppe das Knowledge Graph-Entitätsattribut für „Kosmetik“.Wenn Sie Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen in
audience_attributesangeben, können Sieaudience_combinationsnicht verwenden. Wenn Sieaudience_combinationsverwenden, müssen Sie diese Attribute inaudience_combinationsund nicht inaudience_attributesangeben. Sie könnenaudience_attributesjedoch weiterhin für andere Attributtypen wie demografische Daten in Verbindung mitaudience_combinationsverwenden.Thementrends:Geben Sie eine Liste mit Inhaltsthemen an. Die API gibt eine Liste mit Trend-Insights für diese Themen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.