Method: customers.generateAudienceOverlapInsights

Restituisce una raccolta di attributi dei segmenti di pubblico insieme alle stime della sovrapposizione tra la loro potenziale copertura su YouTube e quella di un determinato attributo di input.

Elenco degli errori generati: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Campi
countryLocation

object (LocationInfo)

Obbligatorio. Il paese in cui calcolare le dimensioni e le sovrapposizioni dei segmenti di pubblico.
primaryAttribute

object (AudienceInsightsAttribute)

Obbligatorio. L'attributo del segmento di pubblico che deve essere intersecato con tutti gli altri segmenti di pubblico idonei. Deve essere un interesse utente in-market, di affinità, una fascia di età o un genere.
dimensions[]

enum (AudienceInsightsDimension)

Obbligatorio. I tipi di attributi di cui calcolare la sovrapposizione con l'attributo primaryAttribute. I valori devono essere un sottoinsieme di AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE e GENDER.
customerInsightsGroup

string

Il nome del cliente per cui è prevista la pianificazione. Si tratta di un valore definito dall'utente.

Corpo della risposta

Messaggio di risposta per AudienceInsightsService.GenerateAudienceOverlapInsights.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Campi
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Metadati per l'attributo principale, inclusa la potenziale copertura di YouTube.
dimensionResults[]

object (DimensionOverlapResult)

Elenchi di attributi e la loro sovrapposizione con l'attributo principale, un elenco per ogni dimensione richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

DimensionOverlapResult

Un elenco di attributi dei segmenti di pubblico di una singola dimensione, inclusa la loro sovrapposizione con un attributo principale, restituiti come parte di un GenerateAudienceOverlapInsightsResponse.

Rappresentazione JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Campi
dimension

enum (AudienceInsightsDimension)

La dimensione di tutti gli attributi in questa sezione.
items[]

object (AudienceOverlapItem)

Gli attributi e la loro sovrapposizione con l'attributo principale.

AudienceOverlapItem

Un attributo del segmento di pubblico, con metadati che includono la sovrapposizione tra la potenziale copertura di YouTube di questo attributo e quella di un attributo principale.

Rappresentazione JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Campi
attributeMetadata

object (AudienceInsightsAttributeMetadata)

L'attributo e i relativi metadati, inclusa la potenziale copertura di YouTube.
potentialYoutubeReachIntersection

string (int64 format)

La dimensione stimata dell'intersezione di questo attributo del segmento di pubblico con l'attributo principale, ovvero il numero di utenti di YouTube raggiungibili che corrispondono sia all'attributo principale sia a questo.