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:Hier können Sie relevante Creator für eine bestimmte Gruppe von Themen, demografischen Merkmalen, Zielgruppen oder Creator-Attributen finden.
  2. Statistiken zu Creator-Themen:Hier können Sie Statistiken zu relevanten Creatorn abrufen, die Inhalte zu bestimmten Themen erstellen.
  3. Creator-Statistiken:Hier können Sie Statistiken zu bestimmten YouTube-Kanälen abrufen, z. B. die Abonnentenzahl, die Anzahl an Aufrufen und demografische Daten zur Zielgruppe.
  4. Trendstatistiken:Hier können Sie Statistiken zu bestimmten Trends abrufen, basierend auf bestimmten Zielgruppen oder Themen.

Die lokale Suche nach Creatorn (Suche nach Creatorn, die in einem bestimmten Land ansässig sind oder von dort aus posten und deren Inhalte in diesem Land angesehen werden) wird unterstützt, wenn Sie zusätzliche Daten anfordern, um nach Themen zu suchen oder Trendstatistiken zu erhalten.

Voraussetzungen

GenerateCreatorInsights ist eine private Komponente der Google Ads API, die mit einer nicht exklusiven, lizenzgebührenfreien Datenlizenz angeboten wird. Registrierte 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 eingebunden 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 nach Creatorn suchen, 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 von Ihnen 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 mit audience_combinations komplexe Beziehungen zwischen Zielgruppenattributen angeben. In 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 Attributen geeignet ist, die mit ODER kombiniert werden (z.B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER ... interessieren), bietet audience_combinations eine detailliertere Kontrolle. 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 Attribute der Knowledge Graph-Entität für „Hautpflege“ und „Haarpflege“, die zweite Gruppe das Attribut der Knowledge Graph-Entität für „Kosmetik“.

    Wenn Sie in audience_attributes Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen 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 Land, das in country_locations angegeben ist. Mit dieser Option können Sie nur in 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 Option search_brand wurde in Version 24.2 eingestellt und in Version 25 entfernt. Verwenden Sie search_topics stattdessen.

  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 lokale Creator-Daten 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 deren Inhalte 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 ihrer 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 Statistiken für YouTube-Kanäle

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 prüfen möchten, ob ein Creator für Partnerschaften für Original-Markeninhalte infrage kommt, sehen Sie sich partnership_opportunities an. 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
  • Messwerte für deinen Kanal
  • 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 Thema-Trends)
  • Ob der Creator zugestimmt hat, nicht öffentliche Messwerte zu teilen

Wenn Sie Trendstatistiken 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 Zielgruppen- oder Thema-Trends abrufen möchten, sind unterschiedliche 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 Trendstatistiken 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.

    Ab der Google Ads API v23 können Sie mit audience_combinations komplexe Beziehungen zwischen Zielgruppenattributen angeben. In 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 Attributen geeignet ist, die mit ODER kombiniert werden (z.B. Nutzer, die sich für „Sport“ ODER „Reisen“ ODER ... interessieren), bietet audience_combinations eine detailliertere Kontrolle. 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 Attribute der Knowledge Graph-Entität für „Hautpflege“ und „Haarpflege“, die zweite Gruppe das Attribut der Knowledge Graph-Entität für „Kosmetik“.

    Wenn Sie in audience_attributes Knowledge Graph-Entitäten, Produkt- und Dienstleistungskategorien oder Nutzerinteressen 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.

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

    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 Audience Insights.

  2. Thematrends:Geben Sie eine Liste von Inhaltsthemen an. Die API gibt eine Liste von Trendstatistiken 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 Trendstatistiken anfordern, indem Sie das wiederholte Feld supplemental_data auf LOCAL_CREATOR_DATA festlegen.

Wenn in Ihrer Trendanfrage 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).

Die GenerateTrendingInsights Methode gibt eine Liste von TrendInsight Objekten zurück, die jeweils Folgendes enthalten:

  • trend_attribute: Die primären AudienceInsightsAttributeMetadata für den Trend.
  • trend_metrics: Die Messwerte für den Trend, z. B. die prozentuale Änderung im Vergleichszeitraum.
  • trend_data_points: Verlaufsdatenpunkte für den Trend. Wird nur für Trends ausgefüllt, bei denen search_topics verwendet wird.
  • related_videos: Eine Liste von AudienceInsightsAttributeMetadata Objekten für Trendvideos, die mit dem Thema des Trends verknüpft sind. Wird nur für Trends ausgefüllt, bei denen search_topics verwendet wird. Für diese Attribute wird das verschachtelte YouTubeVideoAttributeMetadata ausgefüllt, das Metadaten auf Videoebene (z. B. Video-URL, Thumbnail-URL und Anzahl der Aufrufe oder Likes) und Metadaten auf Kanalebene (z. B. Kanal-ID, Name und URL) enthält.
Zurück
Zielgruppeninformationen