REST Resource: advertisers.creatives

{
  "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
}

string

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

string (int64 format)

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

string (int64 format)

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

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.

string

Obligatoire. Nom à afficher de la création.

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

enum (EntityStatus)

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

Les valeurs acceptées sont les suivantes :

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière mise à jour de la création, par l'utilisateur ou le système (examen des créations, par exemple). Attribué par le système.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Uniquement en sortie. Horodatage de l'élaboration de la création. Attribué par le système.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

enum (CreativeType)

Obligatoire. Immuable. Type de la création.

enum (HostingSource)

Obligatoire. Indique l'emplacement où la création est hébergée.

boolean

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

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 par défaut sur 0 lorsque creativeType correspond à l'une des valeurs suivantes:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Dimensions)

Dimensions supplémentaires. Applicable lorsque creativeType correspond à 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é, les champs widthPixels et heightPixels sont tous les deux obligatoires et doivent être supérieurs ou égaux à 0.

string (Duration format)

Uniquement en sortie. Durée du média de la création. Applicable lorsque creativeType correspond à 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"

enum (CreativeAttribute)

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

object (ReviewStatusInfo)

Uniquement en sortie. État actuel du processus d'examen des créations.

object (AssetAssociation)

Obligatoire. Assets associés à cette création.

object (ExitEvent)

Obligatoire. Événements de sortie pour cette création Une sortie (ou "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 l'une des manières suivantes:

• Utilisez la zone cliquable de Google Web Designer.
• Définissez une variable JavaScript appelée "clickTAG".
• Utilisez l'activateur (Enabler.exit()) pour effectuer le suivi des sorties aux formats rich media.

object (TimerEvent)

Événements personnalisés de minuteur pour une création rich media. Les minuteurs permettent de comptabiliser la durée pendant laquelle un internaute affiche une partie spécifique d'une création rich media et interagit avec celle-ci. Une création peut comporter plusieurs événements de minuteur, chacun d'entre eux étant programmé indépendamment. Laissez-la vide ou n'est pas configurée pour les créations contenant uniquement des composants Image.

object (CounterEvent)

Événements de compteur pour une création rich media. Les compteurs comptabilisent le nombre de fois où un internaute interagit avec n'importe quelle partie d'une création rich media d'une manière spécifiée (survols et sorties du curseur, clics, appuis, chargement de données, saisies, etc.). Tout événement susceptible d'être capturé dans la création peut être enregistré en tant que compteur. Laissez-la vide ou n'est pas configurée pour les créations contenant uniquement des composants Image.

string

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

string

Identifiant utilisé pour associer la création à un système externe. Il doit être encodé au format UTF-8 et ne pas dépasser 10 000 caractères.

string

Remarques d'utilisateurs pour cette création. Il doit être encodé au format UTF-8 et ne pas dépasser 20 000 caractères.

boolean

Indique si le contrôle des campagnes Integral Ad Science (IAS) est activé. Pour activer cette fonctionnalité pour la création, assurez-vous que Advertiser.creative_config.ias_client_id a été défini sur votre ID client IAS.

string (int64 format)

ID des créations associées d'une création vidéo.

Vous pouvez attribuer des créations display existantes (incluant des images ou des assets 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 des 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

boolean

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

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

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durée de lecture de la vidéo avant que le bouton "Ignorer" ne s'affiche.

Ce champ est obligatoire lorsque la valeur de skippable est "true".

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

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durée de lecture de la vidéo avant de comptabiliser une vue.

Ce champ est obligatoire lorsque la valeur de skippable est "true".

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

• CREATIVE_TYPE_VIDEO

object (UniversalAdId)

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

L'identifiant d'annonce universel est inclus dans la norme VAST 4.0. Vous pourrez le modifier une fois la création générée.

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

• CREATIVE_TYPE_VIDEO

object (ThirdPartyUrl)

URL de suivi tierces permettant d'effectuer le suivi des interactions avec une création vidéo.

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

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Transcode)

Uniquement en sortie. Transcodages audio/vidéo

Display & Video 360 transcode l'élément principal en plusieurs versions alternatives utilisant différents formats de fichier ou 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 de l'éditeur un choix plus large d'options pour chaque impression de votre vidéo. De plus, le fichier approprié est diffusé en fonction de la connexion de l'internaute et de la taille de son écran.

Ce champ n'est accepté que dans les creativeType suivants:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO
• CREATIVE_TYPE_AUDIO

string

URL de suivi de fournisseurs de solutions d'analyse ou de fournisseurs de technologies publicitaires tiers

Les URL doivent commencer par "https" (sauf pour l'inventaire qui n'exige pas la conformité avec la norme SSL). Si vous insérez des macros dans votre URL, veillez à ce qu'elles soient compatibles avec Display & Video 360.

URL standards uniquement, pas de tags IMAGE ou SCRIPT.

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

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE
• CREATIVE_TYPE_NATIVE_VIDEO

string

URL de mesure JavaScript des fournisseurs de validation tiers compatibles (ComScore, DoubleVerify, IAS, Moat). Les tags de script HTML 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

object (CmTrackingAd)

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

Facultatif pour les éléments creativeType suivants, lorsqu'ils sont créés par un annonceur qui utilise à la fois Campaign Manager 360 et le système de diffusion d'annonces tiers:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE

Résultat uniquement pour les autres cas.

object (ObaIcon)

Indique l'icône PCL d'une création vidéo.

Ce champ n'est accepté que dans les creativeType suivants:

• CREATIVE_TYPE_VIDEO

string

Facultatif. Tag tiers d'origine utilisé pour la création.

Obligatoire et valide uniquement pour les créations de type "Tag tiers".

Les créations associées à des tags tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

Facultatif. Indique que la création nécessite la norme MRAID (Mobile Rich Media Ad Interface Definitions).

Définissez ce paramètre si la création implique des gestes d'interaction (s'il est nécessaire de balayer l'écran ou d'appuyer dessus, par exemple).

Facultatif et valide uniquement pour les créations utilisant des tags tiers.

Les créations associées à des tags tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

Facultatif. Indique que la création n'est basée que sur HTML5 pour s'afficher correctement.

Facultatif et valide uniquement pour les créations utilisant des tags tiers. Les créations associées à des tags tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

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

N'est valide que si 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 valide uniquement pour les créations de type "Tag tiers" ou "Tag VAST tiers".

Les créations associées à des tags tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

Les créations associées à des tags VAST tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

enum (ExpandingDirection)

Facultatif. Indique la direction d'expansion de la création.

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

Les créations extensibles tierces sont des créations associées à la source d'hébergement suivante:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_EXPANDABLE

boolean

Facultatif. Indique que la création se déplie automatiquement lorsque l'utilisateur pointe dessus.

Facultatif, valide uniquement pour les créations extensibles tierces Les créations extensibles tierces sont des créations associées à la source d'hébergement suivante:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_EXPANDABLE

string

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

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

Les créations associées à des tags VAST tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

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

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

Les créations associées à des tags VAST tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_VIDEO

boolean

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

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

Les créations associées à des tags VAST tiers sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_VIDEO

string (int64 format)

Uniquement en sortie. Il s'agit des identifiants 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.

boolean

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

Sortie uniquement et valide uniquement pour les créations audio tierces.

Les créations audio tierces sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_AUDIO

boolean

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

Sortie uniquement et valide uniquement pour les créations audio tierces.

Les créations audio tierces sont des créations associées aux hostingSource suivants:

• HOSTING_SOURCE_THIRD_PARTY

associé aux creativeType suivants:

• CREATIVE_TYPE_AUDIO

{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

États d'examen de la création pour la place de marché.

object (PublisherReviewStatus)

États d'examen de la création par l'éditeur.

Avertissement:Ce champ sera abandonné le 26 juin 2024. Après cette date, ce champ sera vide. Pour en savoir plus, consultez notre annonce relative à l'abandon de fonctionnalités.

{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}

enum (Exchange)

La place de marché examine la création.

enum (ReviewStatus)

État de l'examen de la place de marché.

{
  "publisherName": string,
  "status": enum (ReviewStatus)
}

string

Éditeur qui examine la création.

enum (ReviewStatus)

État de l'examen par l'éditeur.

{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}

object (Asset)

L'élément associé.

enum (AssetRole)

Rôle de cet asset pour la création.

{
  "mediaId": string,
  "content": string
}

string (int64 format)

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

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

string

Contenu de l'asset. Pour les éléments importés, le contenu correspond au chemin de diffusion.

{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}

enum (ExitEventType)

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

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

string

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

Chaque création doit avoir un nom unique.

Laissez-la vide ou n'est pas configurée pour les créations contenant uniquement des composants Image.

string

Nom utilisé pour identifier cet événement dans les rapports. Laissez-la vide ou n'est pas configurée pour les créations contenant uniquement des composants Image.

{
  "name": string,
  "reportingName": string
}

string

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

string

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

{
  "name": string,
  "reportingName": string
}

string

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

string

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

{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}

string (int64 format)

Décalage (en pourcentage) de la durée de l'audio ou de la vidéo.

string (int64 format)

Décalage en secondes à partir du début de la lecture de l'audio ou de la vidéo.

{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}

string

Identifiant unique de la création.

enum (UniversalAdRegistry)

Le registre fournit des identifiants de création uniques.

{
  "type": enum (ThirdPartyUrlType),
  "url": string
}

enum (ThirdPartyUrlType)

Le type d'interaction doit être suivi à l'aide de l'URL de suivi.

string

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 facultative commençant par https:. Par exemple, https://www.example.com/path.

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

string

Nom du fichier transcodé.

string

Type MIME du fichier transcodé.

boolean

Indique si le transcodage a réussi.

object (Dimensions)

Dimensions de la vidéo transcodée.

string (int64 format)

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

number

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

string (int64 format)

Débit du flux audio de la vidéo transcodée, ou débit du contenu audio transcodé, en kilobits par seconde.

string (int64 format)

Taux d'échantillonnage du flux audio de la vidéo transcodée, ou taux d'échantillonnage du contenu audio transcodé, en hertz.

string (int64 format)

Taille du fichier transcodé, en octets.

{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}

string (int64 format)

ID d'emplacement de l'annonce de suivi Campaign Manager 360.

string (int64 format)

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

string (int64 format)

ID de l'annonce de suivi Campaign Manager 360.

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

string

URL de la ressource d'icône PCL.

string

Type MIME de la ressource d'icône de publicité comportementale en ligne.

enum (ObaIconPosition)

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

object (Dimensions)

Dimensions de l'icône PCL.

string

Programme de l'icône PCL. (par exemple, "Choisir sa pub").

string

Obligatoire. URL de la page de destination associée à 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

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

string

Obligatoire. URL de suivi des vues 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