Statistiken für YouTube-Creator

Mit der Funktion „Creator-Statistiken“ in ContentCreatorInsightsService können Sie YouTube-Creator finden und Statistiken zu ihnen abrufen. Dieser Dienst hilft Agenturen und Werbetreibenden, Creator zu finden, die für ihre Zielgruppe relevant sind.

Die API hat vier Hauptfunktionen:

  1. Auffindbarkeit von Creatorn: Hier finden Sie relevante Creator für bestimmte Themen, demografische Merkmale, Zielgruppen oder Creator-Attribute.
  2. Creator-Themenstatistiken: Hier erhalten Sie Statistiken zu relevanten Creatorn, die Inhalte zu bestimmten Themen erstellen.
  3. Creator-Statistiken: Hier finden Sie Statistiken zu bestimmten YouTube-Kanälen, z. B. Abonnentenzahl, Anzahl der Aufrufe und demografische Merkmale der Zielgruppe.
  4. Trendstatistiken: Rufen Sie Statistiken zu bestimmten Trends ab, basierend auf bestimmten Zielgruppen oder Themen.

Die lokale Creator-Suche (Suche nach 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 die themenbasierte Creator-Suche oder Trending Insights verwenden und zusätzliche Daten anfordern. Sie können auch Statistiken zur Markenstimmung für themenbasierte Trendstatistiken anfordern, indem Sie zusätzliche Daten anfordern.

Teilnahmevoraussetzungen

GenerateCreatorInsights ist eine private Komponente der Google Ads API, die mit einer nicht exklusiven, gebührenfreien Datenlizenz angeboten wird. Registrierte 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 eingebunden ist.
  • Mit der API können Sie YouTube-Inhalte und -Creator auf potenzielle Werbemöglichkeiten hin untersuchen.
  • Führen Sie eine Vorabprüfung durch, um die Berechtigung zu bestätigen.
  • Anforderungen an die Datennutzung einhalten und sich regelmäßigen Datenprüfungen unterziehen.
  • Akzeptieren Sie die Nutzungsbedingungen der Google Ads API und die zugehörige Richtlinie zur Datennutzung.

Weitere Informationen erhalten Sie von Ihrer Google-Kontaktperson.

Statistiken zu Creatorn generieren

Senden Sie eine Anfrage an die Methode GenerateCreatorInsights, um Creator-Statistiken zu generieren. Diese Methode hat ein Limit von 5 Abfragen pro Sekunde (QPS). Je nachdem, ob Sie Creator-Auffindbarkeit, themenbasierte Creator-Suche oder kanalspezifische Creator-Insights wünschen, werden unterschiedliche Kriterien akzeptiert. Sie müssen die Standorte des Ziellandes in country_locations angeben.

  1. Creator-Sichtbarkeit (search_attributes): Geben Sie im Feld search_attributes eine Liste mit Zielgruppenattributen wie Alter, Geschlecht und Nutzerinteressen (Zielgruppen mit gemeinsamen Interessen, kaufbereite Zielgruppen und Zielgruppen mit Lebensereignissen) an, um Creator zu finden, deren Zielgruppen diesen Attributen entsprechen. Sie können auch Creator-Attribute angeben, um nach Creatorn zu filtern, deren Inhalte bestimmten Attributen entsprechen.

    Rufen Sie verfügbare Zielgruppenattribute mit ListAudienceInsightsAttributes ab, indem Sie die erforderlichen Dimensionen angeben, z. B. KNOWLEDGE_GRAPH für relevante Themen. Wenn Sie Attribute mithilfe der booleschen Gruppen AND und OR kombinieren möchten, verwenden Sie audience_combinations, wie unter Komplexe Zielgruppenkombinationen beschrieben.

  2. Themenstatistiken für Creator (search_topics): Geben Sie im Feld search_topics eine Liste mit Inhaltsthemen an. Die API gibt relevante Creator zurück, die Inhalte zu den angegebenen Themen erstellen. Die Daten werden für das in country_locations angegebene Land abgerufen. Diese Option unterstützt ein einzelnes Land pro Anfrage.

    Unterstützte Entitäten in search_topics müssen entweder mit der Funktion CONTENT_TRENDING_INSIGHTS oder CREATOR_TOPIC_INSIGHTS getaggt sein. Verwenden Sie ListAudienceInsightsAttributes, um unterstützte Entitätsfunktionen abzurufen.

  3. Creator-Statistiken (search_channels): Geben Sie im Feld search_channels eine Liste mit YouTube-Kanal-IDs, YouTube-Kanal-Aliassen (youtube_channel_handles, verfügbar ab v25) oder einer Kombination aus beidem an. Die API gibt Statistiken zu diesen spezifischen Kanälen zurück.

Komplexe Zielgruppenkombinationen

Sowohl in GenerateCreatorInsights als auch in GenerateTrendingInsights können Sie komplexe Beziehungen zwischen Zielgruppenattributen mit audience_combinations definieren. In diesem Feld können Sie Zielgruppenattribute mit boolescher Logik (AND und OR) kombinieren, die über das Verhalten der flachen Vereinigung (OR) von audience_attributes hinausgeht:

  • Jedes InsightsAudienceAttributeGroup innerhalb von audience_combinations kombiniert seine Attribute mit einem logischen OR.
  • Mehrere InsightsAudienceAttributeGroup-Elemente in audience_combinations werden mit einem logischen AND kombiniert.

Wenn Sie beispielsweise eine Zielgruppe ansprechen möchten, die sich für ("Skin care" OR "Hair care") AND "Cosmetics" interessiert, fügen Sie zwei InsightsAudienceAttributeGroup-Elemente in audience_combinations ein:

  1. Gruppe 1 mit den Knowledge Graph-Entitätsattributen für "Skin care" und "Hair care".
  2. Gruppe 2 mit dem Knowledge Graph-Entitätsattribut für "Cosmetics" (z. B. /m/014trl).

Ergänzende Daten und lokale Creator

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

Sie können beispielsweise lokale Creator-Daten anfordern, indem Sie den Enum-Wert LOCAL_CREATOR_DATA zu supplemental_data hinzufügen. Wenn du mit search_topics nach Creatorn suchst (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, die der Weitergabe ihrer Standortdaten zugestimmt haben.

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

  • Definition: Lokale Creator sind Creator, die im ausgewählten Land ansässig sind oder von dort aus posten und deren Inhalte in diesem Land angesehen werden.
  • Einschränkung: Die lokale Creator-Suche 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 mit den folgenden Feldern zurück:

  • creator_insights: Eine Liste von YouTubeCreatorInsights-Objekten, die Ihren Hauptkriterien entsprechen.
  • local_creator_insights: Eine Liste von YouTubeCreatorInsights-Objekten für lokale Ersteller. Dieses Feld wird nur ausgefüllt, wenn LOCAL_CREATOR_DATA angefordert wurde und das verwendete Kriterium search_topics war.

Jedes YouTubeCreatorInsights-Objekt enthält:

  • creator_name: Der Name des Erstellers.
  • creator_channels: Eine Liste von YouTubeChannelInsights-Objekten. Kanaldetails und channel_metrics (YouTubeMetrics) werden in jedem YouTubeChannelInsights-Objekt in creator_channels zurückgegeben.

Das Objekt YouTubeMetrics enthält Folgendes:

  • Anzahl der Abonnenten, Aufrufe und Videos
  • Gesamtzahl der „Mag ich“-Bewertungen, geteilten Inhalte und Kommentare für alle Videos des Kanals
  • Engagement-Rate in Lifetime (Gesamt-Engagement geteilt durch Gesamtaufrufe)
  • Durchschnittliche Anzahl der Aufrufe, Likes, geteilten Inhalte und Kommentare pro Video in den letzten 28 Tagen
  • Shorts-Aufrufe und Videoanzahl
  • Ob der Creator ein aktiver Shorts-Creator oder ein aktiver Livestream-Creator ist (hat in den letzten 90 Tagen einen veröffentlicht)
  • Partnerschaftsmöglichkeiten

Interaktionsrate und durchschnittliche Aufrufe, Likes und Kommentare pro Video sind nicht öffentliche Messwerte, die nur angezeigt werden, wenn der Creator der Freigabe zugestimmt hat.

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

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

  • Kanalname, ID, Alias, URL, Beschreibung und Thumbnail-URL
  • Erstellungsdatum des Kanals und zugehöriges Land
  • Kanalmesswerte
  • Attribute der Kanalzielgruppe (z. B. Alter, Geschlecht und Aufschlüsselung der Nutzerinteressen)
  • Kanalattribute (die mit den Inhalten des Kanals verknüpften Attribute)
  • Top-Videos
  • Kanaltyp und Inhaltssprachen
  • Relevanzwert (nur für Trendthemen-Suchanfragen)
  • Ob der Creator seine Einwilligung zur Weitergabe nicht öffentlicher Messwerte gegeben hat

Referenz zu GenerateCreatorInsights-Anfragen und -Antworten

Rufen Sie GenerateCreatorInsights für ContentCreatorInsightsService am folgenden Endpunkt auf:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

In der folgenden Tabelle sind die Felder in GenerateCreatorInsightsRequest zusammengefasst:

Feldpfad Anforderung Format und Einschränkungen
customer_id Erforderlich Zehnstellige Kundennummer (string) ohne Bindestriche.
customer_insights_group Erforderlich Benutzerdefinierter Name (string) des Kunden oder der Marke, für den bzw. die geplant wird.
country_locations[] Erforderlich Liste der LocationInfo-Objekte für Länder (geo_target_constant, z. B. "geoTargetConstants/2840"). Muss ein einzelnes Land enthalten, wenn search_topics verwendet wird.
sub_country_locations[] Optional Filter für untergeordnete Länder LocationInfo; werden nur mit search_attributes unterstützt und sind nicht mit LOCAL_CREATOR_DATA kompatibel.
search_attributes criteria (oneof) SearchAttributes mit:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (plus user_interest, entity oder category, wenn audience_combinations nicht verwendet wird).
• audience_combinations[]: UND-von-ODER-Elemente (InsightsAudienceAttributeGroup).
• creator_attributes[]: Knowledge Graph-entity-Elemente mit der Funktion CREATOR_ATTRIBUTE.
search_topics criteria (oneof) SearchTopics mit entities[] (AudienceInsightsEntity mit knowledge_graph_machine_id, getaggt mit CREATOR_TOPIC_INSIGHTS oder CONTENT_TRENDING_INSIGHTS).
search_channels criteria (oneof) YouTubeChannels mit youtube_channels[] (channel_id) und/oder youtube_channel_handles[] (Handles, die mit @ beginnen, z. B. "@youtubecreators").
supplemental_data[] Optional ContentCreatorInsightsSupplementalData-Werte. Legen Sie LOCAL_CREATOR_DATA für eine search_topics-Anfrage für ein einzelnes Land (für Entitäten mit CREATOR_TOPIC_INSIGHTS) fest, um local_creator_insights[] zu füllen.
insights_application_info Optional AdditionalApplicationInfo-Metadaten zur Anwendung, die die Anfrage stellt.

Die Nachricht GenerateCreatorInsightsResponse gibt die folgenden Felder zurück:

Antwortfeld Typ Beschreibung
creator_insights[] YouTubeCreatorInsights Creator, die deinen Hauptkriterien (creator_name und creator_channels[]) entsprechen.
local_creator_insights[] YouTubeCreatorInsights Lokale Ersteller, die der Weitergabe von Standortdaten zugestimmt haben (wird ausgefüllt, wenn LOCAL_CREATOR_DATA mit search_topics für eine Entität mit CREATOR_TOPIC_INSIGHTS angefordert wird).
creator_channels[] YouTubeChannelInsights Metadaten: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location und data_sharing_consent_given.
Statistiken und Inhalte: channel_audience_attributes[] (nur mit Einwilligung), channel_attributes[], top_videos[], language_distributions[], relevance_score (nur für GenerateTrendingInsights mit search_topics ausgefüllt) und channel_metrics.
channel_metrics YouTubeMetrics Öffentliche Messwerte: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator und partnership_opportunities[].
Messwerte, die eine Einwilligung erfordern: engagement_rate und 28-Tage-Durchschnittswerte pro Video (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

GenerateCreatorInsights-REST-Anfrage- und -Antwortbeispiele

Im folgenden Beispiel werden Creator mit searchAttributes mit dem demografischen Merkmal audienceAttributes, dem booleschen Wert audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") und creatorAttributes ermittelt:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

Wenn Sie themenbasierte Creator zusammen mit lokalen Creatorn abrufen möchten, verwenden Sie searchTopics und fügen Sie "LOCAL_CREATOR_DATA" in supplementalData ein:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

Wenn Sie Statistiken für bestimmte YouTube-Kanäle nach Kanal-ID oder Alias abrufen möchten, verwenden Sie searchChannels:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

Eine erfolgreiche GenerateCreatorInsightsResponse gibt creatorInsights[] zurück (und localCreatorInsights[], wenn LOCAL_CREATOR_DATA angefordert wird):

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

Wenn Sie Trendstatistiken generieren möchten, senden Sie eine Anfrage an die Methode GenerateTrendingInsights. Diese Methode hat ein Limit von 5 Abfragen pro Sekunde (QPS). Je nachdem, ob Sie Zielgruppen- oder Thementrends abrufen möchten, werden zwei Arten von Eingaben akzeptiert. Außerdem ist ein Zielland erforderlich.

  1. Zielgruppentrends (search_audience): Geben Sie im Feld audience_attributes von search_audience eine Liste von Zielgruppenattributen (z. B. Alter, Geschlecht und Nutzerinteressen) an und verwenden Sie optional audience_combinations, um Attribute mit der booleschen Logik AND/OR zu kombinieren. Die API gibt eine Liste mit Trendstatistiken für diese Zielgruppen zurück, einschließlich Messwerten wie der prozentualen Änderung des Trendwerts im Vergleichszeitraum.

    Entwickler mit Zugriff auf ContentCreatorInsightsService haben automatisch Zugriff auf ListAudienceInsightsAttributes in AudienceInsightsService (siehe Leitfaden zu Zielgruppeninformationen). Andere Endpunkte in AudienceInsightsService erfordern eine separate Zulassungsliste.

  2. Thementrends (search_topics): Geben Sie im Feld search_topics eine Liste von Inhaltsthemen an. Die API gibt Trendstatistiken für diese Themen zurück, einschließlich der prozentualen Änderung des Trendwerts im Vergleichszeitraum. Sie können auch Informationen zu lokalen Creatorn oder zur Markenstimmung anfordern, indem Sie supplemental_data festlegen.

    Die von ListAudienceInsightsAttributes zurückgegebenen KNOWLEDGE_GRAPH-Attribute enthalten ein oder mehrere InsightsKnowledgeGraphEntityCapabilities-Tags. Mit CONTENT_TRENDING_INSIGHTS getaggte Entitäten werden in GenerateTrendingInsights als Themen unterstützt.

Ähnlich wie beim Generieren von Creator-Statistiken können Sie optionale Funktionen in Trendstatistiken anfordern, indem Sie das wiederkehrende Feld supplemental_data auf LOCAL_CREATOR_DATA oder BRAND_SENTIMENT_DATA setzen:

  • Lokale Creator (LOCAL_CREATOR_DATA): Wenn deine Anfrage zu Trends search_topics verwendet (und das Thema eine Knowledge Graph-Entität ist, die mit der Funktion CREATOR_TOPIC_INSIGHTS getaggt ist), wird durch Festlegen von supplemental_data auf LOCAL_CREATOR_DATA das Feld related_local_creators in den zurückgegebenen TrendInsight-Objekten mit ähnlichen lokalen Creatorn gefüllt, die der Weitergabe ihrer Standortdaten zugestimmt haben. Die lokale Creator-Suche ist nicht mit sub_country_locations kompatibel.
  • Markenstimmung (BRAND_SENTIMENT_DATA): Wenn Ihre Trendanfrage search_topics verwendet und das angeforderte Knowledge Graph-Entitätsthema die Funktion BRAND hat, wird durch Festlegen von supplemental_data auf BRAND_SENTIMENT_DATA das Feld brand_sentiment_insights in den zurückgegebenen TrendInsight-Objekten ausgefüllt.

Zur Messung der Markenstimmung werden Gemini-KI-Modelle verwendet, um YouTube-Videoinhalte im Zusammenhang mit der Marke zu analysieren und die Stimmung als positiv, negativ oder neutral zu kategorisieren. Es wird nur der Videoinhalt selbst analysiert, Nutzerkommentare werden nicht berücksichtigt.

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

  • trend_attribute: Der primäre AudienceInsightsAttributeMetadata für den Trend.
  • trend_metrics: Die Messwerte für den Trend, z. B. die prozentuale Änderung im Vergleich zum Vergleichszeitraum.
  • trend: Ein InsightsTrend-Wert (EMERGING, RISING, SUSTAINED oder DECLINING), der die Richtung des Trends angibt. Informationen zur Größe der Änderung finden Sie unter trend_metrics.trend_change_percent.
  • 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 angesagte Videos, die mit dem Thema des Trends verknüpft sind (nur für Trends mit search_topics ausgefüllt). Für diese Attribute wird das verschachtelte YouTubeVideoAttributeMetadata mit Metadaten auf Videoebene (URL, Thumbnail-URL, Anzahl der Aufrufe und „Mag ich“-Bewertungen) und Metadaten auf Kanalebene (Kanal-ID, Name und URL) ausgefüllt.
  • related_creators: Eine Liste von YouTubeCreatorInsights-Objekten für Creator, die mit dem Thema des Trends in Verbindung stehen (nur für Trends mit search_topics ausgefüllt).
  • related_local_creators: Eine Liste von YouTubeCreatorInsights-Objekten für lokale Creator, die sich mit dem Thema des Trends befassen und der Weitergabe ihrer Standortdaten zugestimmt haben. Wird nur ausgefüllt, wenn LOCAL_CREATOR_DATA angefordert wird (siehe Zusätzliche Daten, lokale Creator und Markenstimmung).
  • brand_sentiment_insights: Eine Liste von BrandSentimentInsight-Objekten für den Trend (wird ausgefüllt, wenn die Anfrage search_topics für eine Entität mit der Funktion BRAND verwendet und BRAND_SENTIMENT_DATA anfordert). Jedes BrandSentimentInsight-Objekt enthält:
    • month: Der Monat, für den die Markenstimmung gilt, im Format YYYY-MM.
    • 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 positiver und negativer Themen in Inhalten, die sich auf die Marke beziehen, sowie Beispielvideos für jede Stimmung. Zusammenfassungen werden nur für positive und negative, nicht für neutrale Stimmungen erstellt.

Rufen Sie GenerateTrendingInsights für ContentCreatorInsightsService am folgenden Endpunkt auf:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

In der folgenden Tabelle sind die Felder in GenerateTrendingInsightsRequest zusammengefasst:

Feldpfad Anforderung Format und Einschränkungen
customer_id Erforderlich Zehnstellige Kundennummer (string) ohne Bindestriche.
customer_insights_group Erforderlich Benutzerdefinierter Name (string) des Kunden oder der Marke, für den bzw. die geplant wird.
country_location Erforderlich Einzelnes Land LocationInfo (geo_target_constant, z. B. "geoTargetConstants/2840").
sub_country_locations[] Optional Filter für untergeordnete Länder LocationInfo; nur für search_audience unterstützt und nicht mit LOCAL_CREATOR_DATA kompatibel.
search_audience criteria (oneof) SearchAudience mit:
• audience_attributes[] (erforderlich): age_range, gender, parental_status, income_range (plus user_interest, entity oder category, wenn audience_combinations nicht verwendet wird).
• audience_combinations[] (optional): UND-von-ODER-Attributgruppen.
search_topics criteria (oneof) SearchTopics mit entities[] (AudienceInsightsEntity mit knowledge_graph_machine_id, getaggt mit CONTENT_TRENDING_INSIGHTS).
supplemental_data[] Optional ContentCreatorInsightsSupplementalData-Werte:
• LOCAL_CREATOR_DATA: füllt related_local_creators[] für search_topics-Entitäten mit CREATOR_TOPIC_INSIGHTS.
• BRAND_SENTIMENT_DATA: füllt brand_sentiment_insights[] für search_topics-Entitäten mit BRAND.
insights_application_info Optional AdditionalApplicationInfo-Metadaten zur Anwendung, die die Anfrage stellt.

Die Nachricht GenerateTrendingInsightsResponse gibt TrendInsight-Einträge in trend_insights[] zurück:

Feld TrendInsight Typ Beschreibung
trend_attribute AudienceInsightsAttributeMetadata Primäres Attribut für den Trend (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics Messwerte für den 3-monatigen Vergleichszeitraum (views_count und views_indexed_value für search_topics; audience_share für search_audience; trend_change_percent).
trend InsightsTrend Richtung des Trends (EMERGING, RISING, SUSTAINED oder DECLINING).
trend_data_points[] TrendInsightDataPoint Monatliche Verlaufsdaten (month im Format YYYY-MM und trend_metrics); ausgefüllt für search_topics.
related_videos[] AudienceInsightsAttributeMetadata Angesagte Videos mit YouTubeVideoAttributeMetadata; ausgefüllt für search_topics.
related_creators[] YouTubeCreatorInsights Creator, die mit dem Thema in Verbindung stehen; ausgefüllt für search_topics.
related_local_creators[] YouTubeCreatorInsights Zustimmende lokale Ersteller; wird für search_topics ausgefüllt, wenn LOCAL_CREATOR_DATA für eine Entität mit CREATOR_TOPIC_INSIGHTS angefordert wird.
brand_sentiment_insights[] BrandSentimentInsight Monatliche Markenstimmung (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); wird für search_topics ausgefüllt, wenn BRAND_SENTIMENT_DATA für eine Entität mit der Funktion BRAND angefordert wird.

Im folgenden Beispiel wird GenerateTrendingInsights mit searchTopics für eine Knowledge Graph-Markenentität (/g/11example_brand, getaggt mit CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS und BRAND) aufgerufen und sowohl LOCAL_CREATOR_DATA als auch BRAND_SENTIMENT_DATA angefordert:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

Eine erfolgreiche GenerateTrendingInsightsResponse gibt TrendInsight-Einträge in trendInsights[] zurück:

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Google Issue Tracker

Verwenden Sie den Google Issue Tracker, um Supportfragen zu stellen, Fehler zu melden oder Feature Requests einzureichen. Google verfolgt, priorisiert und veröffentlicht Updates zu Ihren Anfragen direkt im Issue Tracker. Weitere Informationen finden Sie unter Problem im Google Issue Tracker erstellen.

Erstellen Sie ein Problem mit einer der folgenden Issue Tracker-Vorlagen:

Füllen Sie alle Felder in der Vorlage mit detaillierten Informationen aus, damit Google Ihre Anfrage reproduzieren und priorisieren kann. Google schließt unvollständige Meldungen möglicherweise und bittet Sie, ein neues Problem mit den fehlenden Details einzureichen.

Zurück
Zielgruppeninformationen
Weiter
YouTube-Benchmarks