REST Resource: advertisers

Ressource: Annonceur

Un seul annonceur dans Display & Video 360 (DV360)

Représentation JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'annonceur.
advertiserId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'annonceur. Attribué par le système.
partnerId

string (int64 format)

Obligatoire. Immuable. Identifiant unique du partenaire auquel appartient l'annonceur.
displayName

string

Obligatoire. Nom à afficher de l'annonceur.

Doit être encodé au format UTF-8 avec une taille maximale de 240 octets.
entityStatus

enum (EntityStatus)

Obligatoire. Détermine si les ordres d'insertion et les éléments de campagne de l'annonceur peuvent dépenser leurs budgets et définir des enchères sur l'inventaire.

  • Les valeurs acceptées sont ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED et ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Si ce paramètre est défini sur ENTITY_STATUS_SCHEDULED_FOR_DELETION, l'annonceur sera supprimé 30 jours après sa première suppression planifiée.
updateTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière mise à jour de l'annonceur. Attribué par le système.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

Obligatoire. Paramètres généraux de l'annonceur.
adServerConfig

object (AdvertiserAdServerConfig)

Obligatoire. Immuable. Paramètres liés à l'ad server de l'annonceur.
creativeConfig

object (AdvertiserCreativeConfig)

Obligatoire. Paramètres de création de l'annonceur.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Paramètres qui contrôlent le mode d'accès aux données de l'annonceur.
integrationDetails

object (IntegrationDetails)

Détails d'intégration de l'annonceur. Seul integrationCode est actuellement applicable à l'annonceur. Les autres champs de IntegrationDetails ne sont pas acceptés et sont ignorés s'ils sont fournis.
servingConfig

object (AdvertiserTargetingConfig)

Paramètres de ciblage liés à la diffusion d'annonces de l'annonceur.
prismaEnabled

boolean

Indique si l'intégration avec Mediaocean (Prisma) est activée. En activant cette fonctionnalité, vous acceptez ce qui suit:

Au nom de mon entreprise, j'autorise Mediaocean (Prisma) à envoyer des plans de segments de budget à Google. J'autorise également Google à envoyer les rapports et les factures correspondants depuis DV360 à Mediaocean en vue de la planification budgétaire, de la facturation et du rapprochement pour cet annonceur.

AdvertiserGeneralConfig

Paramètres généraux d'un annonceur.

Représentation JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Champs
domainUrl

string

Obligatoire. URL de domaine du site Web principal de l'annonceur. Le système envoie ces informations aux éditeurs qui exigent que l'URL du site Web associe une campagne à un annonceur.

Indiquez une URL sans chemin d'accès ni chaîne de requête, commençant par http: ou https:. Par exemple, http://www.example.com.
timeZone

string

Uniquement en sortie. Nom de la base de données TZ standard du fuseau horaire de l'annonceur. Par exemple, America/New_York.

Pour en savoir plus, consultez la page https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Pour les annonceurs CM360 hybrides, le fuseau horaire est le même que celui du compte CM360 associé. Pour les annonceurs tiers uniquement, il est identique à celui du partenaire parent.
currencyCode

string

Obligatoire. Immuable. Devise de l'annonceur au format ISO 4217.

Les codes et les devises acceptés sont les suivants:

Code de devise : Nom de la devise

  • ARS : peso argentin
  • AUD : dollar australien
  • BRL : Real brésilien
  • CAD : dollar canadien
  • CHF : franc suisse
  • CLP : peso chilien
  • CNY : yuan chinois
  • COP : peso colombien
  • CZK : couronne tchèque
  • DKK : couronne danoise
  • EGP : livre égyptienne
  • EUR : euro
  • GBP : livre sterling
  • HKD : dollar de Hong Kong
  • HUF : forint hongrois
  • IDR : roupie indonésienne
  • ILS : Shekel israélien
  • INR : roupie indienne
  • JPY : yen japonais
  • KRW : won sud-coréen
  • MXN : pesos mexicains
  • MYR : ringgit malaisien
  • NGN : naira nigérian
  • NOK : couronne norvégienne
  • NZD : dollar néo-zélandais
  • PEN : sol péruvien
  • PLN : zloty polonais
  • RON : nouveau leu roumain
  • RUB : rouble russe
  • SEK : couronne suédoise
  • TRY : livre turque
  • TWD : nouveau dollar de Taïwan
  • USD : dollar américain
  • ZAR : rand sud-africain

AdvertiserAdServerConfig

Paramètres liés à l'ad server d'un annonceur.

Représentation JSON 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Champs
Champ d'union ad_server_config_scheme. Obligatoire. ad_server_config_scheme ne peut être qu'un des éléments suivants :
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Configuration destinée aux annonceurs qui utilisent des ad servers tiers uniquement.
cmHybridConfig

object (CmHybridConfig)

Configuration destinée aux annonceurs qui utilisent à la fois Campaign Manager 360 (CM360) et des ad servers tiers.

ThirdPartyOnlyConfig

Paramètres destinés uniquement aux annonceurs qui utilisent des ad servers tiers.

Représentation JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
Champs
pixelOrderIdReportingEnabled

boolean

Indique si la création de rapports sur les ID de commande pour les pixels est activée. Une fois définie sur true, cette valeur ne peut plus être modifiée.

CmHybridConfig

Paramètres pour les annonceurs qui utilisent à la fois Campaign Manager 360 (CM360) et des ad servers tiers.

Représentation JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Champs
cmAccountId

string (int64 format)

Obligatoire. Immuable. Numéro de compte de la configuration Floodlight CM360 associée à l'annonceur DV360.
cmFloodlightConfigId

string (int64 format)

Obligatoire. Immuable. ID de la configuration Floodlight CM360 associée à l'annonceur DV360.
cmSyncableSiteIds[]

string (int64 format)

Liste des sites CM360 dont les emplacements seront synchronisés avec DV360 en tant que créations.

Si cette valeur est absente ou vide dans la méthode advertisers.create, le système crée automatiquement un site CM360.

Si vous supprimez des sites de cette liste, les créations DV360 synchronisées à partir de CM360 risquent d'être supprimées. Vous devez spécifier au moins un site.
dv360ToCmDataSharingEnabled

boolean

Permet d'inclure ou non les données DV360 dans les rapports sur les transferts de données CM360.
dv360ToCmCostReportingEnabled

boolean

Indique si le coût DV360 doit être enregistré dans CM360.
cmFloodlightLinkingAuthorized

boolean

Obligatoire. Immuable. En définissant ce champ sur true, vous autorisez, au nom de votre entreprise, le partage des informations de la configuration Floodlight donnée avec cet annonceur Display & Video 360.

AdvertiserCreativeConfig

Paramètres des créations d'un annonceur.

Représentation JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Champs
iasClientId

string (int64 format)

ID de configuration du contrôle des campagnes fourni par Integral Ad Service (IAS). Le système DV360 ajoutera au tag de la création un tag "Contrôle de campagne" IAS contenant cet ID.
obaComplianceDisabled

boolean

Indique si la conformité avec la publicité comportementale en ligne de DV360 doit être respectée.

Avertissement: La modification des paramètres de publicité comportementale en ligne peut entraîner la réinitialisation de l'état d'audit de vos créations par certaines places de marché. Elles ne pourront donc pas être diffusées tant qu'elles n'auront pas été de nouveau approuvées.
dynamicCreativeEnabled

boolean

Indique si les créations dynamiques sont activées pour l'annonceur.
videoCreativeDataSharingAuthorized

boolean

En définissant ce champ sur true, vous autorisez, au nom de votre entreprise, à utiliser des créations vidéo associées à cet annonceur Display & Video 360 afin de fournir des rapports et des fonctionnalités concernant ses campagnes télévisées.

Applicable uniquement lorsque l'annonceur dispose d'une configuration d'ad server CM360 hybrid.

AdvertiserDataAccessConfig

Paramètres qui contrôlent le mode d'accès aux données associées aux annonceurs.

Représentation JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Champs
sdfConfig

object (AdvertiserSdfConfig)

Paramètres des fichiers de données structurées (SDF) pour l'annonceur.

Si aucune valeur n'est spécifiée, les paramètres SDF du partenaire parent sont utilisés.

AdvertiserSdfConfig

Paramètres des fichiers de données structurées (SDF) d'un annonceur.

Représentation JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Champs
overridePartnerSdfConfig

boolean

Indique si cet annonceur remplace ou non la configuration SDF de son partenaire parent.

Par défaut, un annonceur hérite de la configuration de fichiers SDF du partenaire parent. Pour remplacer la configuration du partenaire, définissez ce champ sur true et indiquez la nouvelle configuration dans sdfConfig.
sdfConfig

object (SdfConfig)

Configuration de fichiers SDF pour l'annonceur.

AdvertiserTargetingConfig

Paramètres de ciblage liés à la diffusion d'annonces d'un annonceur.

Représentation JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Champs
exemptTvFromViewabilityTargeting

boolean

Indique si les appareils pour la télévision connectée sont exemptés du ciblage en fonction de la visibilité pour tous les éléments de campagne vidéo de l'annonceur.

Méthodes

audit

 Audite un annonceur.

bulkEditAdvertiserAssignedTargetingOptions

 Modifier les options de ciblage de manière groupée pour un même annonceur

bulkListAdvertiserAssignedTargetingOptions

 Liste les options de ciblage attribuées d'un annonceur pour tous les types de ciblage.

create

 Crée un annonceur.

delete

 Supprime un annonceur.

get

 Récupère un annonceur.

list

 Liste les annonceurs auxquels l'utilisateur actuel peut accéder.

patch

 Met à jour un annonceur existant.