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),
  "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 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.
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 sous lequel se situe cette audience. Doit être défini si et seulement si le champ d'application est ASSET_GROUP. Immuable après création. Si une audience associée à un champ d'application ASSET_GROUP passe à CUSTOMER, ce champ sera automatiquement effacé.
name

string

Nom de l'audience. Elle doit être unique pour toutes les audiences du compte. Sa longueur doit être comprise entre 1 et 255 caractères. Obligatoire lorsque le champ d'application n'est pas défini ou qu'il 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é" : 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.

AudienceScope

Énumération contenant les valeurs possibles de portée d'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 La portée de l'audience est définie au niveau du client.
ASSET_GROUP L'audience est limitée à un AssetGroup spécifique.