Method: accountTypes.accounts.insights.retrieve

Récupère des insights sur les données marketing pour une liste d'utilisateurs donnée.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

Requête HTTP

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Compte parent propriétaire de la liste d'utilisateurs. Format : accountTypes/{accountType}/accounts/{account}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
Champs
baseline

object (Baseline)

Obligatoire. Valeur de référence pour les insights demandés.
userListId

string

Obligatoire. ID de la liste d'utilisateurs pour laquelle des insights sont demandés.

Corps de la réponse

Message de réponse pour DM API MarketingDataInsightsService.RetrieveInsights

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Champs
marketingDataInsights[]

object (MarketingDataInsight)

Contient les insights pour les données marketing.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Référence

Critères de référence par rapport auxquels les insights sont comparés.

Représentation 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.
}
Champs
Champ d'union baseline. Emplacement de référence auquel les insights sont comparés. baseline ne peut être qu'un des éléments suivants :
baselineLocation

object (Location)

Emplacement de référence de la demande. L'emplacement de référence est une liste OR des régions demandées.
locationAutoDetectionEnabled

boolean

Si la valeur est définie sur "true", le service tente de détecter automatiquement le lieu de référence pour les insights.

Emplacement

Emplacement de référence de la demande. La zone géographique de référence figure dans la liste OR des codes régionaux ISO 3166-1 alpha-2 des régions demandées.

Représentation JSON 
{
  "regionCodes": [
    string
  ]
}
Champs
regionCodes[]

string

Liste des codes régionaux ISO 3166-1 alpha-2.

MarketingDataInsight

Insights pour les données marketing

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Représentation JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Champs
dimension

enum (AudienceInsightsDimension)

Dimension à laquelle appartient l'insight.
attributes[]

object (MarketingDataInsightsAttribute)

Insights pour les valeurs d'une dimension donnée.

AudienceInsightsDimension

Dimensions possibles à utiliser pour générer des insights.

Enums
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Non spécifié.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN La valeur est inconnue dans cette version.
AFFINITY_USER_INTEREST Un Affinity UserInterest.
IN_MARKET_USER_INTEREST Un UserInterest sur le marché.
AGE_RANGE Tranche d'âge.
GENDER Genre

MarketingDataInsightsAttribute

Insights pour une collection d'attributs associés de la même dimension.

Représentation JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Champs
userInterestId

string (int64 format)

ID du centre d'intérêt de l'utilisateur.
lift

number

Mesure de l'impact de l'audience pour la valeur de l'attribut par rapport à la référence. Plage [0-1].
ageRange

enum (AgeRange)

Tranche d'âge de l'audience pour laquelle l'impact est fourni.
gender

enum (Gender)

Genre de l'audience pour laquelle l'impact est fourni.

Âge

Tranches d'âge démographiques

Enums
AGE_RANGE_UNSPECIFIED Non spécifié.
AGE_RANGE_UNKNOWN Inconnu.
AGE_RANGE_18_24 Avoir entre 18 et 24 ans
AGE_RANGE_25_34 Entre 25 et 34 ans
AGE_RANGE_35_44 Entre 35 et 44 ans
AGE_RANGE_45_54 Entre 45 et 54 ans
AGE_RANGE_55_64 Entre 55 et 64 ans
AGE_RANGE_65_UP 65 ans et plus

Sexe

Type de genre démographique (par exemple, "féminin").

Enums
GENDER_UNSPECIFIED Non spécifié.
GENDER_UNKNOWN Inconnu.
GENDER_MALE Homme.
GENDER_FEMALE Femme.