Statistiche sul pubblico

Importante: questa funzionalità è disponibile solo per gli account inclusi in una lista consentita. Contatta il tuo rappresentante di Google se hai bisogno di accedere a questa funzionalità.

Tutte le richieste a AudienceInsightsService sono soggette a limiti di frequenza. Tuttavia, per generateAudienceCompositionInsights e generateSuggestedTargetingInsights sono consentite meno richieste al giorno rispetto ad altri metodi di Audience Insights. Per ulteriori dettagli, consulta la documentazione relativa alla Quota.

AudienceInsightsService consente agli utenti di integrare i dati di Audience Insights di Google nei propri strumenti proprietari. I dati consentono alle agenzie di media e ai media planner di acquisire una comprensione più approfondita del pubblico di destinazione, inclusi dati demografici, interessi e comportamento online.

Le statistiche sul pubblico consentono agli utenti di capire rapidamente 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, i clienti possono utilizzare queste statistiche sul pubblico per interpretare le associazioni e le percezioni dei consumatori e ottenere nuove informazioni sui propri segmenti di pubblico.

L'API ha 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 il brand, sviluppare le buyer persona e perfezionare le strategie di segmentazione del pubblico.

• Pianifica le campagne: converti gli output dei dati in segmenti di pubblico di destinazione di YouTube per la pianificazione. Consente ai clienti di identificare la copertura potenziale dei segmenti di pubblico di destinazione per aiutarli a pianificare le campagne pubblicitarie. Consente ai clienti di misurare la sovrapposizione tra i segmenti di pubblico per massimizzare la copertura potenziale delle campagne.

• Sviluppa messaggi creativi: personalizza i messaggi creativi per il pubblico di destinazione dopo aver scoperto a cosa tiene di più.

Requisiti di idoneità

Per essere idonei a AudienceInsightsService, i partner devono soddisfare le seguenti condizioni:

• Avere accesso a Insights Finder o essere idonei all'accesso.
• Avere uno strumento di pianificazione o un'interfaccia utente che integrerà l'API.
• Utilizzare l'API per la pianificazione pubblicitaria o per altri casi d'uso pertinenti.
• Completare una valutazione preliminare.
• 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.

Genera statistiche sulla composizione del pubblico

Il metodo generateAudienceCompositionInsights restituisce un GenerateAudienceCompositionInsightsResponse, che contiene un elenco di attributi che rappresentano il pubblico di interesse richiesto, con metriche che confrontano la quota di ciascun attributo del pubblico con la quota di un pubblico di base

Devi fornire un paese di destinazione per il pubblico. L'elenco delle dimensioni supportate per il recupero delle statistiche sulla composizione è riportato nella descrizione del dimensions campo di GenerateAudienceCompositionInsightsRequest.

Questo metodo può aiutarti a rispondere a domande come "Quali sono le principali affinità del mio pubblico di destinazione rispetto alla popolazione generale e quanto è più probabile che sia interessato a queste affinità rispetto alla popolazione generale?"

Genera statistiche sulla sovrapposizione del pubblico

Il metodo generateAudienceOverlapInsights restituisce un GenerateAudienceOverlapInsightsResponse che contiene un elenco di attributi del pubblico con stime della sovrapposizione tra la loro copertura potenziale su YouTube e quella di un determinato attributo principale.

Devi fornire un paese di destinazione e un attributo principale. Come dimensioni del pubblico sono supportati fascia d'età, genere, segmenti di affinità e segmenti in-market.

Questo metodo può aiutarti a rispondere a domande come "Qual è la dimensione del segmento di pubblico incrementale quando ci rivolgiamo sia agli appassionati di sport sia agli amanti della musica negli Stati Uniti?"

Genera la definizione di segmento di pubblico

Il metodo generateAudienceDefinition restituisce suggerimenti per gli attributi del pubblico in base a una descrizione del pubblico.

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 oggetto GenerateInsightsFinderReportResponse contenente un link accessibile esternamente per aprire il report nell'interfaccia utente di Insights Finder.

Genera statistiche sul targeting suggerito

Il metodo generateSuggestedTargetingInsights restituisce una raccolta di statistiche sul targeting (ad es. segmenti di pubblico targetizzabili) pertinenti al pubblico richiesto .

Il pubblico richiesto può essere in formato strutturato InsightsAudienceDefinition o come descrizione testuale InsightsAudienceDescription.

Il metodo generateAudienceCompositionInsights restituisce statistiche per i singoli segmenti di attributi pertinenti, mentre generateSuggestedTargetingInsights restituisce suggerimenti e statistiche sui segmenti di pubblico di Google targetizzabili.

Questo metodo aiuta a rispondere a domande come "Forniscimi suggerimenti per i segmenti di pubblico targetizzabili per i padri trentenni che amano la pesca".

Genera metriche per i suggerimenti per il 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 può aiutarti a rispondere a domande come "Quanti uomini di età superiore ai 18 anni interessati al campeggio negli Stati Uniti possono essere raggiunti su YouTube?"

Elenca gli attributi di Audience Insights

Il listAudienceInsightsAttributes metodo restituisce un ListAudienceInsightsAttributesResponse che contiene l'elenco degli attributi disponibili per le dimensioni richieste.

Ad esempio, se nella richiesta viene selezionata la dimensione "Affinità", viene restituito un elenco di segmenti di pubblico di affinità supportati, come "appassionati di sport" o "amanti della musica". Altre dimensioni degli interessi degli utenti supportate includono "In-market" ed "Evento importante". Puoi impostare più dimensioni per una singola richiesta. Per un elenco completo delle dimensioni supportate, consulta la documentazione di riferimento.

Quando cerchi entità Knowledge Graph (argomenti) utilizzando la KNOWLEDGE_GRAPH dimensione, devi fornire una stringa di query nel query_text campo (ad esempio, "football and the World Cup").

Puoi anche includere facoltativamente knowledge_graph_entity_search_options per personalizzare la ricerca degli argomenti:

• Filtra per funzionalità: utilizza search_filter per limitare le entità recuperate solo a quelle che supportano funzionalità specifiche. Ad esempio, puoi filtrare gli argomenti supportati come attributi dei creator fornendo CREATOR_ATTRIBUTE nel campo entity_capability_filters. È possibile fornire più funzionalità, che vengono combinate con la logica OR.
• Recupera tutti gli attributi dei creator: imposta get_all_creator_attributes su true per ottenere un dump completo di tutte le entità Knowledge Graph disponibili con il tag attributi dei creator. Tieni presente che, quando utilizzi questa opzione, devi selezionare la dimensione KNOWLEDGE_GRAPH, il campo query_text della richiesta deve essere vuoto e non puoi combinare questa opzione con un search_filter.

Gli attributi restituiti da questa funzionalità di rilevabilità possono essere utilizzati come input per altre AudienceInsightsService funzionalità.

Ogni AudienceInsightsAttributeMetadata oggetto restituito all'interno del ListAudienceInsightsAttributesResponse fornisce una rappresentazione strutturata di un attributo del pubblico insieme a proprietà descrittive e metriche di coinvolgimento. Include la definizione principale dell'attributo, informazioni di visualizzazione intuitive, tipo di dimensione e copertura di pubblico stimata. Per definizioni più dettagliate di ogni campo disponibile, consulta la AudienceInsightsAttributeMetadata documentazione di riferimento.

Elenca le date idonee per le statistiche

Il metodo listInsightsEligibleDates restituisce un ListInsightsEligibleDatesResponse , che contiene un elenco di mesi nel formato "AAAA-MM" per i quali sono disponibili i dati di Audience Insights.

La risposta contiene anche le date effettive che rappresentano gli "ultimi 30 giorni" che verranno utilizzati per il metodo generateAudienceCompositionInsights, quando date_month non è impostato nella richiesta.