Statistiken für YouTube-Creator

Mit der Funktion „Creator-Statistiken“ können Sie Statistiken zu YouTube-Creatorn finden und abrufen. Das kann für Agenturen und Werbetreibende nützlich sein, die Creator suchen, die für ihre Zielgruppe relevant sind.

Die API hat vier Hauptfunktionen:

  1. Creator-Auffindbarkeit:Sie können relevante Creator für eine bestimmte Gruppe von Themen, demografischen Merkmalen, Zielgruppen oder Creator-Attributen finden.
  2. Statistiken zu Creator-Themen:Sie können Statistiken zu relevanten Creatorn abrufen, die Inhalte zu bestimmten Themen erstellen.
  3. Creator-Statistiken:Sie können Statistiken zu bestimmten YouTube-Kanälen abrufen, z. B. die Abonnentenzahl, die Anzahl an Aufrufen und die demografischen Merkmale der Zielgruppe.
  4. Statistiken zu Trends:Sie können Statistiken zu bestimmten Trends abrufen, basierend auf bestimmten Zielgruppen oder Themen.

Die Suche nach lokalen Creatorn (Creator, die in einem bestimmten Land ansässig sind oder von dort aus posten und in diesem Land angesehen werden) wird unterstützt, wenn Sie die themenbasierte Suche nach Creatorn oder Statistiken zu Trends verwenden und zusätzliche Daten anfordern.

Voraussetzungen

GenerateCreatorInsights ist eine private Komponente der Google Ads API, die mit einer nicht exklusiven, lizenzgebührenfreien Datenlizenz angeboten wird. Unterzeichnete Partner können die Standard-Google Ads-Clientbibliotheken verwenden, um YouTube-Creator und -Inhalte zu finden. Um berechtigt zu sein, müssen Partner die folgenden Bedingungen erfüllen:

  • Sie müssen ein Planungstool oder eine Benutzeroberfläche haben, in die die Google Ads API integriert wird.
  • Sie müssen die API verwenden, um YouTube-Inhalte und -Creator nach potenziellen Werbemöglichkeiten zu durchsuchen.
  • Sie müssen eine Vorabprüfung durchlaufen, um die Berechtigung zu bestätigen.
  • Sie müssen die Anforderungen an die Datennutzung erfüllen und bereit sein, sich regelmäßigen Datenprüfungen zu unterziehen.
  • Sie müssen eine Datenlizenzvereinbarung unterzeichnen, in der die Anforderungen an die Datennutzung rechtlich durchgesetzt werden.
  • Sie müssen die Nutzungsbedingungen der Google Ads API akzeptieren.

Weitere Informationen erhalten Sie von Ihrem Google-Ansprechpartner.

Creator-Statistiken generieren

Wenn Sie Creator-Statistiken generieren möchten, senden Sie eine Anfrage an die GenerateCreatorInsights Methode. Für diese Methode gilt ein Limit von 5 Abfragen pro Sekunde. Je nachdem, ob Sie Creator finden, relevante Creator nach Themen suchen oder Creator-Statistiken abrufen möchten, sind unterschiedliche Eingaben erforderlich. Sie müssen die Länder angeben, aus denen Sie Daten abrufen möchten.

  1. Creator-Auffindbarkeit:Sie können eine Liste von Zielgruppenattributen angeben, z. B. Alter, Geschlecht und Nutzerinteressen (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen). 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 genau mit den eingegebenen Creator-Attributen übereinstimmen.

    Sie können verfügbare Zielgruppenattribute mit ListAudienceInsightsAttributes, abrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute wünschen, z. B. KNOWLEDGE_GRAPH für Themen von Interesse.

    Ab der Google Ads API v23 können Sie komplexe Beziehungen zwischen Zielgruppenattributen mit audience_combinations angeben. Mit diesem Feld können Sie Zielgruppen mit boolescher Logik (UND/ODER) definieren, was mit audience_attributes nicht möglich ist.

    Während audience_attributes für das Targeting basierend auf einer Liste von vereinigten (mit ODER kombinierten) Attributen geeignet ist (z.B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER ... interessieren), bietet audience_combinations eine detailliertere Steuerung. Jede InsightsAudienceAttributeGroup in audience_combinations kombiniert Attribute mit einem logischen ODER. Diese Gruppen werden dann mit einem logischen UND kombiniert.

    Wenn Sie beispielsweise eine Zielgruppe ansprechen möchten, die sich für „Hautpflege“ ODER „Haarpflege“ UND auch für „Kosmetik“ interessiert, verwenden Sie zwei InsightsAudienceAttributeGroup-Elemente in audience_combinations. „Hautpflege“, „Haarpflege“ und „Kosmetik“ sind Themen von Interesse, die durch Knowledge Graph-Entitäten dargestellt werden (z. B. /m/014trl für Kosmetik). Die erste Gruppe enthält Knowledge Graph-Entitätsattribute für „Hautpflege“ und „Haarpflege“ und die zweite Gruppe das Knowledge Graph-Entitätsattribut für „Kosmetik“.

    Wenn Sie Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen in audience_attributes angeben, können Sie audience_combinations nicht verwenden. Wenn Sie audience_combinations verwenden, müssen Sie diese Attribute in audience_combinations und nicht in audience_attributes angeben. Sie können audience_attributes jedoch weiterhin für andere Attributtypen wie demografische Merkmale in Verbindung mit audience_combinations verwenden.

  2. Statistiken zu Creator-Themen:Geben Sie eine Liste von Inhaltsthemen im Feld search_topics an. Die API gibt relevante Creator zurück, die Inhalte zu den angegebenen Themen erstellen. Die abgerufenen Daten basieren auf dem in country_locations angegebenen Land. Mit dieser Option können Sie nur nach einem Land suchen.

    Unterstützte Entitäten im Feld SearchTopics müssen mit der Funktion CONTENT_TRENDING_INSIGHTS oder CREATOR_TOPIC_INSIGHTS getaggt sein. Verwenden Sie die ListAudienceInsightsAttributes Methode, um unterstützte Entitätsfunktionen abzurufen.

    Hinweis: Die search_brand Option ist ab Version 24.2 veraltet und wird in Version 25 vollständig entfernt. Nutzer sollten stattdessen search_topics verwenden.

  3. Creator-Statistiken: Geben Sie eine Liste von YouTube-Kanal-IDs im search_channels Feld an. Die API gibt Statistiken zu diesen Kanälen zurück.

Zusätzliche Daten und lokale Creator

Standardmäßig werden nur grundlegende Statistiken zurückgegeben. Sie können optionale Funktionen und zusätzliche Daten in Ihrer Antwort anfordern, indem Sie das wiederholte Feld supplemental_data festlegen.

Sie können beispielsweise Daten zu lokalen Creatorn anfordern, indem Sie dem Feld supplemental_data den Enum-Wert LOCAL_CREATOR_DATA hinzufügen. Wenn Sie mit search_topics nach Creatorn suchen und das Thema eine Knowledge Graph-Entität ist, die mit der Funktion CREATOR_TOPIC_INSIGHTS getaggt ist, füllt die API das Feld local_creator_insights in der Antwort mit lokalen Creatorn aus, die zugestimmt haben, ihre Standortdaten zu teilen.

Beachten Sie die folgenden Spezifikationen für die Suche nach lokalen Creatorn:

  • Definition : „Lokale Creator“ sind Creator, die in dem ausgewählten Land ansässig sind oder von dort aus posten und in diesem Land angesehen werden.
  • Einschränkung: Die Suche nach lokalen Creatorn wird nicht unterstützt, wenn sub_country_locations in der Anfrage festgelegt ist.
  • Funktionen: Sie können die Liste der unterstützten Knowledge Graph Entitäten und ihre Funktionen mit ListAudienceInsightsAttributes abrufen.

Die Methode generateCreatorInsights gibt ein GenerateCreatorInsightsResponse-Objekt zurück. Dieses Objekt enthält die folgenden Felder:

  • creator_insights: Eine Liste von YouTubeCreatorInsights-Objekten, die Ihren Hauptkriterien entsprechen.
  • local_creator_insights: Eine Liste von YouTubeCreatorInsights-Objekten für lokale Creator. Dieses Feld wird nur ausgefüllt, wenn LOCAL_CREATOR_DATA angefordert wurde und die verwendeten Kriterien search_topics waren.

Jedes YouTubeCreatorInsights-Objekt enthält die folgenden Informationen zu einem Creator:

  • Name des Creators
  • YouTube-Kanal
  • Gesamtstatistiken für Creator
  • Liste der YouTube-Kanalstatistiken

Das YouTubeMetrics Objekt enthält die folgenden Messwerte:

  • Abonnentenzahl
  • Anzahl der Aufrufe
  • Anzahl von Videos
  • Ist aktiver Shorts-Creator
  • Zusammenarbeit (ab Version 23)

Wenn Sie feststellen möchten, ob ein Creator für Partnerschaften für Original-Markeninhalte infrage kommt, prüfen Sie partnership_opportunities; ein Creator ist berechtigt, wenn die Liste den CREATOR_PARTNERSHIPS Wert enthält.

Das Objekt YouTubeChannelInsights enthält die folgenden Informationen zu einem YouTube-Kanal:

  • Kanalname
  • Kanal-ID
  • Kanal-URL
  • Kanalbeschreibung
  • Kanalstatistiken
  • Zielgruppenattribute des Kanals (z. B. Aufschlüsselung nach Alter, Geschlecht und Nutzerinteressen)
  • Top-Videos
  • Kanaltyp
  • Mit den Kanalinhalten verknüpfte Sprachen
  • Relevanzwert (nur für Suchanfragen zu Trendthemen)

Wenn Sie Statistiken zu Trends generieren möchten, senden Sie eine Anfrage an die GenerateTrendingInsights Methode. Für diese Methode gilt ein Limit von 5 Abfragen pro Sekunde. Je nachdem, ob Sie Zielgruppentrends oder Thementrends abrufen möchten, sind zwei Arten von Eingaben erforderlich. Sie müssen das Land angeben, aus dem Sie Trends abrufen möchten.

  1. Zielgruppentrends:Sie können eine Liste von Zielgruppenattributen angeben, z. B. Alter, Geschlecht und Nutzerinteressen (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen). Die API gibt eine Liste von Statistiken zu Trends für diese Zielgruppen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.

    Sie können verfügbare Zielgruppenattribute mit ListAudienceInsightsAttributes, abrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute wünschen, z. B. KNOWLEDGE_GRAPH für Themen von Interesse.

    KNOWLEDGE_GRAPH-Attribute haben ein oder mehrere InsightsKnowledgeGraphEntityCapabilities Tags. Attribute, die für Statistiken zu Trends unterstützt werden, haben relevante Tags in ihren Antwortmetadaten.

    Entwickler mit Zugriff auf ContentCreatorInsightsService haben auch automatisch Zugriff auf AudienceInsightsService.ListAudienceInsightsAttributes. Für andere Endpunkte in AudienceInsightsService ist ein unabhängiger Zulassungsprozess erforderlich.

    Weitere Informationen zu ListAudienceInsightsAttributes finden Sie im Leitfaden zu Zielgruppeninformationen.

  2. Zielgruppentrends:Sie können eine Liste von Zielgruppenattributen angeben, z. B. Alter, Geschlecht und Nutzerinteressen (einschließlich Zielgruppen mit gemeinsamen Interessen, kaufbereiten Zielgruppen und Zielgruppen mit Lebensereignissen). Die API gibt eine Liste von Statistiken zu Trends für diese Zielgruppen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.

    Sie können verfügbare Zielgruppenattribute mit der ListAudienceInsightsAttributes Methode abrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute wünschen, z. B. KNOWLEDGE_GRAPH für Themen von Interesse.

    Ab der Google Ads API v23 können Sie komplexe Beziehungen zwischen Zielgruppenattributen mit audience_combinations angeben. Mit diesem Feld können Sie Zielgruppen mit boolescher Logik (UND/ODER) definieren, was mit audience_attributes nicht möglich ist.

    Während audience_attributes für das Targeting basierend auf einer Liste von vereinigten (mit ODER kombinierten) Attributen geeignet ist (z.B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER ... interessieren), bietet audience_combinations eine detailliertere Steuerung. Jede InsightsAudienceAttributeGroup in audience_combinations kombiniert Attribute mit einem logischen ODER. Diese Gruppen werden dann mit einem logischen UND kombiniert.

    Wenn Sie beispielsweise eine Zielgruppe ansprechen möchten, die sich für „Hautpflege“ ODER „Haarpflege“ UND auch für „Kosmetik“ interessiert, verwenden Sie zwei InsightsAudienceAttributeGroup-Elemente in audience_combinations. „Hautpflege“, „Haarpflege“ und „Kosmetik“ sind Themen von Interesse, die durch Knowledge Graph-Entitäten dargestellt werden (z. B. /m/014trl für Kosmetik). Die erste Gruppe enthält Knowledge Graph-Entitätsattribute für „Hautpflege“ und „Haarpflege“ und die zweite Gruppe das Knowledge Graph-Entitätsattribut für „Kosmetik“.

    Wenn Sie Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen in audience_attributes angeben, können Sie audience_combinations nicht verwenden. Wenn Sie audience_combinations verwenden, müssen Sie diese Attribute in audience_combinations und nicht in audience_attributes angeben. Sie können audience_attributes jedoch weiterhin für andere Attributtypen wie demografische Merkmale in Verbindung mit audience_combinations verwenden.

  3. Thementrends:Geben Sie eine Liste von Inhaltsthemen an. Die API gibt eine Liste von Statistiken zu Trends für diese Themen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.

Ähnlich wie beim Generieren von Creator-Statistiken können Sie optionale Funktionen in Statistiken zu Trends anfordern, indem Sie das wiederholte Feld supplemental_data auf LOCAL_CREATOR_DATA festlegen.

Wenn in Ihrer Anfrage zu Trends search_topics verwendet wird, wird das related_local_creators Feld in den zurückgegebenen TrendInsight Objekten mit relevanten lokalen Creatorn für das angeforderte Thema gefüllt, die zugestimmt haben, ihre Standortdaten zu teilen. Für die Suche nach lokalen Creatorn gelten dieselbe Definition und dieselben Einschränkungen (z. B. Inkompatibilität mit sub_country_locations).

Zurück
Zielgruppeninformationen