REST Resource: advertisers.creatives

Ressource : Creative

Une seule création.

Représentation JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
Champs
name

string

Uniquement en sortie. Nom de ressource de la création.
advertiserId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'annonceur auquel appartient la création.
creativeId

string (int64 format)

Uniquement en sortie. Identifiant unique de la création. Attribué par le système.
cmPlacementId

string (int64 format)

Uniquement en sortie. ID unique de l'emplacement Campaign Manager 360 associé à la création. Ce champ ne s'applique qu'aux créations synchronisées à partir de Campaign Manager.
displayName

string

Obligatoire. Nom à afficher de la création.

Doit être encodé au format UTF-8 et ne pas dépasser 240 octets.
entityStatus

enum (EntityStatus)

Obligatoire. Détermine si la création peut être diffusée.

Les valeurs acceptées sont les suivantes :

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de la création, effectuée par l'utilisateur ou le système (par exemple, lors de l'examen de la création). 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".
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la création de la création. 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".
creativeType

enum (CreativeType)

Obligatoire. Immuable. Type de création.
hostingSource

enum (HostingSource)

Obligatoire. Indique où la création est hébergée.
dynamic

boolean

Uniquement en sortie. Indique si la création est dynamique.
dimensions

object (Dimensions)

Obligatoire. Dimensions principales de la création. Applicable à tous les types de créations. La valeur de widthPixels et heightPixels est définie sur 0 par défaut lorsque creativeType est l'une des valeurs suivantes :

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Facultatif. Dimensions supplémentaires. Applicable lorsque creativeType est l'une des valeurs suivantes :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Si ce champ est spécifié, widthPixels et heightPixels sont tous deux obligatoires et doivent être supérieurs ou égaux à 0.
mediaDuration

string (Duration format)

Uniquement en sortie. Durée du support de la création. Applicable lorsque creativeType est l'une des valeurs suivantes :

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
creativeAttributes[]

enum (CreativeAttribute)

Uniquement en sortie. Liste des attributs de la création générée par le système.
reviewStatus

object (ReviewStatusInfo)

Uniquement en sortie. État actuel du processus d'examen de la création.
assets[]

object (AssetAssociation)

Obligatoire. Éléments associés à cette création.
exitEvents[]

object (ExitEvent)

Obligatoire. Événements de sortie pour cette création. Une sortie (également appelée "tag de clic") est une zone de votre création sur laquelle un utilisateur peut cliquer ou appuyer pour ouvrir la page de destination d'un annonceur. Chaque création doit inclure au moins une sortie. Vous pouvez ajouter une sortie à votre création de différentes manières :

  • Utilisez la zone cliquable de Google Web Designer.
  • Définissez une variable JavaScript appelée "clickTag".
  • Utilisez le composant Enabler (Enabler.exit()) pour suivre les sorties dans les formats rich media.
timerEvents[]

object (TimerEvent)

Facultatif. Événements personnalisés de minuteur pour une création rich media. Les minuteurs suivent la durée pendant laquelle un utilisateur voit une création rich media et interagit avec une partie spécifique de celle-ci. Une création peut inclure plusieurs événements de minuteur indépendants les uns des autres. Laissez ce champ vide ou non défini pour les créations contenant uniquement des composants Image.
counterEvents[]

object (CounterEvent)

Facultatif. Événements de compteur pour une création rich media. Les compteurs permettent de suivre le nombre de fois qu'un utilisateur interagit avec n'importe quelle partie d'une création rich media d'une façon spécifiée (passages du curseur de la souris, sorties du curseur, clics, appuis, chargement de données, saisies, etc.). Tout événement pouvant être capturé dans la création peut être enregistré comme un compteur. Laissez ce champ vide ou non défini pour les créations contenant uniquement des composants Image.
appendedTag

string

Facultatif. Tag de suivi HTML tiers à ajouter au tag de création.
integrationCode

string

Facultatif. Informations d'identification utilisées pour associer cette création à un système externe. Doit être encodé au format UTF-8 et ne pas dépasser 10 000 caractères.
notes

string

Facultatif. Notes de l'utilisateur pour cette création. Doit être encodé au format UTF-8 et ne pas dépasser 20 000 caractères.
iasCampaignMonitoring

boolean

Facultatif. Indique si la surveillance des campagnes Integral Ad Science (IAS) est activée. Pour l'activer pour la création, assurez-vous que Advertiser.creative_config.ias_client_id a été défini sur votre ID client IAS.
companionCreativeIds[]

string (int64 format)

Facultatif. ID des créations associées à une création vidéo.

Vous pouvez attribuer des créations display existantes (avec des composants image ou HTML5) à diffuser autour du lecteur vidéo de l'éditeur. Les créations associées s'affichent autour du lecteur vidéo pendant la lecture de la vidéo et restent en place une fois la vidéo terminée.

Les créations contenant additional dimensions ne peuvent pas être des créations associées.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Facultatif. Indique si l'utilisateur peut choisir d'ignorer une création vidéo.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Facultatif. Durée de lecture requise pour que le bouton "Ignorer" s'affiche sur la vidéo.

Ce champ est obligatoire lorsque skippable est défini sur "true".

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Facultatif. Durée de lecture requise pour qu'une vue soit comptabilisée.

Ce champ est obligatoire lorsque skippable est défini sur "true".

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Facultatif. Identifiant de création facultatif fourni par un registre et unique sur toutes les plates-formes.

L'identifiant d'annonce universel fait partie de la norme VAST 4.0. Vous pouvez le modifier après la création de la création.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Facultatif. URL de suivi tierces permettant de suivre les interactions avec une création vidéo.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Uniquement en sortie. Transcodages audio/vidéo.

Display & Video 360 transcode l'asset principal en plusieurs versions alternatives qui utilisent différents formats de fichier ou ont différentes propriétés (résolution, débit audio et débit vidéo). Chaque version est conçue pour des lecteurs vidéo ou des bandes passantes spécifiques.

Ces transcodages offrent au système d'un éditeur plus d'options pour chaque impression sur votre vidéo et garantissent que le fichier approprié est diffusé en fonction de la connexion et de la taille de l'écran du spectateur.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Facultatif. URL de suivi pour les fournisseurs de services d'analyse ou les fournisseurs de technologies publicitaires tiers.

Les URL doivent commencer par https: (sauf pour l'inventaire qui ne nécessite pas la conformité SSL). Si vous insérez des macros dans votre URL, utilisez uniquement les macros acceptées dans Display & Video 360.

URL standards uniquement, les tags IMG et SCRIPT ne sont pas acceptés.

Ce champ n'est accessible en écriture que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Facultatif. URL de mesure JavaScript provenant de fournisseurs de validation tiers acceptés (ComScore, DoubleVerify, IAS, Moat). Les balises de script HTML ne sont pas acceptées.

Ce champ n'est accessible en écriture que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Facultatif. Annonce de suivi Campaign Manager 360 associée à la création.

Facultatif pour les creativeType suivants lorsqu'ils sont créés par un annonceur qui utilise à la fois Campaign Manager 360 et la diffusion d'annonces par des tiers :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Uniquement en sortie pour les autres cas.
obaIcon

object (ObaIcon)

Facultatif. Spécifie l'icône de publicité comportementale en ligne pour une création vidéo.

Ce champ n'est compatible qu'avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Facultatif. Balise tierce d'origine utilisée pour la création.

Obligatoire et valide uniquement pour les créations avec balises tierces.

Les créations avec tag tiers sont des créations avec les éléments suivants : hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Facultatif. Indique que la création nécessite le système MRAID (Mobile Rich Media Ad Interface Definitions).

Définissez cette option si la création repose sur des gestes mobiles pour l'interactivité, comme le balayage ou le geste d'appui.

Facultatif et uniquement valide pour les créations de balises tierces.

Les créations avec tag tiers sont des créations avec les éléments suivants : hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Facultatif. Indique que la création ne peut être affichée correctement qu'au moyen de la technologie HTML5.

Facultatif et uniquement valide pour les créations de balises tierces. Les créations avec tag tiers sont des créations avec les éléments suivants : hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Facultatif. Indique que la création attendra un ping de retour pour l'attribution.

Valide uniquement lorsque vous utilisez une annonce de suivi Campaign Manager 360 avec un paramètre d'ad server tiers et la macro ${DC_DBM_TOKEN}.

Facultatif et uniquement valide pour les créations de tags tiers ou les créations de tags VAST tiers.

Les créations avec tag tiers sont des créations avec les éléments suivants : hostingSource

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Les créations de tags VAST tiers sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Facultatif. Spécifie la direction d'expansion de la création.

Obligatoire et uniquement valide pour les créations extensibles tierces.

Les créations extensibles tierces sont des créations dont la source d'hébergement est la suivante :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Facultatif. Indique que la création se développera automatiquement au passage de la souris.

Facultatif et uniquement valide pour les créations extensibles tierces. Les créations extensibles tierces sont des créations dont la source d'hébergement est la suivante :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Facultatif. URL du tag VAST pour une création de tag VAST tierce.

Obligatoire et valide uniquement pour les créations de tags VAST tiers.

Les créations de tags VAST tiers sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Uniquement en sortie. Indique que la création du tag VAST tiers nécessite VPAID (Digital Video Player-Ad Interface).

Sortie uniquement et uniquement valide pour les créations de tag VAST tiers.

Les créations de tags VAST tiers sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Uniquement en sortie. Indique que la création de tag VAST tierce nécessite la compatibilité avec la vidéo HTML5.

Sortie uniquement et uniquement valide pour les créations de tag VAST tiers.

Les créations de tags VAST tiers sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Uniquement en sortie. ID des éléments de campagne auxquels cette création est associée.

Pour associer une création à un élément de campagne, utilisez plutôt LineItem.creative_ids.
mp3Audio

boolean

Uniquement en sortie. Indique que la création audio tierce est compatible avec le format MP3.

Uniquement en sortie et uniquement valide pour les créations audio tierces.

Les créations audio tierces sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Uniquement en sortie. Indique que la création audio tierce est compatible avec le format OGG.

Uniquement en sortie et uniquement valide pour les créations audio tierces.

Les créations audio tierces sont des créations avec les hostingSource suivants :

  • HOSTING_SOURCE_THIRD_PARTY

combiné avec les creativeType suivants :

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

Facultatif. Indique si un libellé doit être ajouté à la création pour indiquer qu'elle a été conçue ou modifiée avec l'IA lorsqu'elle est diffusée dans des régions où des réglementations locales sur les libellés IA sont en vigueur.

HostingSource

Sources d'hébergement possibles pour une création. Indique où une création est créée et hébergée.

Enums
HOSTING_SOURCE_UNSPECIFIED La source d'hébergement n'est pas spécifiée ou est inconnue dans cette version.
HOSTING_SOURCE_CM

Création synchronisée à partir de Campaign Manager 360.

Les méthodes de création et de mise à jour ne sont pas compatibles avec ce type d'hébergement.
HOSTING_SOURCE_THIRD_PARTY

Création hébergée par un ad server tiers (3PAS).

Les méthodes de création et de mise à jour sont acceptées pour ce type d'hébergement si le creativeType est l'un des suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Création créée dans DV360 et hébergée par Campaign Manager 360.

Les méthodes de création et de mise à jour sont acceptées pour ce type d'hébergement si le creativeType est l'un des suivants :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Création rich media créée dans Studio et hébergée par Campaign Manager 360.

Les méthodes de création et de mise à jour ne sont pas compatibles avec ce type d'hébergement.

CreativeAttribute

Attributs possibles d'une création.

Enums
CREATIVE_ATTRIBUTE_UNSPECIFIED L'attribut de création n'est pas spécifié ou est inconnu dans cette version.
CREATIVE_ATTRIBUTE_VAST La création est une création VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR La création est une création VPAID linéaire.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR La création est une création VPAID non linéaire.

ReviewStatusInfo

États de l'examen de la création.

Représentation JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
Champs
approvalStatus

enum (ApprovalStatus)

Représente l'approbation de base nécessaire pour qu'une création commence à être diffusée. Résumé de creativeAndLandingPageReviewStatus et contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

État de l'examen de la création et de sa page de destination.
contentAndPolicyReviewStatus

enum (ReviewStatus)

État de la vérification du contenu et du respect des règles pour la création.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

États de l'examen de la création sur les places de marché.

ApprovalStatus

Types possibles d'état d'approbation. Il s'agit du résumé de creativeAndLandingPageReviewStatus et contentAndPolicyReviewStatus.

Enums
APPROVAL_STATUS_UNSPECIFIED La valeur du type n'est pas spécifiée ou est inconnue dans cette version.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La création est toujours en cours d'examen et ne peut pas être diffusée.
APPROVAL_STATUS_PENDING_SERVABLE La création a été approuvée après examen de la création et de la page de destination, et peut être diffusée. Toutefois, elle est en attente d'un examen supplémentaire du contenu et des règles.
APPROVAL_STATUS_APPROVED_SERVABLE L'examen des créations et des pages de destination, ainsi que celui du contenu et du respect des règles sont approuvés. La création peut être diffusée.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Vous devez corriger un problème lié à la création pour pouvoir la diffuser.

ReviewStatus

Types possibles d'état de l'examen.

Enums
REVIEW_STATUS_UNSPECIFIED La valeur du type n'est pas spécifiée ou est inconnue dans cette version.
REVIEW_STATUS_APPROVED La création est approuvée.
REVIEW_STATUS_REJECTED La création est refusée.
REVIEW_STATUS_PENDING La création est en attente d'examen.

ExchangeReviewStatus

État de l'examen de la création sur la place de marché.

Représentation JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Champs
exchange

enum (Exchange)

Échange qui examine la création.
status

enum (ReviewStatus)

État de l'examen de l'échange.

AssetAssociation

Association de composants pour la création.

Représentation JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Champs
asset

object (Asset)

Facultatif. Élément associé.
role

enum (AssetRole)

Facultatif. Rôle de cet élément pour la création.

Élément

Un seul composant.

Représentation JSON 
{
  "mediaId": string,
  "content": string
}
Champs
mediaId

string (int64 format)

ID du contenu multimédia de l'élément importé. Il s'agit de l'identifiant unique du composant. Cet ID peut être transmis à d'autres appels d'API, par exemple creatives.create, pour associer le composant à une création.

L'espace d'ID de contenu multimédia a été mis à jour le 5 avril 2023. Mettez à jour les ID de contenus multimédias mis en cache avant le 5 avril 2023 en récupérant le nouvel ID de contenu multimédia à partir des ressources de création associées ou en réimportant le composant.
content

string

Contenu du composant. Pour les composants importés, le contenu correspond au chemin de diffusion.

AssetRole

Rôle de cet élément pour la création.

Enums
ASSET_ROLE_UNSPECIFIED Le rôle de l'élément n'est pas spécifié ou est inconnu dans cette version.
ASSET_ROLE_MAIN L'asset est l'asset principal de la création.
ASSET_ROLE_BACKUP L'asset est un asset de back-up de la création.
ASSET_ROLE_POLITE_LOAD L'asset est un asset de chargement poli de la création.
ASSET_ROLE_HEADLINE

Titre d'une création native.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 25 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Titre long d'une création native.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 50 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Corps du texte d'une création native.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 90 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Corps du texte long d'une création native.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 150 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Version courte et conviviale de l'URL de la page de destination à afficher dans la création. Cette URL donne aux utilisateurs une idée de la page vers laquelle ils seront redirigés s'ils cliquent sur la création.

L'élément content doit être encodé au format UTF-8 et ne doit pas comporter plus de 30 caractères.

Par exemple, si l'URL de la page de destination est "http://www.example.com/page", l'URL à afficher peut être "example.com". Le protocole (http://) est facultatif, mais l'URL ne peut pas contenir d'espaces ni de caractères spéciaux.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Texte à utiliser sur le bouton d'incitation à l'action d'une création native.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 15 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Texte permettant d'identifier l'annonceur ou le nom de la marque.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 25 caractères.

Ce rôle n'est disponible que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Le prix d'achat de votre application sur le Google Play Store ou l'App Store iOS (par exemple, 5,99 $).

Notez que cette valeur n'est pas automatiquement synchronisée avec la valeur réelle indiquée dans le magasin. Il s'agira toujours de celui fourni lors de l'enregistrement de la création.

L'élément content doit être encodé au format UTF-8 et ne doit pas dépasser 15 caractères.

Les composants de ce rôle sont en lecture seule.
ASSET_ROLE_ANDROID_APP_ID

ID d'une application Android sur le Google Play Store.

Vous trouverez cet ID dans l'URL Google Play Store de l'application, après "id". Par exemple, dans https://play.google.com/store/apps/details?id=com.company.appname, l'identifiant est com.company.appname.

Les composants de ce rôle sont en lecture seule.
ASSET_ROLE_IOS_APP_ID

ID d'une application iOS sur l'App Store d'Apple.

Ce numéro d'identification se trouve dans l'URL de l'Apple App Store. Il s'agit de la chaîne de chiffres qui suit directement "id". Par exemple, dans https://apps.apple.com/us/app/gmail-email-by-google/id422689480, l'ID est 422689480.

Les composants de ce rôle sont en lecture seule.
ASSET_ROLE_RATING

Évaluation d'une application sur le Google Play Store ou l'App Store iOS.

Notez que cette valeur n'est pas automatiquement synchronisée avec la note réelle dans le magasin. Il s'agira toujours de celui fourni lors de l'enregistrement de la création.

Les composants de ce rôle sont en lecture seule.
ASSET_ROLE_ICON

Icône d'une création.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Image de couverture d'une création vidéo native.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Couleur principale à utiliser dans une création.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Couleur d'accentuation à utiliser dans une création.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Indique si la création doit utiliser un composant Image.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Indique si des améliorations de composants peuvent être appliquées à la création.

Ce rôle n'est compatible et requis que dans les creativeType suivants :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Événement de sortie de la création.

Représentation JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Champs
type

enum (ExitEventType)

Obligatoire. Type d'événement de sortie.
url

string

Obligatoire. URL de destination de l'événement de sortie. Cette étape est obligatoire lorsque type est :

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Facultatif. Nom du tag de clic de l'événement de sortie.

Le nom doit être unique dans une même création.

Laissez ce champ vide ou non défini pour les créations contenant uniquement des composants Image.
reportingName

string

Facultatif. Nom utilisé pour identifier cet événement dans les rapports. Laissez ce champ vide ou non défini pour les créations contenant uniquement des composants Image.

ExitEventType

Type d'événement de sortie.

Enums
EXIT_EVENT_TYPE_UNSPECIFIED Le type d'événement de sortie n'est pas spécifié ou est inconnu dans cette version.
EXIT_EVENT_TYPE_DEFAULT L'événement de sortie est celui par défaut.
EXIT_EVENT_TYPE_BACKUP L'événement de sortie est un événement de sortie de secours. Une création peut comporter plusieurs événements de sortie de secours.

TimerEvent

Événement de minuteur de la création.

Représentation JSON 
{
  "name": string,
  "reportingName": string
}
Champs
name

string

Obligatoire. Nom de l'événement de minuteur.
reportingName

string

Obligatoire. Nom utilisé pour identifier cet événement de minuteur dans les rapports.

CounterEvent

Événement de compteur de la création.

Représentation JSON 
{
  "name": string,
  "reportingName": string
}
Champs
name

string

Obligatoire. Nom de l'événement de compteur.
reportingName

string

Obligatoire. Nom utilisé pour identifier cet événement de compteur dans les rapports.

AudioVideoOffset

Durée de lecture d'un contenu audio ou vidéo.

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
Champs
Valeur du décalage. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
percentage

string (int64 format)

Facultatif. Décalage en pourcentage de la durée de l'élément audio ou vidéo.
seconds

string (int64 format)

Facultatif. Décalage en secondes par rapport au début de l'élément audio ou vidéo.
Fin des champs qui s'excluent mutuellement.

UniversalAdId

Identifiant de création fourni par un registre et unique sur toutes les plates-formes. Cela fait partie de la norme VAST 4.0.

Représentation JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Champs
id

string

Facultatif. Identifiant unique de la création.
registry

enum (UniversalAdRegistry)

Facultatif. Le registre fournit des identifiants uniques pour les créations.

UniversalAdRegistry

Le registre fournit des identifiants de création uniques dans un identifiant d'annonce universel.

Enums
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Le registre des annonces universelles n'est pas spécifié ou est inconnu dans cette version.
UNIVERSAL_AD_REGISTRY_OTHER Utilisez un fournisseur personnalisé pour fournir l'identifiant d'annonce universel.
UNIVERSAL_AD_REGISTRY_AD_ID Utilisez Ad-ID pour fournir l'identifiant d'annonce universel.
UNIVERSAL_AD_REGISTRY_CLEARCAST Utilisez clearcast.co.uk pour fournir l'identifiant d'annonce universel.
UNIVERSAL_AD_REGISTRY_DV360 Utilisez Display & Video 360 pour fournir l'identifiant d'annonce universel.
UNIVERSAL_AD_REGISTRY_CM Utilisez Campaign Manager 360 pour fournir l'identifiant d'annonce universel.

ThirdPartyUrl

URL de suivi tierces permettant de suivre les interactions avec une création audio ou vidéo.

Représentation JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Champs
type

enum (ThirdPartyUrlType)

Facultatif. Le type d'interaction doit être suivi par l'URL de suivi.
url

string

Facultatif. URL de suivi utilisée pour suivre l'interaction.

Indiquez une URL avec un chemin d'accès ou une chaîne de requête facultatifs, commençant par https:. Par exemple, https://www.example.com/path.

ThirdPartyUrlType

Le type d'interaction doit être suivi par l'URL de suivi tierce.

Enums
THIRD_PARTY_URL_TYPE_UNSPECIFIED Le type d'URL tierce n'est pas spécifié ou est inconnu dans cette version.
THIRD_PARTY_URL_TYPE_IMPRESSION Permet de comptabiliser les impressions de la création une fois la mise en mémoire tampon de l'élément audio ou vidéo terminée.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Utilisé pour suivre les clics des utilisateurs sur l'élément audio ou la vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Permet de comptabiliser le nombre de fois où un utilisateur lance l'élément audio ou vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Permet de comptabiliser le nombre de fois où le contenu audio ou vidéo est lu jusqu'à 25% de sa durée.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Permet de comptabiliser le nombre de fois où le contenu audio ou vidéo est lu jusqu'à 50% de sa durée.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Permet de comptabiliser le nombre de fois où le contenu audio ou vidéo est lu jusqu'à 75% de sa durée.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Permet de comptabiliser le nombre de fois où le contenu audio ou vidéo est lu dans son intégralité.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Permet de comptabiliser le nombre de fois où un utilisateur coupe le son de l'élément audio ou vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Permet de comptabiliser le nombre de fois où un utilisateur met en pause l'élément audio ou vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Permet de comptabiliser le nombre de fois où un utilisateur relance la lecture de l'élément audio ou vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Permet de comptabiliser le nombre de fois où l'internaute affiche le lecteur en plein écran.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Permet de comptabiliser le nombre de fois où un utilisateur arrête l'élément audio ou vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Permet de comptabiliser le nombre de fois où l'internaute effectue un clic personnalisé, comme un clic sur une zone réactive vidéo.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Permet de comptabiliser le nombre de fois où l'élément audio ou vidéo a été ignoré.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Permet de suivre le nombre de fois où l'élément audio ou vidéo est lu jusqu'à un décalage déterminé par progressOffset.

Transcodage

Représente des informations sur le fichier audio ou vidéo transcodé.

Représentation JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Champs
name

string

Facultatif. Nom du fichier transcodé.
mimeType

string

Facultatif. Type MIME du fichier transcodé.
transcoded

boolean

Facultatif. Indique si le transcodage a réussi.
dimensions

object (Dimensions)

Facultatif. Dimensions de la vidéo transcodée.
bitRateKbps

string (int64 format)

Facultatif. Débit de transcodage de la vidéo transcodée, en kilobits par seconde.
frameRate

number

Facultatif. Fréquence d'images de la vidéo transcodée, en images par seconde.
audioBitRateKbps

string (int64 format)

Facultatif. Débit du flux audio de la vidéo transcodée ou de l'audio transcodé, en kilobits par seconde.
audioSampleRateHz

string (int64 format)

Facultatif. Taux d'échantillonnage (en hertz) du flux audio de la vidéo transcodée ou de l'audio transcodé.
fileSizeBytes

string (int64 format)

Facultatif. Taille du fichier transcodé, en octets.

CmTrackingAd

Annonce de suivi Campaign Manager 360

Représentation JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Champs
cmPlacementId

string (int64 format)

Facultatif. ID de l'emplacement de l'annonce de suivi Campaign Manager 360.
cmCreativeId

string (int64 format)

Facultatif. ID de la création de l'annonce de suivi Campaign Manager 360.
cmAdId

string (int64 format)

Facultatif. ID de l'annonce de suivi Campaign Manager 360.

ObaIcon

Icône PCL pour une création

Représentation JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Champs
resourceUrl

string

Facultatif. URL de la ressource de l'icône de publicité comportementale en ligne.
resourceMimeType

string

Facultatif. Type MIME de la ressource d'icône OBA.
position

enum (ObaIconPosition)

Facultatif. Position de l'icône PCL dans la création.
dimensions

object (Dimensions)

Facultatif. Dimensions de l'icône PCL.
program

string

Facultatif. Programme de l'icône PCL. Par exemple, « Choisir sa pub ».
landingPageUrl

string

Obligatoire. URL de la page de destination de l'icône de publicité comportementale en ligne.

Seules les URL des domaines suivants sont autorisées :

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

Obligatoire. URL de suivi des clics de l'icône de publicité comportementale en ligne.

Seules les URL des domaines suivants sont autorisées :

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

Obligatoire. URL de suivi des vues de l'icône OBA.

Seules les URL des domaines suivants sont autorisées :

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

Position de l'icône PCL dans la création.

Enums
OBA_ICON_POSITION_UNSPECIFIED La position de l'icône PCL n'est pas spécifiée.
OBA_ICON_POSITION_UPPER_RIGHT En haut à droite de la création.
OBA_ICON_POSITION_UPPER_LEFT En haut à gauche de la création.
OBA_ICON_POSITION_LOWER_RIGHT En bas à droite de la création.
OBA_ICON_POSITION_LOWER_LEFT En bas à gauche de la création.

ExpandingDirection

Direction d'expansion de la création extensible tierce.

Enums
EXPANDING_DIRECTION_UNSPECIFIED La direction d'expansion n'est pas spécifiée.
EXPANDING_DIRECTION_NONE Ne se développe dans aucune direction.
EXPANDING_DIRECTION_UP Expansion vers le haut.
EXPANDING_DIRECTION_DOWN Développe vers le bas.
EXPANDING_DIRECTION_LEFT Développe vers la gauche.
EXPANDING_DIRECTION_RIGHT Expansion vers la droite.
EXPANDING_DIRECTION_UP_AND_LEFT Se développe vers le haut et vers la gauche.
EXPANDING_DIRECTION_UP_AND_RIGHT Il se développe vers le haut et vers la droite.
EXPANDING_DIRECTION_DOWN_AND_LEFT Se développe vers le bas et vers la gauche.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Il se développe vers le bas et vers la droite.
EXPANDING_DIRECTION_UP_OR_DOWN L'expansion se fait vers le haut ou vers le bas.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Elle se développe vers la gauche ou vers la droite.
EXPANDING_DIRECTION_ANY_DIAGONAL Peut s'étendre dans n'importe quelle direction diagonale.

Méthodes

create

 Crée une création.

delete

 Supprime une création.

get

 Récupère une création.

list

 Liste les créations d'un annonceur.

patch

 Met à jour une création existante.