Tutte le richieste a AudienceInsightsService sono soggette a limitazione di frequenza. Sono consentite meno richieste al giorno per generateAudienceCompositionInsights e generateSuggestedTargetingInsights rispetto ad altri metodi di Insight sul pubblico. Per ulteriori dettagli, consulta Quote API.
AudienceInsightsService ti consente di integrare i dati delle statistiche sul pubblico Google nei tuoi strumenti di pianificazione. I dati aiutano le agenzie di comunicazione e i media planner ad acquisire una comprensione più approfondita del pubblico di destinazione, inclusi dati demografici, interessi e comportamento online.
Le statistiche sul pubblico ti consentono di capire com'è fatto un pubblico, una categoria, un argomento o un brand grazie a una panoramica generale. Analizzando i comportamenti degli utenti relativamente agli argomenti correlati, puoi utilizzare queste statistiche sul pubblico per scoprire le associazioni e le percezioni dei consumatori e identificare nuovi segmenti di pubblico.
L'API supporta tre casi d'uso principali:
- Perfeziona e scopri i segmenti di pubblico: comprendi gli interessi e i comportamenti unici dei consumatori per identificare nuovi segmenti di pubblico per un brand, sviluppare buyer persona e perfezionare le strategie di segmentazione del pubblico.
- Informazioni per la pianificazione delle campagne: converti i dati in segmenti di pubblico di destinazione di YouTube per pianificare, stimare la copertura potenziale dei segmenti di pubblico target e misurare la sovrapposizione tra i segmenti di pubblico per massimizzare la copertura della campagna.
- Sviluppa messaggi creativi: personalizza i messaggi creativi per il tuo pubblico di destinazione in base agli argomenti e alle affinità con cui interagisce di più.
Requisiti di idoneità
Per essere idonei a AudienceInsightsService, i partner devono soddisfare le seguenti condizioni:
- Disporre già dell'accesso o dell'idoneità per accedere a Insights Finder.
- Disporre di uno strumento di pianificazione o di un'interfaccia utente che integri l'API.
- Utilizzare l'API per scopi di pianificazione dei media o altri casi d'uso pertinenti.
- Completare una valutazione preliminare.
- Rispettare i requisiti di utilizzo dei dati e sottoporsi a controlli periodici dei dati.
- Accetta i Termini di servizio dell'API Google Ads e le norme di utilizzo dei dati associate.
Per saperne di più, contatta il tuo rappresentante di Google.
Date idonee per gli insight sull'elenco
Un flusso di lavoro tipico inizia con il controllo dei mesi di calendario e delle finestre di date disponibili per l'analisi. Il metodo listInsightsEligibleDates restituisce un
ListInsightsEligibleDatesResponse, il cui campo data_months elenca i
mesi (nel formato YYYY-MM) per i quali sono disponibili i dati delle statistiche sul pubblico.
Il campo last_thirty_days della risposta contiene l'intervallo di date esatto utilizzato da generateAudienceCompositionInsights quando data_month non è impostato nella richiesta.
Elenca gli attributi delle statistiche sul pubblico
Prima di eseguire query sulle metriche di composizione o sovrapposizione del pubblico, scopri gli ID attributo validi utilizzando listAudienceInsightsAttributes. Questo metodo restituisce un ListAudienceInsightsAttributesResponse contenente gli attributi disponibili per le dimensioni richieste.
Ad esempio, se AFFINITY_USER_INTEREST è selezionato come dimensione nella richiesta, il metodo restituisce i segmenti di pubblico di affinità supportati, come "Appassionati di sport" o "Appassionati di musica". Altre dimensioni di interesse degli utenti supportate includono IN_MARKET_USER_INTEREST e LIFE_EVENT_USER_INTEREST. Puoi impostare più dimensioni in un'unica richiesta. Per un elenco completo delle dimensioni supportate, consulta il riferimento ai campi dimensions.
Quando cerchi entità (argomenti) del Knowledge Graph utilizzando la dimensione KNOWLEDGE_GRAPH, devi fornire una query di stringa nel campo query_text (ad esempio, "football and the World Cup").
Se vuoi, puoi includere knowledge_graph_entity_search_options per personalizzare la ricerca degli argomenti:
- Filtra per funzionalità: utilizza
search_filterper restringere le entità recuperate solo a quelle che supportano funzionalità specifiche. Ad esempio, puoi filtrare per argomenti supportati come attributi dei creator fornendoCREATOR_ATTRIBUTEnel campoentity_capability_filters. È possibile fornire più funzionalità, che vengono combinate con la logicaOR. - Recupera tutti gli attributi del creator: imposta
get_all_creator_attributessutrueper recuperare tutte le entità del Knowledge Graph disponibili taggate come attributi del creator. Quando utilizzi questa opzione, devi selezionare la dimensioneKNOWLEDGE_GRAPH,query_textdeve essere vuoto e non puoi combinare questa opzione consearch_filter.
Gli attributi restituiti da questo metodo di rilevabilità possono essere utilizzati come input per altri metodi AudienceInsightsService.
Ogni oggetto AudienceInsightsAttributeMetadata in
ListAudienceInsightsAttributesResponse fornisce una rappresentazione strutturata di
un attributo del segmento di pubblico insieme a proprietà descrittive e metriche sul coinvolgimento.
Include la definizione principale dell'attributo, il nome visualizzato, il tipo di dimensione e la copertura di pubblico stimata. Per le definizioni dei campi, consulta il riferimento AudienceInsightsAttributeMetadata.
Genera definizione di segmento di pubblico
Il metodo generateAudienceDefinition traduce una descrizione testuale in formato libero di un segmento di pubblico in suggerimenti strutturati di attributi del segmento di pubblico che puoi passare ai metodi di insight downstream.
Genera insight sul targeting suggerito
Il metodo generateSuggestedTargetingInsights restituisce una raccolta di
statistiche sul targeting (ad esempio segmenti di pubblico targetizzabili) pertinenti per
il pubblico richiesto.
Puoi specificare il pubblico richiesto come InsightsAudienceDefinition strutturato o come descrizione di testo in InsightsAudienceDescription.
Mentre generateAudienceCompositionInsights restituisce approfondimenti per singoli segmenti di attributi, generateSuggestedTargetingInsights restituisce suggerimenti raggruppati di segmenti di pubblico Google Ads targetizzabili. Questo metodo aiuta a rispondere a domande come "Fornisci suggerimenti di segmenti di pubblico targetizzabili per padri di 30 anni che amano la pesca".
Genera metriche dei suggerimenti di targeting
Il metodo generateTargetingSuggestionMetrics restituisce un
GenerateTargetingSuggestionMetricsResponse, che contiene la potenziale
popolazione YouTube che può essere raggiunta per ogni definizione di segmento di pubblico richiesta in
GenerateTargetingSuggestionMetricsRequest.
Questo metodo aiuta a rispondere a domande come "Quanti uomini di età superiore ai 18 anni interessati al campeggio negli Stati Uniti possono essere raggiunti su YouTube?"
Genera statistiche sulla composizione del pubblico
Il metodo generateAudienceCompositionInsights restituisce un
GenerateAudienceCompositionInsightsResponse, che contiene un elenco di
attributi che rappresentano il segmento di pubblico di interesse richiesto, insieme alle metriche
di indice e quota che confrontano la quota di pubblico di ogni attributo con una
popolazione di riferimento.
Devi fornire un paese di destinazione per il segmento di pubblico. L'elenco delle dimensioni supportate per il recupero degli insight sulla composizione è documentato nel campo dimensions di GenerateAudienceCompositionInsightsRequest.
Questo metodo aiuta a rispondere a domande come "Quali sono le principali affinità che interessano al mio pubblico di destinazione rispetto alla popolazione generale e qual è la probabilità che interagisca con queste affinità?"
Genera statistiche sulla sovrapposizione dei segmenti di pubblico
Il metodo generateAudienceOverlapInsights restituisce un
GenerateAudienceOverlapInsightsResponse, che contiene un elenco di
attributi del segmento di pubblico con stime della sovrapposizione tra la loro copertura potenziale
su YouTube e quella di un attributo principale.
Devi fornire un paese di destinazione e un attributo principale. La fascia d'età, il genere, i segmenti di affinità e i segmenti in-market sono supportati come dimensioni del pubblico.
Questo metodo aiuta a rispondere a domande come "Qual è la dimensione del segmento di pubblico incrementale quando scegliamo come target sia gli appassionati di sport sia gli amanti della musica negli Stati Uniti?".
Genera il report di Insights Finder
Il metodo generateInsightsFinderReport crea un report salvato in
Insights Finder in base agli input specificati in
GenerateInsightsFinderReportRequest e restituisce un
GenerateInsightsFinderReportResponse contenente un link accessibile esternamente
per aprire il report nell'interfaccia utente di Insights Finder.
Google Issue Tracker
Utilizza Google Issue Tracker per porre domande di assistenza, segnalare bug o inviare richieste di funzionalità. Google monitora, assegna la priorità e pubblica gli aggiornamenti sulle tue richieste direttamente in Issue Tracker. Per saperne di più, consulta Crea un problema in Google Issue Tracker.
Crea un problema utilizzando uno dei seguenti modelli di Issue Tracker:
- Fai una domanda di assistenza generale o invia un feedback sulla documentazione
- Segnala un bug tecnico
- Invia una richiesta di funzionalità API
Compila tutti i campi del modello con informazioni dettagliate in modo che Google possa riprodurre e dare priorità alla tua richiesta. Google potrebbe chiudere le segnalazioni incomplete e chiederti di inviare un nuovo problema con i dettagli mancanti.