Statistiken für YouTube-Creator

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 suchen, die für ihre Zielgruppe relevant sind.

Die API hat vier Hauptfunktionen:

  1. Creator-Sichtbarkeit: Hier finden Sie relevante Creator für eine bestimmte Gruppe von Themen, demografischen Merkmalen, Zielgruppen oder Creator-Attributen.
  2. Creator-Themenstatistiken:Hier können Sie Statistiken zu relevanten Creatorn abrufen, die Inhalte zu bestimmten Themen erstellen.
  3. 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.
  4. Trendanalysen:Sie können Analysen zu bestimmten Trends abrufen, die auf bestimmten Zielgruppen oder Themen basieren.

Die Suche nach lokalen Creatorn (Creatorn, die in einem bestimmten Land ansässig sind oder von dort aus posten und in diesem Land angesehen werden) wird unterstützt, wenn Sie bei der themenbasierten Suche nach Creatorn oder bei Trendanalysen zusätzliche Daten anfordern. Sie können auch Statistiken zur Markenstimmung für themenbasierte Trendstatistiken anfordern, indem Sie zusätzliche Daten anfordern.

Voraussetzungen

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. Um teilnehmen zu können, müssen Partner die folgenden Voraussetzungen erfüllen:

  • Sie haben ein Planungstool oder eine Benutzeroberfläche, in die die Google Ads API integriert wird.
  • Mit der API können Sie YouTube-Inhalte und ‑Creator nach potenziellen Werbemöglichkeiten durchsuchen.
  • Führen Sie eine Vorabprüfung durch, um die Berechtigung zu prüfen.
  • Die Anforderungen an die Datennutzung müssen eingehalten werden und Sie müssen bereit sein, regelmäßige Datenprüfungen durchzuführen.
  • 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 Creator-Statistiken generieren möchten, senden Sie eine Anfrage an die Methode GenerateCreatorInsights. Für diese Methode gilt ein Limit von 5 Abfragen pro Sekunde (Queries per Second, QPS). Je nachdem, ob Sie Creator finden, nach relevanten Creatorn anhand von 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. 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 ListAudienceInsightsAttributes abrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute benötigen, 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.

    audience_attributes eignet 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_combinations bietet eine detailliertere Steuerung. Jedes 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, die durch Knowledge Graph-Entitäten dargestellt werden (z. B. /m/014trl fü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_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 Daten in Verbindung mit audience_combinations verwenden.

  2. Informationen zu Creatorthemen:Gib eine Liste mit Inhaltsthemen über das 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 kann nur nach einem Land gesucht werden.

    Unterstützte Entitäten im Feld SearchTopics müssen entweder mit der Funktion CONTENT_TRENDING_INSIGHTS oder CREATOR_TOPIC_INSIGHTS getaggt werden. Mit der Methode ListAudienceInsightsAttributes können Sie unterstützte Entitätsfunktionen abrufen.

    Hinweis: Die Option search_brand wurde in Version 24.2 eingestellt und in Version 25 entfernt. Verwenden Sie stattdessen search_topics.

  3. Creator-Insights:Gib eine Liste mit YouTube-Kanal‑IDs, YouTube-Kanal-Handles (ab Version 25.2) oder eine Kombination aus beidem über das Feld search_channels an. Die API gibt Statistiken zu diesen spezifischen Channels zurück.

Zusätzliche Daten und lokale Creator

Standardmäßig werden nur Daten zu wichtigen 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 ein Knowledge Graph-Eintrag ist, der mit der Funktion CREATOR_TOPIC_INSIGHTS getaggt ist, wird das Feld local_creator_insights in der Antwort mit lokalen Creatorn gefüllt, die der Weitergabe ihrer Standortdaten zugestimmt haben.

Beachten Sie die folgenden Spezifikationen für die lokale Creator-Suche:

  • Definition: „Lokale Creator“ sind Creator, die ihren Wohnsitz im ausgewählten Land haben oder von dort aus posten und deren Inhalte in diesem Land angesehen werden.
  • Einschränkung:Die lokale Suche nach Creatorn wird nicht unterstützt, wenn sub_country_locations in der Anfrage festgelegt ist.
  • Funktionen:Mit ListAudienceInsightsAttributes können Sie die Liste der unterstützten Knowledge Graph-Entitäten und ihrer Funktionen 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. Wird nur ausgefüllt, wenn LOCAL_CREATOR_DATA angefordert wurde und das verwendete Kriterium search_topics war.

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:

Wenn Sie herausfinden möchten, ob ein Creator für Partnerschaften für originale Markeninhalte infrage kommt, prüfen Sie partnership_opportunities. Ein Creator kommt infrage, wenn die Liste den Wert CREATOR_PARTNERSHIPS enthält.

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

  • Kanalname
  • Kanal-ID
  • Kanal-URL
  • Kanalbeschreibung
  • Kanalmesswerte
  • 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)
  • Gibt an, ob der Creator die Einwilligung zum Teilen nicht öffentlicher Messwerte erteilt hat.

Wenn Sie Statistiken zu Trends generieren möchten, senden Sie eine Anfrage an die Methode 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.

  1. 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) 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.

    Sie können verfügbare Zielgruppenattribute mit ListAudienceInsightsAttributes abrufen. Geben Sie dazu die Dimensionen an, für die Sie Attribute benötigen, z. B. KNOWLEDGE_GRAPH für Interessen.

    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.

    audience_attributes eignet 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_combinations bietet eine detailliertere Steuerung. Jedes 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, die durch Knowledge Graph-Entitäten dargestellt werden (z. B. /m/014trl fü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_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 Daten in Verbindung mit audience_combinations verwenden.

    KNOWLEDGE_GRAPH-Attribute haben ein oder mehrere InsightsKnowledgeGraphEntityCapabilities-Tags. Attribute, die für Trending Insights unterstützt werden, enthalten 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ängiges Verfahren für die Zulassungsliste erforderlich.

    Weitere Informationen zu ListAudienceInsightsAttributes finden Sie im Leitfaden zu Zielgruppeninformationen.

  2. 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. Sie können auch Informationen zur Markenstimmung für Markenthemen anfordern, indem Sie zusätzliche Daten anfordern.

Ä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 oder BRAND_SENTIMENT_DATA festlegen.

Wenn in Ihrer Trendanfrage search_topics verwendet wird, wird durch Festlegen von supplemental_data auf LOCAL_CREATOR_DATA das Feld related_local_creators in den zurückgegebenen TrendInsight-Objekten mit zugehörigen lokalen Creatorn für das angeforderte Thema gefüllt, die der Weitergabe ihrer Standortdaten zugestimmt haben. Die lokale Suche nach Creatorn unterliegt derselben Definition und denselben Einschränkungen (z. B. Inkompatibilität mit sub_country_locations).

Wenn in Ihrer Trendanfrage search_topics verwendet wird, wird durch Festlegen von supplemental_data auf BRAND_SENTIMENT_DATA das Feld brand_sentiment_insights in den zurückgegebenen TrendInsight-Objekten ausgefüllt, wenn das angeforderte Knowledge Graph-Entitätsthema die Funktion BRAND hat. Ein Markenthema ist eine Entität, die mit der Funktion BRAND getaggt ist. Sie können unterstützte Entitätsfunktionen mit der Methode ListAudienceInsightsAttributes abrufen.

Bei der Messung des Stimmungsbilds einer Marke werden KI-Modelle (basierend auf Gemini) verwendet, um YouTube-Videoinhalte im Zusammenhang mit der Marke zu analysieren und die Stimmung als positiv, negativ oder neutral zu kategorisieren. Es werden nur die Videoinhalte selbst analysiert. Nutzerkommentare werden nicht berücksichtigt.

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

  • trend_attribute: Die primäre 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 mit search_topics ausgefüllt.
  • related_videos: Eine Liste von AudienceInsightsAttributeMetadata-Objekten für Trendvideos, die mit dem Thema des Trends in Verbindung stehen. Wird nur für Trends mit search_topics ausgefüllt. Für diese Attribute wird das verschachtelte YouTubeVideoAttributeMetadata ausgefüllt. Es enthält Metadaten auf Videoebene (z. B. die Video-URL, die Thumbnail-URL und die Anzahl der Aufrufe oder Likes) und Metadaten auf Kanalebene (z. B. die Kanal-ID, den Namen und die URL).
  • brand_sentiment_insights: Eine Liste von BrandSentimentInsight-Objekten für den Trend. Wird nur ausgefüllt, wenn in der Trendanfrage search_topics verwendet wird, das Knowledge Graph-Entitätsthema die Funktion BRAND hat und BRAND_SENTIMENT_DATA in supplemental_data angefordert wird. Jedes BrandSentimentInsight-Objekt enthält Folgendes:
    • month: Der Monat, den die Markenstimmung im Format YYYY-MM darstellt.
    • has_insufficient_data: Gibt an, ob nicht genügend Daten vorhanden sind, um die Markenstimmung zu berechnen.
    • sentiment_distributions: Verteilung der Stimmung zwischen positiv, negativ und neutral, berechnet als Anteil der Aufrufe von Videos, die der Marke mit der jeweiligen Stimmung entsprechen.
    • sentiment_summaries: KI-generierte Zusammenfassungen der positiven und negativen Aspekte von Inhalten, die sich auf die Marke beziehen, sowie Beispielvideos für jede Stimmung. Zusammenfassungen werden nur für positive und negative, nicht aber für neutrale Stimmung generiert.
Zurück
Zielgruppeninformationen
Weiter
YouTube-Benchmarks