Audience

L'audience est 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 affinités, 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 la ressource de l'audience. Les noms d'audience se présentent sous la forme suivante:

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 de cette audience. Par défaut, le champ d'application est CUSTOMER. Vous pouvez créer des audiences avec une portée ASSET_GROUP pour qu'elles soient utilisées exclusivement par un seul assetGroup. La portée peut passer d'ASSET_GROUP à CUSTOMER, mais pas de CUSTOMER à ASSET_GROUP.
assetGroup

string

Immuable. Groupe de composants auquel cette audience est associée. Doit être défini si et seulement si la portée est ASSET_GROUP. Immuable après la création. Si une audience avec une portée ASSET_GROUP est migrée vers une 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 au moins un caractère et au maximum 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 la portée est ASSET_GROUP.

AudienceStatus

Enum contenant les types d'états d'audience possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
ENABLED État activé : l'audience est activée et peut être ciblée.
REMOVED État "Supprimée" : l'audience est supprimée et ne peut plus être utilisée 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 par âge.
gender

object (GenderDimension)

Dimension spécifiant les utilisateurs par genre.
householdIncome

object (HouseholdIncomeDimension)

Dimension spécifiant les utilisateurs en fonction de leurs revenus du 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 par â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'a pas été déterminé

AgeSegment

Tranche d'âge contiguë.

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

integer

Âge minimal à inclure. Vous devez spécifier un âge minimal d'au moins 18 ans. Les valeurs autorisées sont 18, 25, 35, 45, 55 et 65.
maxAge

integer

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

GenderDimension

Dimension spécifiant les utilisateurs par genre.

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

enum (GenderType)

Incluaient des segments démographiques par genre.
includeUndetermined

boolean

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

HouseholdIncomeDimension

Dimension spécifiant les utilisateurs en fonction de leurs revenus du foyer.

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

enum (IncomeRangeType)

Inclut les segments démographiques relatifs aux 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)

Incluez des segments démographiques sur le statut parental.
includeUndetermined

boolean

Inclure les utilisateurs dont le statut parental n'est pas dé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 positif. segment ne peut être qu'un des éléments suivants :
userList

object (UserListSegment)

Segment de liste d'utilisateurs.
userInterest

object (UserInterestSegment)

Segments d'affinité ou sur le marché
lifeEvent

object (LifeEventSegment)

Segment d'audience pour les é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 des utilisateurs.

UserInterestSegment

Segment des centres 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 d'événement en direct.

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

string

Ressource d'événement de la vie.

DetailedDemographicSegment

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

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

string

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

CustomAudienceSegment

Segment d'audience personnalisé.

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

string

Ressource d'audience personnalisée.

AudienceExclusionDimension

Dimension négative 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

Enum contenant les valeurs d'étendue d'audience possibles.

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