Audience

L'audience constitue une option de ciblage efficace qui vous permet de croiser différents attributs de segment, tels que des données démographiques détaillées et des audiences d'affinité, afin de créer des audiences qui représentent des sections de vos segments cibles.

Représentation JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
Champs
resourceName

string

Immuable. Nom de ressource de l'audience. Les noms d'audience se présentent comme suit:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Uniquement en sortie. ID de l'audience.
status

enum (AudienceStatus)

Uniquement en sortie. État de cette audience. Indique si l'audience est activée ou supprimée.
description

string

Description de cette audience.
dimensions[]

object (AudienceDimension)

Dimensions positives spécifiant la composition de l'audience.
exclusionDimension

object (AudienceExclusionDimension)

Dimension négative spécifiant la composition de l'audience.
scope

enum (AudienceScope)

Définit le champ d'application dans lequel cette audience peut être utilisée. Par défaut, le champ d'application est CUSTOMER. Vous pouvez créer des audiences avec le champ d'application "ASSET_GROUP" pour une utilisation exclusive par un seul assetGroup. Le champ d'application peut passer de ASSET_GROUP à CUSTOMER, mais pas de CUSTOMER à ASSET_GROUP.
assetGroup

string

Immuable. Groupe d'assets au niveau duquel cette audience est limitée. Ne doit être défini que si et seulement si le champ d'application est "ASSET_GROUP". Immuable après la création. Si une audience avec le niveau d'accès "ASSET_GROUP" passe à la portée "CUSTOMER", ce champ est automatiquement effacé.
name

string

Nom de l'audience. Il doit être unique pour toutes les audiences du compte. Il doit comporter entre 1 et 255 caractères. Obligatoire lorsque le champ d'application n'est pas défini ou est défini sur "CUSTOMER". Ne peut pas être défini ni mis à jour lorsque le champ d'application est défini sur "ASSET_GROUP".

AudienceStatus

Énumération contenant les types d'états d'audience possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED État "Activée" : l'audience est activée et peut être ciblée.
REMOVED État "Supprimé" : le type d'audience a été supprimé et ne peut pas être utilisé pour le ciblage.

AudienceDimension

Dimension positive spécifiant l'audience de l'utilisateur.

Représentation JSON 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
Champs
Champ d'union dimension. Dimension spécifiant les utilisateurs appartenant à l'audience. dimension ne peut être qu'un des éléments suivants :
age

object (AgeDimension)

Dimension spécifiant les utilisateurs en fonction de leur âge.
gender

object (GenderDimension)

Dimension spécifiant les utilisateurs en fonction de leur genre.
householdIncome

object (HouseholdIncomeDimension)

Dimension spécifiant les utilisateurs en fonction des revenus de leur foyer.
parentalStatus

object (ParentalStatusDimension)

Dimension spécifiant les utilisateurs en fonction de leur statut parental.
audienceSegments

object (AudienceSegmentDimension)

Dimension spécifiant les utilisateurs en fonction de leur appartenance à d'autres segments d'audience.

AgeDimension

Dimension spécifiant les utilisateurs en fonction de leur âge.

Représentation JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Champs
ageRanges[]

object (AgeSegment)

Tranche d'âge contiguë à inclure dans la dimension.
includeUndetermined

boolean

Inclure les utilisateurs dont l'âge n'est pas déterminé.

AgeSegment

Tranche d'âge contiguë.

Représentation JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Champs
minAge

integer

Âge minimum à inclure. Vous devez indiquer un âge minimal de 18 ans. Les valeurs autorisées sont 18, 25, 35, 45, 55 et 65.
maxAge

integer

Âge maximal à inclure. Il n'est pas nécessaire de spécifier un âge maximal. Si la valeur est spécifiée, la valeur "maxAge" doit être supérieure à la valeur "minAge". Les valeurs autorisées sont 24, 34, 44, 54 et 64.

GenderDimension

Dimension spécifiant les utilisateurs en fonction de leur genre.

Représentation JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Champs
genders[]

enum (GenderType)

Segments démographiques par sexe inclus.
includeUndetermined

boolean

Inclure les utilisateurs dont le sexe n'est pas déterminé.

HouseholdIncomeDimension

Dimension spécifiant les utilisateurs en fonction des revenus de leur foyer.

Représentation JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Champs
incomeRanges[]

enum (IncomeRangeType)

Segments démographiques inclus dans les revenus du foyer.
includeUndetermined

boolean

Inclure les utilisateurs dont les revenus du foyer ne sont pas déterminés.

ParentalStatusDimension

Dimension spécifiant les utilisateurs en fonction de leur statut parental.

Représentation JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Champs
parentalStatuses[]

enum (ParentalStatusType)

Segments démographiques inclus dans le statut parental.
includeUndetermined

boolean

Inclure les utilisateurs dont le statut parental est indéterminé.

AudienceSegmentDimension

Dimension spécifiant les utilisateurs en fonction de leur appartenance à d'autres segments d'audience.

Représentation JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Champs
segments[]

object (AudienceSegment)

Segments d'audience inclus. Les utilisateurs sont inclus s'ils appartiennent à au moins un segment.

AudienceSegment

Segment d'audience à inclure.

Représentation JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
Champs
Champ d'union segment. Segment à inclure. segment ne peut être qu'un des éléments suivants :
userList

object (UserListSegment)

Segment de liste d'utilisateurs.
userInterest

object (UserInterestSegment)

Segment d'affinité ou sur le marché.
lifeEvent

object (LifeEventSegment)

Segment d'audience des événements en direct.
detailedDemographic

object (DetailedDemographicSegment)

Segment de données démographiques détaillées.
customAudience

object (CustomAudienceSegment)

Segment d'audience personnalisé.

UserListSegment

Segment de liste d'utilisateurs.

Représentation JSON 
{
  "userList": string
}
Champs
userList

string

Ressource de la liste d'utilisateurs.

UserInterestSegment

Centre d'intérêt des utilisateurs.

Représentation JSON 
{
  "userInterestCategory": string
}
Champs
userInterestCategory

string

Ressource sur les centres d'intérêt des utilisateurs.

LifeEventSegment

Segment de l'événement en direct.

Représentation JSON 
{
  "lifeEvent": string
}
Champs
lifeEvent

string

Ressource "Événement de la vie".

DetailedDemographicSegment

Segment de données démographiques détaillées.

Représentation JSON 
{
  "detailedDemographic": string
}
Champs
detailedDemographic

string

Ressource démographique détaillée.

CustomAudienceSegment

Segment d'audience personnalisé.

Représentation JSON 
{
  "customAudience": string
}
Champs
customAudience

string

Ressource d'audience personnalisée.

AudienceExclusionDimension

Dimension à exclure spécifiant les utilisateurs à exclure de l'audience.

Représentation JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Champs
exclusions[]

object (ExclusionSegment)

Segment d'audience à exclure.

ExclusionSegment

Segment d'audience à exclure d'une audience.

Représentation JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Champs
Champ d'union segment. Segment à exclure. segment ne peut être qu'un des éléments suivants :
userList

object (UserListSegment)

Segment de liste d'utilisateurs à exclure.

AudienceScope

Énumération contenant les valeurs de portée d'audience possibles.

Enums
UNSPECIFIED Le champ d'application n'a pas été spécifié.
UNKNOWN La valeur reçue est inconnue dans cette version.
CUSTOMER La portée de l'audience est définie au niveau du client.
ASSET_GROUP L'audience est limitée à un AssetGroup spécifique.