Audience

L'audience est une option de ciblage efficace qui vous permet de croiser différents attributs de segment, tels que les données démographiques détaillées et les 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 ressource de l'audience. Les noms d'audience se présentent de la façon 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 pour lequel cette audience peut être utilisée. Par défaut, le champ d'application est CUSTOMER. Vous pouvez créer des audiences avec un champ d'application de type ASSET_GROUP pour une utilisation exclusive par un seul assetGroup. L'étendue peut passer de ASSET_GROUP à CUSTOMER, mais pas de CUSTOMER à ASSET_GROUP.
assetGroup

string

Immuable. Groupe d'assets sous lequel cette audience est limitée. Doit être défini si et seulement si la portée est ASSET_GROUP. Immuable après création. Si une audience associée à la portée ASSET_GROUP passe au champ d'application CUSTOMER, ce champ sera 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. Impossible de définir ou de modifier le champ d'application lorsque le champ d'application est ASSET_GROUP.

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é" : l'audience est activée et peut être ciblée.
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 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 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 d'indiquer d'âge maximal. Si le champ maxAge est spécifié, il doit être supérieur à minAge, et 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 basés sur le 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 basés sur les 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 de l'événement 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 commencera en mai 2023. Consultez la page https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html pour connaître les autres options.

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

Une 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

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

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 limitée à un élément AssetGroup spécifique.