Method: insights.retrieveInsights

Recupera gli approfondimenti sui dati di marketing per una determinata destinazione.

Richiesta HTTP

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Campi
destination

object (Destination)

Obbligatorio. La destinazione per cui recuperare gli approfondimenti.
baseline

object (Baseline)

Obbligatorio. Il valore di base per gli approfondimenti richiesti.

Corpo della risposta

Messaggio di risposta per DM API MarketingDataInsightsService.RetrieveInsights

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

Rappresentazione JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Campi
marketingDataInsights[]

object (MarketingDataInsight)

Contiene gli approfondimenti sui dati di marketing.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Base di riferimento

Criteri di base rispetto ai quali vengono confrontati gli approfondimenti.

Rappresentazione JSON 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
Campi
Campo unione baseline. La posizione di riferimento con cui vengono confrontati gli approfondimenti. baseline può essere solo uno dei seguenti tipi:
baselineLocation

object (Location)

La posizione di base della richiesta. La posizione di base è un elenco OR delle regioni richieste.
locationAutoDetectionEnabled

boolean

Se impostato su true, il servizio tenterà di rilevare automaticamente la posizione di base per gli approfondimenti.

Località

La posizione di base della richiesta. La posizione di base si trova nell'elenco OR dei codici regione ISO 3166-1 alpha-2 delle regioni richieste.

Rappresentazione JSON 
{
  "regionCodes": [
    string
  ]
}
Campi
regionCodes[]

string

Elenco dei codici regione ISO 3166-1 alpha-2.

MarketingDataInsight

Approfondimenti per i dati di marketing.

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

enum (AudienceInsightsDimension)

La dimensione a cui appartiene l'approfondimento.
attributes[]

object (MarketingDataInsightsAttribute)

Approfondimenti per i valori di una determinata dimensione.

AudienceInsightsDimension

Dimensioni possibili da utilizzare per generare approfondimenti.

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Non specificato.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Il valore è sconosciuto in questa versione.
AFFINITY_USER_INTEREST Un UserInterest di affinità.
IN_MARKET_USER_INTEREST Un UserInterest in-market.
AGE_RANGE Una fascia d'età.
GENDER Un genere.

MarketingDataInsightsAttribute

Approfondimenti per una raccolta di attributi correlati della stessa dimensione.

Rappresentazione JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Campi
userInterestId

string (int64 format)

L'ID dell'interesse dell'utente.
lift

number

Misura dell'incremento che il pubblico ha per il valore dell'attributo rispetto al valore di base. Intervallo [0-1].
ageRange

enum (AgeRange)

La fascia d'età del pubblico per cui viene fornito il sollevamento.
gender

enum (Gender)

Il genere del pubblico per cui viene fornito l'incremento.

Intervallo età

Le fasce d'età demografiche

Enum
AGE_RANGE_UNSPECIFIED Non specificato.
AGE_RANGE_UNKNOWN Sconosciuto.
AGE_RANGE_18_24 Tra i 18 e i 24 anni.
AGE_RANGE_25_34 Tra i 25 e i 34 anni.
AGE_RANGE_35_44 Tra i 35 e i 44 anni.
AGE_RANGE_45_54 Tra i 45 e i 54 anni.
AGE_RANGE_55_64 Tra i 55 e i 64 anni.
AGE_RANGE_65_UP 65 anni e oltre.

Genere

Il tipo di genere demografico (ad esempio, femminile).

Enum
GENDER_UNSPECIFIED Non specificato.
GENDER_UNKNOWN Sconosciuto.
GENDER_MALE Uomo.
GENDER_FEMALE Donna.