Audience

L'option de ciblage "Audience" est efficace. Elle vous permet de croiser différents attributs de segment, comme les données démographiques détaillées et les affinités, afin de créer des audiences représentant des sections de vos segments cibles.

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

string

Immuable. Nom de 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. Identifiant de l'audience.
status

enum (AudienceStatus)

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

string

Obligatoire. Nom de l'audience. Elle doit être unique pour toutes les audiences. Sa longueur doit être comprise entre 1 et 255 caractères.
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.

AudienceStatus

Énumération contenant les types d'état 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é" : le type d'audience est activé et peut être ciblé.
REMOVED État "Supprimé" : l'audience a été supprimée et ne peut pas ê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 de 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 par 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 minimum et au moins 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 maxAge est spécifiée, elle doit être supérieure à la valeur minAge, et 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)

Segments démographiques par genre 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 de revenus du foyer inclus.
includeUndetermined

boolean

Inclure les utilisateurs dont les revenus du foyer n'ont pas été 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 du statut parental inclus.
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 démographique détaillé.
customAudience

object (CustomAudienceSegment)

Segment d'audience personnalisé.

UserListSegment

Segment de liste d'utilisateurs. L'arrêt des audiences similaires débutera en mai 2023. Pour connaître les autres options disponibles, consultez la page https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.

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

string

Ressource de la liste d'utilisateurs.

UserInterestSegment

Segment d'intérêt des utilisateurs.

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

string

Ressource sur les centres d'intérêt de l'utilisateur.

LifeEventSegment

Segment d'événements en direct.

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

string

La ressource événement de la vie.

DetailedDemographicSegment

Segment démographique détaillé.

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 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.