REST Resource: advertisers

Ressource : Advertiser

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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
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 l'annonceur appartient.
displayName

string

Obligatoire. Nom à afficher de l'annonceur.

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

enum (EntityStatus)

Obligatoire. Indique si les ordres d'insertion et les éléments de campagne de l'annonceur peuvent dépenser leur budget et enchérir sur l'inventaire.

  • Les valeurs acceptées sont ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED et ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Si la valeur est définie sur ENTITY_STATUS_SCHEDULED_FOR_DELETION, l'annonceur sera supprimé 30 jours après la date de suppression initialement prévue.
updateTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
generalConfig

object (AdvertiserGeneralConfig)

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

object (AdvertiserAdServerConfig)

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

object (AdvertiserCreativeConfig)

Obligatoire. Paramètres de l'annonceur liés aux créations.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Paramètres qui contrôlent l'accès aux données des annonceurs.
integrationDetails

object (IntegrationDetails)

Informations d'intégration de l'annonceur. Seul integrationCode s'applique actuellement à l'annonceur. Les autres champs de IntegrationDetails ne sont pas acceptés et seront 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 à Mediaocean (Prisma) est activée. En activant cette fonctionnalité, vous acceptez les conditions suivantes :

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

object (AdvertiserBillingConfig)

Obligatoire. Paramètres de facturation de l'annonceur.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Facultatif. Indique si cet annonceur contient des éléments de campagne qui diffusent des annonces à caractère politique dans l'Union européenne.

Si ce champ est défini sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, voici ce qui se produira :

  • Sauf indication contraire, tout nouvel élément de campagne créé pour cet annonceur sera attribué à DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
  • Tous les éléments de campagne existants de cet annonceur qui n'ont pas de valeur définie seront mis à jour sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING d'ici un jour.
defaultBusinessName

string

Facultatif. Nom d'entreprise par défaut de l'annonceur.

Il s'agit de la valeur utilisée par les annonces YouTube et Demand Gen de cet annonceur si aucun nom d'entreprise n'est fourni.
defaultLogoAssetId

string (int64 format)

Facultatif. ID d'élément de l'image du logo par défaut de l'annonceur.

Il s'agit de l'ID de l'asset qui sera utilisé par les annonces YouTube et Demand Gen de cet annonceur si aucun asset de logo n'est fourni.

Vous devez utiliser advertisers.adAssets.upload pour importer ce composant à l'aide de l'API.

AdvertiserGeneralConfig

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

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

string

Obligatoire. URL du domaine du site Web principal de l'annonceur. Le système enverra ces informations aux éditeurs qui ont besoin de l'URL du site Web pour associer 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 standard de la base de données TZ du fuseau horaire de l'annonceur. Par exemple : America/New_York.

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

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

string

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

Voici les codes acceptés et les devises qu'ils représentent :

Code de la 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 : nouveau 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 d'un annonceur liés à l'ad server.

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Champs
Obligatoire. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Configuration pour les annonceurs qui n'utilisent que des ad servers tiers.
cmHybridConfig

object (CmHybridConfig)

Configuration pour les annonceurs qui utilisent à la fois Campaign Manager 360 (CM360) et des ad servers tiers.
Fin des champs mutuellement exclusifs.

ThirdPartyOnlyConfig

Paramètres réservés 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. Cette valeur ne peut pas être modifiée une fois définie sur true.

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,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Champs
cmAccountId

string (int64 format)

Obligatoire. Immuable. ID 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.
cmAdvertiserIds[]

string (int64 format)

Uniquement en sortie. Ensemble de références annonceur CM360 partageant la configuration Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

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

S'il est absent 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 depuis CM360 risquent d'être supprimées. Vous devez spécifier au moins un site.
dv360ToCmDataSharingEnabled

boolean

Indique si les données DV360 doivent être incluses dans les rapports de transfert de données CM360.
dv360ToCmCostReportingEnabled

boolean

Indique si le coût DV360 doit être indiqué 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 liés aux créations d'un annonceur.

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

string (int64 format)

ID permettant de configurer la surveillance des campagnes, fourni par Integral Ad Science (IAS). Le système DV360 ajoutera un tag IAS "Campaign Monitor" contenant cet ID au tag de création.
obaComplianceDisabled

boolean

Indique si vous souhaitez désactiver la fonctionnalité À propos de cette pub de Google, qui ajoute un badge publicitaire (pour identifier le contenu en tant qu'annonce) et des informations de transparence (via une interaction avec "À propos de cette pub") à vos annonces pour la publicité comportementale en ligne (PCL) et les exigences réglementaires. La page "À propos de cette pub" permet aux utilisateurs de mieux contrôler les annonces qu'ils voient et vous aide à leur expliquer pourquoi ils voient votre annonce. En savoir plus

Si vous choisissez de définir ce champ sur true, notez que les annonces diffusées via Display & Video 360 doivent respecter les conditions suivantes :

  • Être conformes à la publicité comportementale en ligne (PCL), conformément au contrat que vous avez passé avec Google Marketing Platform.
  • Dans l'Espace économique européen (EEE), incluez des informations sur la transparence et un mécanisme permettant aux utilisateurs de signaler les contenus illégaux dans les annonces. Si vous utilisez une autre solution d'identification des publicités par des badges, de transparence et de reporting, vous devez vous assurer qu'elle inclut les informations de transparence requises et le mécanisme de signalement de contenu illégal, et que vous informez Google de tout signalement de contenu illégal à l'aide du formulaire approprié.
dynamicCreativeEnabled

boolean

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

boolean

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

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

AdvertiserDataAccessConfig

Paramètres qui contrôlent la manière dont les données liées à l'annonceur sont accessibles.

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 de fichier de données structurées 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 la configuration SDF de son partenaire parent.

Par défaut, un annonceur hérite de la configuration des fichiers de données structurées 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 SDF pour l'annonceur.

AdvertiserTargetingConfig

Paramètres de ciblage liés à la diffusion des 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.

AdvertiserBillingConfig

Paramètres de facturation d'un annonceur.

Représentation JSON 
{
  "billingProfileId": string
}
Champs
billingProfileId

string (int64 format)

Obligatoire. ID d'un profil de facturation attribué à l'annonceur.

Méthodes

audit

 Audite un annonceur.

create

 Crée un annonceur.

delete

 Supprime un annonceur.

editAssignedTargetingOptions

 Modifie les options de ciblage d'un seul annonceur.

get

 Récupère un annonceur.

list

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

listAssignedTargetingOptions

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

patch

 Met à jour un annonceur existant.