Statistiche per i creator di YouTube

Scopri e recupera approfondimenti sui creator di YouTube con la funzionalità Approfondimenti sui creator. Questo può essere utile per le agenzie e gli inserzionisti che vogliono trovare creator pertinenti per il loro pubblico di destinazione.

L'API ha quattro funzioni principali:

  1. Rilevabilità dei creator:trova creator pertinenti per un determinato insieme di argomenti, dati demografici, segmenti di pubblico o attributi dei creator.
  2. Approfondimenti sugli argomenti dei creator: recupera approfondimenti sui creator pertinenti che creano contenuti sugli argomenti specificati.
  3. Approfondimenti per i creator:recupera approfondimenti su canali YouTube specifici, come il numero di iscritti, il numero di visualizzazioni e i dati demografici del pubblico.
  4. Insight sulle tendenze:recupera insight su tendenze specifiche, in base a segmenti di pubblico o argomenti specifici.

La scoperta di creator locali (trovare creator che hanno sede o pubblicano contenuti da un determinato paese e che vengono visualizzati in quel paese) è supportata quando si utilizza la scoperta di creator basata su argomenti o gli approfondimenti sulle tendenze richiedendo dati supplementari. Puoi anche richiedere approfondimenti sul sentiment del brand per le tendenze basate su argomenti richiedendo dati supplementari.

Requisiti di idoneità

GenerateCreatorInsights è un componente privato dell'API Google Ads offerto con una licenza per i dati non esclusiva e senza royalty. I partner che hanno firmato un contratto possono utilizzare le librerie client Google Ads standard per esplorare i creator e i contenuti di YouTube. Per essere idonei, i partner devono soddisfare le seguenti condizioni:

  • Disporre di uno strumento di pianificazione o di un'interfaccia utente che integri l'API Google Ads.
  • Utilizza l'API per esplorare i contenuti e i creator di YouTube per individuare potenziali opportunità pubblicitarie.
  • Fai una verifica preliminare per assicurarti di essere idoneo.
  • Rispetta i requisiti di utilizzo dei dati e accetta di sottoporti a controlli periodici dei dati.
  • Firma un contratto di licenza dei dati che imponga legalmente i requisiti di utilizzo dei dati.
  • Accetta i Termini di servizio dell'API Google Ads.

Per saperne di più, contatta il tuo rappresentante di Google.

Generare insight per i creator

Per generare approfondimenti sui creator, invia una richiesta al metodo GenerateCreatorInsights. Questo metodo ha un limite di 5 query al secondo (QPS). Richiede diversi tipi di input a seconda che tu voglia scoprire creator, cercare creator pertinenti per argomenti o ottenere approfondimenti sui creator. Devi fornire le località dei paesi da cui vuoi ottenere i dati.

  1. Rilevabilità dei creator:puoi fornire un elenco di attributi del pubblico, come età, genere e interessi degli utenti (inclusi segmenti di pubblico di affinità, in-market ed eventi importanti). L'API restituisce un elenco di creator i cui segmenti di pubblico corrispondono a questi attributi. Puoi anche fornire attributi del creator per filtrare i creator i cui contenuti corrispondono in modo specifico agli attributi del creator inseriti.

    Puoi recuperare gli attributi del segmento di pubblico disponibili utilizzando ListAudienceInsightsAttributes, fornendo le dimensioni per le quali vuoi gli attributi, ad esempio KNOWLEDGE_GRAPH per gli argomenti di interesse.

    A partire dalla versione 23 dell'API Google Ads, puoi specificare relazioni complesse tra gli attributi del segmento di pubblico utilizzando audience_combinations. Questo campo ti consente di definire i segmenti di pubblico con una logica booleana (AND/OR) che non è possibile con audience_attributes.

    audience_attributes è adatto al targeting basato su un elenco di attributi uniti (combinati con OR), ad esempio utenti interessati a "sport" OR "viaggi" OR …, mentre audience_combinations offre un controllo più granulare. Ogni InsightsAudienceAttributeGroup all'interno di audience_combinations combina gli attributi con un operatore logico OR. Questi gruppi vengono poi combinati con un operatore logico AND.

    Ad esempio, per scegliere come target un pubblico interessato a ("Cura della pelle" OR "Cura dei capelli") AND anche a "Cosmetici", utilizzeresti due elementi InsightsAudienceAttributeGroup in audience_combinations. "Cura della pelle", "Cura dei capelli" e "Cosmetici" sono argomenti di interesse, rappresentati da entità del Knowledge Graph (ad esempio, /m/014trl per Cosmetici). Il primo gruppo conterrà gli attributi delle entità Knowledge Graph per "Cura della pelle" e "Cura dei capelli", mentre il secondo gruppo conterrà l'attributo dell'entità Knowledge Graph per "Cosmetici".

    Tieni presente che se specifichi entità Knowledge Graph, categorie di prodotti e servizi o interessi degli utenti in audience_attributes, non puoi utilizzare audience_combinations. Se utilizzi audience_combinations, devi specificare questi attributi all'interno di audience_combinations e non in audience_attributes; tuttavia, puoi comunque utilizzare audience_attributes per altri tipi di attributi, come i dati demografici, in combinazione con audience_combinations.

  2. Approfondimenti sugli argomenti dei creator: fornisci un elenco di argomenti dei contenuti utilizzando il campo search_topics. L'API restituisce i creator pertinenti che creano contenuti sugli argomenti specificati. I dati recuperati si basano sul paese specificato in country_locations. Tieni presente che questa opzione consente di cercare un solo paese.

    Le entità supportate nel campo SearchTopics devono essere taggate con la funzionalità CONTENT_TRENDING_INSIGHTS o CREATOR_TOPIC_INSIGHTS. Utilizza il metodo ListAudienceInsightsAttributes per recuperare le funzionalità delle entità supportate.

    Nota: l'opzione search_brand è stata ritirata nella versione 24.2 e rimossa nella versione 25. Utilizza invece search_topics.

  3. Approfondimenti per i creator:fornisci un elenco di ID canale YouTube, handle del canale YouTube (a partire dalla versione 25.2) o una combinazione di entrambi utilizzando il campo search_channels. L'API restituisce approfondimenti su questi canali specifici.

Dati supplementari e creator locali

Per impostazione predefinita, vengono restituiti solo i dati degli approfondimenti principali. Puoi richiedere funzionalità facoltative e dati aggiuntivi nella risposta impostando il campo ripetuto supplemental_data.

Ad esempio, puoi richiedere i dati dei creator locali aggiungendo il valore enum LOCAL_CREATOR_DATA al campo supplemental_data. Se cerchi creator utilizzando search_topics (e l'argomento è un'entità Knowledge Graph taggata con la funzionalità CREATOR_TOPIC_INSIGHTS), l'API popolerà il campo local_creator_insights nella risposta con i creator locali che hanno acconsentito a condividere i propri dati sulla posizione.

Tieni presente le seguenti specifiche per la scoperta di creator locali:

  • Definizione: i "creator locali" sono i creator che risiedono o pubblicano contenuti dal paese selezionato e che vengono visualizzati in quel paese.
  • Vincolo: l'individuazione dei creator locali non è supportata quando sub_country_locations è impostato nella richiesta.
  • Funzionalità:puoi recuperare l'elenco delle entità Knowledge Graph supportate e delle relative funzionalità utilizzando ListAudienceInsightsAttributes.

Il metodo generateCreatorInsights restituisce un oggetto GenerateCreatorInsightsResponse. Questo oggetto contiene i seguenti campi:

  • creator_insights: Un elenco di oggetti YouTubeCreatorInsights che corrispondono ai tuoi criteri principali.
  • local_creator_insights: Un elenco di oggetti YouTubeCreatorInsights per i creator locali. Questo campo viene compilato solo se è stato richiesto LOCAL_CREATOR_DATA e i criteri utilizzati erano search_topics.

Ogni oggetto YouTubeCreatorInsights contiene le seguenti informazioni su un creator:

  • Nome creator
  • Canale YouTube
  • Metriche totali dei creator
  • Elenco degli insight del canale YouTube

L'oggetto YouTubeMetrics contiene le seguenti metriche:

  • Numero iscritti
  • Numero di visualizzazioni
  • Conteggio video
  • È un creator di Short attivo
  • Opportunità di partnership (a partire dalla versione 23)

Per verificare se un creator è idoneo per le partnership di contenuti brandizzati originali, controlla partnership_opportunities; un creator è idoneo se l'elenco contiene il valore CREATOR_PARTNERSHIPS.

L'oggetto YouTubeChannelInsights contiene le seguenti informazioni su un canale YouTube:

  • Nome del canale
  • ID canale
  • URL del canale
  • Descrizione del canale
  • Metriche del canale
  • Attributi del pubblico del canale (ad esempio, suddivisione per età, genere e interessi degli utenti)
  • Video principali
  • Tipo di canale
  • Lingue associate ai contenuti del canale
  • Punteggio di pertinenza (solo per le ricerche sulle tendenze degli argomenti)
  • Se il creator ha dato il consenso alla condivisione delle metriche non pubbliche

Per generare approfondimenti sulle tendenze, invia una richiesta al metodo GenerateTrendingInsights. Questo metodo ha un limite di 5 query al secondo (QPS). Richiede due tipi di input a seconda che tu voglia ottenere tendenze del pubblico o tendenze degli argomenti. Devi fornire la posizione specifica del paese da cui vuoi ottenere le tendenze.

  1. Tendenze del pubblico:puoi fornire un elenco di attributi del pubblico, come età, genere e interessi degli utenti (inclusi segmenti di pubblico di affinità, in-market ed eventi importanti). L'API restituisce un elenco di approfondimenti sulle tendenze per questi segmenti di pubblico, incluse metriche come la variazione percentuale del valore della tendenza nel periodo di confronto.

    Puoi recuperare gli attributi del segmento di pubblico disponibili utilizzando ListAudienceInsightsAttributes, fornendo le dimensioni per le quali vuoi gli attributi, ad esempio KNOWLEDGE_GRAPH per gli argomenti di interesse.

    A partire dalla versione 23 dell'API Google Ads, puoi specificare relazioni complesse tra gli attributi del segmento di pubblico utilizzando audience_combinations. Questo campo ti consente di definire i segmenti di pubblico con una logica booleana (AND/OR) che non è possibile con audience_attributes.

    audience_attributes è adatto al targeting basato su un elenco di attributi uniti (combinati con OR), ad esempio utenti interessati a "sport" OR "viaggi" OR …, mentre audience_combinations offre un controllo più granulare. Ogni InsightsAudienceAttributeGroup all'interno di audience_combinations combina gli attributi con un operatore logico OR. Questi gruppi vengono poi combinati con un operatore logico AND.

    Ad esempio, per scegliere come target un pubblico interessato a ("Cura della pelle" OR "Cura dei capelli") AND anche a "Cosmetici", utilizzeresti due elementi InsightsAudienceAttributeGroup in audience_combinations. "Cura della pelle", "Cura dei capelli" e "Cosmetici" sono argomenti di interesse, rappresentati da entità del Knowledge Graph (ad esempio, /m/014trl per Cosmetici). Il primo gruppo conterrà gli attributi delle entità Knowledge Graph per "Cura della pelle" e "Cura dei capelli", mentre il secondo gruppo conterrà l'attributo dell'entità Knowledge Graph per "Cosmetici".

    Tieni presente che se specifichi entità Knowledge Graph, categorie di prodotti e servizi o interessi degli utenti in audience_attributes, non puoi utilizzare audience_combinations. Se utilizzi audience_combinations, devi specificare questi attributi all'interno di audience_combinations e non in audience_attributes; tuttavia, puoi comunque utilizzare audience_attributes per altri tipi di attributi, come i dati demografici, in combinazione con audience_combinations.

    Gli attributi KNOWLEDGE_GRAPH avranno uno o più tag InsightsKnowledgeGraphEntityCapabilities. Gli attributi supportati per gli approfondimenti sulle tendenze avranno tag pertinenti nei metadati della risposta.

    Tieni presente che gli sviluppatori con accesso a ContentCreatorInsightsService avranno anche accesso automatico a AudienceInsightsService.ListAudienceInsightsAttributes. Altri endpoint in AudienceInsightsService richiedono un processo di lista consentita indipendente.

    Ulteriore documentazione su ListAudienceInsightsAttributes è disponibile nella guida alle statistiche sul pubblico.

  2. Tendenze degli argomenti: fornisci un elenco di argomenti dei contenuti. L'API restituisce un elenco di approfondimenti sulle tendenze per questi argomenti, incluse metriche come la variazione percentuale del valore della tendenza nel periodo di confronto. Puoi anche richiedere insight sul sentiment del brand per gli argomenti correlati al brand richiedendo dati supplementari.

Analogamente alla generazione di approfondimenti per i creator, puoi richiedere funzionalità facoltative negli approfondimenti sulle tendenze impostando il campo ripetuto supplemental_data su LOCAL_CREATOR_DATA o BRAND_SENTIMENT_DATA.

Se la tua richiesta di tendenze utilizza search_topics, l'impostazione di supplemental_data su LOCAL_CREATOR_DATA compilerà il campo related_local_creators negli oggetti TrendInsight restituiti con i creator locali correlati all'argomento richiesto che hanno acconsentito a condividere i propri dati sulla posizione. La scoperta di creator locali è soggetta alla stessa definizione e agli stessi vincoli (ad esempio, l'incompatibilità con sub_country_locations).

Se la richiesta di tendenza utilizza search_topics, l'impostazione di supplemental_data su BRAND_SENTIMENT_DATA compilerà il campo brand_sentiment_insights negli oggetti TrendInsight restituiti quando l'argomento dell'entità Knowledge Graph richiesta ha la funzionalità BRAND. Un argomento del brand è un'entità taggata con la funzionalità BRAND. Puoi recuperare le funzionalità delle entità supportate utilizzando il metodo ListAudienceInsightsAttributes.

La misurazione del sentiment del brand prevede l'utilizzo di modelli di AI (basati su Gemini) per analizzare i contenuti dei video di YouTube correlati al brand, classificando il sentiment come positivo, negativo o neutro. Vengono analizzati solo i contenuti video; i commenti degli utenti non sono inclusi.

Il metodo GenerateTrendingInsights restituisce un elenco di oggetti TrendInsight, ognuno dei quali contiene:

  • trend_attribute: il AudienceInsightsAttributeMetadata principale per la tendenza.
  • trend_metrics: le metriche per il trend, ad esempio la variazione percentuale nel periodo di confronto.
  • trend_data_points: Punti dati storici per il trend. Compilato solo per le tendenze che utilizzano search_topics.
  • related_videos: un elenco di oggetti AudienceInsightsAttributeMetadata per i video di tendenza associati all'argomento della tendenza. Compilato solo per le tendenze che utilizzano search_topics. Per questi attributi, viene compilato YouTubeVideoAttributeMetadata, che contiene metadati a livello di video (come l'URL del video, l'URL della miniatura e il numero di visualizzazioni o Mi piace) e metadati a livello di canale (come l'ID, il nome e l'URL del canale).
  • brand_sentiment_insights: un elenco di oggetti BrandSentimentInsight per la tendenza. Viene compilato solo quando la richiesta di tendenza utilizza search_topics, l'argomento dell'entità Knowledge Graph ha la funzionalità BRAND e BRAND_SENTIMENT_DATA viene richiesto in supplemental_data. Ogni oggetto BrandSentimentInsight contiene:
    • month: il mese rappresentato dal sentiment del brand nel formato YYYY-MM.
    • has_insufficient_data: Indica se i dati sono insufficienti per calcolare il sentiment del brand.
    • sentiment_distributions: Distribuzione del sentiment tra positivo, negativo e neutro, calcolata come proporzione di visualizzazioni dei video che corrispondono al brand con ogni sentiment.
    • sentiment_summaries: riepiloghi generati dall'AI di ciò che è stato positivo e negativo nei contenuti correlati al brand, insieme a video di esempio per ogni sentimento. I riepiloghi vengono generati solo per il sentiment positivo e negativo, non per quello neutro.
Indietro
Statistiche sul pubblico
Avanti
Benchmark di YouTube