Statistiche per i creator di YouTube

Scopri e recupera gli insight sui creator di YouTube con la funzionalità di insight sui creator. Questa funzionalità 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 i creator pertinenti per un determinato insieme di argomenti, dati demografici, segmenti di pubblico o attributi dei creator.
  2. Insight sugli argomenti dei creator: recupera gli insight sui creator pertinenti che creano contenuti su argomenti specifici.
  3. Insight sui creator: recupera gli insight su canali YouTube specifici, ad esempio il numero di iscritti, il numero di visualizzazioni e i dati demografici del pubblico.
  4. Insight di tendenza: recupera gli insight su tendenze specifiche, in base a segmenti di pubblico o argomenti specifici.

L'individuazione dei creator locali (trovare i creator che hanno sede in un determinato paese o pubblicano contenuti da quel paese e che vengono visualizzati in quel paese) è supportata quando si utilizza l'individuazione dei creator basata su argomenti o gli insight di tendenza richiedendo dati supplementari.

Requisiti di idoneità

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

  • Avere uno strumento di pianificazione o un'interfaccia utente che integrerà l'API Google Ads.
  • Utilizzare l'API per esplorare i contenuti e i creator di YouTube alla ricerca di potenziali opportunità pubblicitarie.
  • Fare una verifica preliminare per garantire l'idoneità.
  • Rispettare i requisiti di utilizzo dei dati ed essere disposti a sottoporsi a controlli periodici dei dati.
  • Firmare un contratto di licenza dei dati che imponga legalmente i requisiti di utilizzo dei dati.
  • Accettare i Termini di servizio dell'API Google Ads.

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

Generare insight sui creator

Per generare insight sui creator, invia una richiesta al GenerateCreatorInsights metodo. Questo metodo ha un limite di 5 query al secondo (QPS). Accetta diversi tipi di input a seconda che tu voglia eseguire la rilevabilità dei creator, cercare creator pertinenti per argomenti o ottenere insight 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 i 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 dei creator per filtrare i creator i cui contenuti corrispondono specificamente agli attributi dei creator che hai inserito.

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

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

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

    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 conterrebbe gli attributi delle entità del Knowledge Graph per "Cura della pelle" e "Cura dei capelli", mentre il secondo gruppo conterrebbe l'attributo dell'entità del Knowledge Graph per "Cosmetici".

    Tieni presente che se specifichi entità del 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. Insight sugli argomenti dei creator: fornisci un elenco di argomenti dei contenuti utilizzando il search_topics campo. 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 solo un paese.

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

    Nota: l'opzione search_brand è stata ritirata nella v24.2 e rimossa nella v25. Utilizza invece search_topics.

  3. Insight sui creator: fornisci un elenco di ID canale YouTube utilizzando il search_channels campo. L'API restituisce insight su questi canali specifici.

Dati supplementari e creator locali

Per impostazione predefinita, vengono restituiti solo i dati degli insight 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à del Knowledge Graph contrassegnata 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 l'individuazione dei creator locali:

  • Definizione: i "creator locali" sono i creator che hanno sede nel paese selezionato o pubblicano contenuti da quel paese 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à del Knowledge Graph supportate e le 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 di iscritti
  • Numero di visualizzazioni
  • Conteggio video
  • È un creator di Short attivo
  • Opportunità di partnership (a partire dalla v23)

Per verificare se un creator è idoneo per le partnership per i 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 di tendenze degli argomenti)
  • Indica se il creator ha dato il consenso a condividere le metriche non pubbliche

Per generare insight di tendenza, invia una richiesta al GenerateTrendingInsights metodo. Questo metodo ha un limite di 5 query al secondo (QPS). Accetta due tipi di input a seconda che tu voglia ottenere le tendenze del pubblico o le tendenze degli argomenti. Devi fornire la località 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 i segmenti di pubblico di affinità, in-market ed eventi importanti). L'API restituisce un elenco di insight di tendenza per questi segmenti di pubblico, incluse metriche come la variazione percentuale del valore della tendenza nel periodo di confronto.

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

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

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

    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 conterrebbe gli attributi delle entità del Knowledge Graph per "Cura della pelle" e "Cura dei capelli", mentre il secondo gruppo conterrebbe l'attributo dell'entità del Knowledge Graph per "Cosmetici".

    Tieni presente che se specifichi entità del 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ù InsightsKnowledgeGraphEntityCapabilities tag. Gli attributi supportati per gli insight di tendenza avranno tag pertinenti nei metadati della risposta.

    Tieni presente che gli sviluppatori con accesso a ContentCreatorInsightsService avranno anche accesso automatico a AudienceInsightsService.ListAudienceInsightsAttributes. Gli altri endpoint in AudienceInsightsService richiedono una procedura di inclusione nella lista consentita indipendente.

    Ulteriore documentazione su ListAudienceInsightsAttributes è disponibile nella guida di Audience Insights.

  2. Tendenze degli argomenti: fornisci un elenco di argomenti dei contenuti. L'API restituisce un elenco di insight di tendenza per questi argomenti, incluse metriche come la variazione percentuale del valore della tendenza nel periodo di confronto.

Analogamente alla generazione di insight sui creator, puoi richiedere funzionalità facoltative negli insight di tendenza impostando il campo ripetuto supplemental_data su LOCAL_CREATOR_DATA.

Se la richiesta di tendenza utilizza search_topics, il campo related_local_creators degli oggetti TrendInsight restituiti verrà compilato con i creator locali correlati per l'argomento richiesto che hanno acconsentito a condividere i propri dati sulla posizione. L'individuazione dei creator locali è soggetta alla stessa definizione e agli stessi vincoli (ad esempio, è incompatibile con sub_country_locations).

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

  • trend_attribute: l'oggetto AudienceInsightsAttributeMetadata principale per la tendenza.
  • trend_metrics: le metriche per la tendenza, ad esempio la variazione percentuale nel periodo di confronto.
  • trend_data_points: i punti dati storici per la tendenza. Questo campo viene compilato solo per le tendenze che utilizzano search_topics.
  • related_videos: un elenco di AudienceInsightsAttributeMetadata oggetti per i video di tendenza associati all'argomento della tendenza. Questo campo viene compilato solo per le tendenze che utilizzano search_topics. Per questi attributi, viene compilato l'oggetto YouTubeVideoAttributeMetadata nidificato, che contiene i metadati a livello di video (ad esempio l'URL del video, l'URL della miniatura e il numero di visualizzazioni o Mi piace) e i metadati a livello di canale (ad esempio l'ID canale, il nome e l'URL).
Indietro
Statistiche sul pubblico