CustomAudience

Une audience personnalisée. Il s'agit d'une liste d'utilisateurs par centre d'intérêt.

Représentation JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Champs
resourceName

string

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

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Uniquement en sortie. ID de l'audience personnalisée.
status

enum (CustomAudienceStatus)

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

string

Nom de l'audience personnalisée. Il doit être propre à toutes les audiences personnalisées créées par un client. Ce champ est obligatoire pour créer des opérations.
type

enum (CustomAudienceType)

Type d'audience personnalisée. ("INTEREST" OR "PURCHASE_INTENT" n'est pas autorisé pour la nouvelle audience personnalisée, mais conservé pour les audiences existantes)
description

string

Description de cette audience personnalisée.
members[]

object (CustomAudienceMember)

Liste des membres de l'audience personnalisée qui compose cette audience. Des membres peuvent être ajoutés lors de la création de CustomAudience. Si les membres sont présentés lors d'une opération UPDATE, les membres existants seront remplacés.

CustomAudienceStatus

Énumération contenant les différents états d'audience personnalisés 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 personnalisée est activée et peut être ciblée.
REMOVED État "Supprimée" : l'audience personnalisée a été supprimée et ne peut pas être utilisée pour le ciblage.

CustomAudienceType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AUTO Google Ads sélectionne automatiquement la meilleure interprétation au moment de la diffusion.
INTEREST Correspond aux utilisateurs en fonction de leurs centres d'intérêt.
PURCHASE_INTENT Met en correspondance les utilisateurs en fonction des sujets qu'ils recherchent ou des produits qu'ils envisagent d'acheter.
SEARCH Correspond aux utilisateurs en fonction de ce qu'ils ont recherché dans la recherche Google.

CustomAudienceMember

Membre de l'audience personnalisée. Un membre peut être un KEYWORD, une URL, une PLACE_CATEGORY ou une APP. Ces éléments peuvent uniquement être créés ou supprimés, mais pas modifiés.

Représentation JSON 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Champs
memberType

enum (CustomAudienceMemberType)

Type de membre d'audience personnalisée : KEYWORD, URL, PLACE_CATEGORY ou APP.
Champ d'union value. Valeur CustomAudienceMember. Un champ est renseigné en fonction du type de membre. value ne peut être qu'un des éléments suivants :
keyword

string

Un mot clé ou une expression de mot clé (10 mots et 80 caractères au maximum). Dans les langues utilisant des caractères double largeur (comme le chinois, le coréen ou le japonais), 40 caractères sont autorisés pour décrire les centres d'intérêt ou les actions de l'utilisateur.
url

string

URL HTTP, à protocole inclus, comportant 2 048 caractères au maximum, incluant les contenus dans lesquels les utilisateurs ont des centres d'intérêt.
placeCategory

string (int64 format)

Type de lieu décrit par la catégorie de lieu que les utilisateurs consultent.
app

string

Nom de package des applications Android installées par les utilisateurs (par exemple, com.google.example).

CustomAudienceMemberType

Énumération contenant les différents types de membres d'audience personnalisés possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
KEYWORD Utilisateurs dont les centres d'intérêt ou les actions sont décrits par un mot clé.
URL Utilisateurs ayant des centres d'intérêt liés au contenu du site Web.
PLACE_CATEGORY Utilisateurs qui consultent des types de lieux décrits par une catégorie de lieu.
APP Utilisateurs ayant installé une application mobile.