approfondimenti per i creator di YouTube

Scopri e recupera gli insight sui creator di YouTube con la funzionalità di insight dei 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 più popolari per un determinato insieme di argomenti, dati demografici, segmenti di pubblico o attributi dei creator.
  2. Insight sul brand dei creator: recupera gli insight sui creator relativi a un brand specifico.
  3. Insight dei 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.

Requisiti di idoneità

ContentCreatorInsightsService.GenerateCreatorInsights è un componente privato dell'API Google Ads offerto con una licenza dati non esclusiva ed esente da royalty. I partner che hanno effettuato l'accesso possono utilizzare le librerie client standard di 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 dei creator

Per generare insight dei creator, invia una richiesta al ContentCreatorInsightsService.GenerateCreatorInsights metodo. Questo metodo ha un limite di 5 query al secondo (QPS) e accetta tre tipi di input a seconda che tu voglia eseguire la rilevabilità dei creator, ottenere insight sul brand dei creator o ottenere insight dei 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 AudienceInsightsService.ListAudienceInsightsAttributes, 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 logica booleana (AND/OR) che non è possibile con audience_attributes.

    Sebbene audience_attributes sia 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 segmento di 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 sul brand dei creator: fornisci un brand per cercare i creator più popolari. L'API restituisce insight sui canali corrispondenti.

  3. Insight dei creator: fornisci un elenco di ID dei canali YouTube. L'API restituisce insight su questi canali specifici.

Il metodo generateCreatorInsights restituisce un oggetto GenerateCreatorInsightsResponse. Questo oggetto contiene un elenco di oggetti YouTubeCreatorInsights. Ogni oggetto YouTubeCreatorInsights contiene le seguenti informazioni su un creator:

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

L'YouTubeMetrics oggetto contiene le seguenti metriche:

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

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, età, genere e interessi

    suddivisione)

  • Video principali

  • Tipo di canale

  • Lingue associate ai contenuti del canale

  • Punteggio di pertinenza (solo per le ricerche di tendenze degli argomenti)

Per generare insight sulle tendenze, invia una richiesta al ContentCreatorInsightsService.GenerateTrendingInsights metodo. Questo metodo ha un limite di 5 query al secondo (QPS) e accetta due tipi di input a seconda che tu voglia ottenere le tendenze del pubblico o le tendenze degli argomenti. Devi fornire la località del paese specifico 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 AudienceInsightsService.ListAudienceInsightsAttributes, 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 logica booleana (AND/OR) che non è possibile con audience_attributes.

    Sebbene audience_attributes sia 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 segmento di 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. 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.

Indietro
Informazioni sul pubblico