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 de ressources d'audience personnalisée se présentent sous la forme suivante:

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. Elle doit être unique pour 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 la compose. Des membres peuvent être ajoutés lors de la création de l'audience personnalisée. Si des membres sont présentés dans l'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é" : 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'audiences personnalisées 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électionnera automatiquement la meilleure interprétation au moment de la diffusion.
INTEREST Recherche les 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 Établit une correspondance entre les utilisateurs et leur recherche sur Google.

CustomAudienceMember

Membre d'une audience personnalisée. Un membre peut être un KEYWORD, une URL, un PLACE_CATEGORY ou une APP. Vous pouvez uniquement le créer ou le supprimer, mais pas le modifier.

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-clé : 10 mots et 80 caractères maximum. Dans les langues utilisant des caractères double largeur (comme le chinois, le coréen ou le japonais), ce champ décrit les centres d'intérêt ou les actions de l'utilisateur à hauteur de 40 caractères.
url

string

URL HTTP, protocole inclus, de 2 048 caractères maximum, incluant le contenu dans lequel les utilisateurs ont des centres d'intérêt.
placeCategory

string (int64 format)

Type de lieu décrit par une catégorie de lieu que les utilisateurs visitent.
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 dont les centres d'intérêt sont liés au contenu du site Web.
PLACE_CATEGORY Utilisateurs qui visitent les types de lieux décrits par une catégorie de lieu.
APP Utilisateurs ayant installé une application mobile.