Statistiche per i creator di YouTube

Nota: questa funzionalità è in versione beta ed è disponibile solo per gli sviluppatori inclusi nella lista consentita.

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 sulle tendenze: recupera gli insight su tendenze specifiche, in base a segmenti di pubblico o argomenti specifici.

La rilevazione 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 la rilevazione dei creator basata su argomenti o gli insight sulle tendenze 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.
• Eseguire 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 i creator pertinenti per argomenti o ottenere insight sui creator. Devi fornire le località dei paesi da cui vuoi recuperare 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 in modo specifico 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, insieme a 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 taggate 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 a partire dalla v24.2 e verrà rimossa completamente nella release v25. Gli utenti devono passare all'utilizzo di search_topics invece.

3. Insight sui creator: fornisci un elenco di ID dei canali 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 di 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 di enumerazione LOCAL_CREATOR_DATA al campo supplemental_data. Se stai cercando i creator utilizzando search_topics (e l'argomento è un'entità del 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 rilevazione 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: la rilevazione 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][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 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 di tendenze degli argomenti)

Generare insight sulle tendenze

Per generare insight sulle tendenze, 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 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 pubblico disponibili utilizzando ListAudienceInsightsAttributes, fornendo le dimensioni per le quali vuoi gli attributi, ad esempio KNOWLEDGE_GRAPHper gli argomenti di interesse.

   Gli attributi KNOWLEDGE_GRAPH avranno uno o più InsightsKnowledgeGraphEntityCapabilities tag. Gli attributi supportati per gli insight 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. 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 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 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 pubblico disponibili utilizzando il ListAudienceInsightsAttributes metodo, fornendo le dimensioni per le quali vuoi gli attributi, ad esempio KNOWLEDGE_GRAPH per 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, insieme a audience_combinations.

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

Dati supplementari e creator locali

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

Se la richiesta di tendenze 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. La rilevazione dei creator locali è soggetta alla stessa definizione e agli stessi vincoli (ad esempio, è incompatibile con sub_country_locations).