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

Solo output. Il nome della risorsa della creatività.

string (int64 format)

Solo output. L'ID univoco dell'inserzionista a cui appartiene la creatività.

string (int64 format)

Solo output. L'ID univoco della creatività. Assegnato dal sistema.

string (int64 format)

Solo output. L'ID univoco del posizionamento Campaign Manager 360 associato alla creatività. Questo campo è valido solo per le creatività sincronizzate da Campaign Manager.

string

Obbligatorio. Il nome visualizzato della creatività.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

enum (EntityStatus)

Obbligatorio. Controlla se la creatività può essere pubblicata o meno.

I valori accettati sono:

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento della creatività, da parte dell'utente o del sistema (ad es. revisione creatività). Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Solo output. Il timestamp di creazione della creatività. Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

enum (CreativeType)

Obbligatorio. Immutabile. Il tipo di creatività.

enum (HostingSource)

Obbligatorio. Indica dove è ospitata la creatività.

boolean

Solo output. Indica se la creatività è dinamica.

object (Dimensions)

Obbligatorio. Le dimensioni principali della creatività. Applicabile a tutti i tipi di creatività. Il valore predefinito di widthPixels e heightPixels è 0 quando creativeType è uno dei seguenti:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Dimensions)

Dimensioni aggiuntive. Applicabile quando creativeType è uno tra:

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

Se questo campo viene specificato, widthPixels e heightPixels sono entrambi obbligatori e devono essere maggiori o uguali a 0.

string (Duration format)

Solo output. Durata dei contenuti multimediali della creatività. Applicabile quando creativeType è uno tra:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO
• CREATIVE_TYPE_PUBLISHER_HOSTED

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

enum (CreativeAttribute)

Solo output. Un elenco di attributi della creatività generata dal sistema.

object (ReviewStatusInfo)

Solo output. Lo stato attuale della procedura di revisione delle creatività.

object (AssetAssociation)

Obbligatorio. Asset associati a questa creatività.

object (ExitEvent)

Obbligatorio. Eventi di uscita per questa creatività. Un'uscita (nota anche come clicktag) è un'area della creatività su cui un utente può fare clic o che può toccare per aprire la pagina di destinazione di un inserzionista. Ogni creatività deve includere almeno un'uscita. Puoi aggiungere un'uscita alla creatività in uno dei seguenti modi:

• Utilizza l'area tocco di Google Web Designer.
• Definisci una variabile JavaScript denominata "clicktag".
• Utilizza l'enabler (enabler.exit()) per monitorare le uscite nei formati rich media.

object (TimerEvent)

Timer degli eventi personalizzati per una creatività rich media. I timer tengono traccia del tempo durante il quale un utente visualizza e interagisce con una parte specifica di una creatività rich media. Una creatività può essere caratterizzata da più eventi timer, ciascuno con tempi di attivazione diversi. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.

object (CounterEvent)

Eventi contatore per una creatività rich media. I contatori tengono traccia del numero di volte in cui un utente interagisce con qualsiasi parte di una creatività rich media in un modo specificato (mouseover, mouseout, clic, tocchi, caricamento dati, pressione di tasti e così via). Qualsiasi evento che può essere acquisito nella creatività può essere registrato come contatore. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.

string

Tag di monitoraggio HTML di terze parti da aggiungere al tag della creatività.

string

Informazioni sull'ID utilizzate per collegare la creatività a un sistema esterno. Deve avere codifica UTF-8 con una lunghezza massima di 10.000 caratteri.

string

Note utente per questa creatività. Deve avere codifica UTF-8 con una lunghezza massima di 20.000 caratteri.

boolean

Indica se il monitoraggio della campagna Integral Ad Science (IAS) è attivato. Per attivare questa opzione per la creatività, assicurati che Advertiser.creative_config.ias_client_id sia stato impostato sull'ID cliente IAS.

string (int64 format)

Gli ID delle creatività companion di una creatività video.

Puoi assegnare creatività display esistenti (con asset immagine o HTML5) da pubblicare intorno al video player del publisher. Le creatività companion vengono visualizzate intorno al video player durante la riproduzione e fino al termine del video.

Le creatività contenenti additional dimensions non possono essere creatività companion.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

Se l'utente può scegliere di ignorare una creatività video.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durata della riproduzione del video prima che appaia il pulsante Salta.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durata della riproduzione del video prima del conteggio di una visualizzazione.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_VIDEO

object (UniversalAdId)

(Facoltativo) Un identificatore di creatività facoltativo fornito da un registro, univoco su tutte le piattaforme.

L'ID annuncio universale fa parte dello standard VAST 4.0. Può essere modificato dopo la creazione della creatività.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_VIDEO

object (ThirdPartyUrl)

URL di monitoraggio di terze parti per monitorare le interazioni con una creatività video.

Questo campo è supportato solo per i seguenti creativeType:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Transcode)

Solo output. Transcodifiche audio/video.

Display e Video 360 transcodifica l'asset principale in una serie di versioni alternative che utilizzano o presentano formati file o proprietà differenti (risoluzione, velocità in bit audio e velocità in bit video), ciascuna progettata per video player o larghezze di banda specifiche.

Queste transcodifiche offrono al sistema di un publisher più opzioni tra cui scegliere per ogni impressione relativa al video e garantiscono che il file appropriato venga pubblicato in base alla connessione e alle dimensioni dello schermo dello spettatore.

Questo campo è supportato solo nei seguenti creativeType:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO
• CREATIVE_TYPE_AUDIO

string

URL di monitoraggio per provider di analisi dei dati o fornitori di tecnologia pubblicitaria di terze parti.

Gli URL devono iniziare con https (tranne nell'inventario che non richiede la conformità SSL). Se utilizzi macro nell'URL, utilizza solo quelle supportate da Display & Video a 360°.

Solo URL standard, nessun tag IMG o SCRIPT.

Questo campo può essere scritto solo nei seguenti creativeType:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE
• CREATIVE_TYPE_NATIVE_VIDEO

string

URL di misurazione JavaScript di provider di verifica di terze parti supportati (ComScore, DoubleVerify, IAS, Moat). I tag script HTML non sono supportati.

Questo campo può essere scritto solo nei seguenti creativeType:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE
• CREATIVE_TYPE_NATIVE_VIDEO

object (CmTrackingAd)

L'annuncio di monitoraggio di Campaign Manager 360 associato alla creatività.

Facoltativo per i seguenti creativeType se creati da un inserzionista che utilizza sia Campaign Manager 360 sia la pubblicazione di annunci di terze parti:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE

Output solo per altri casi.

object (ObaIcon)

Specifica l'icona OBA per una creatività video.

Questo campo è supportato solo nei seguenti creativeType:

• CREATIVE_TYPE_VIDEO

string

(Facoltativo) Il tag di terze parti originale utilizzato per la creatività.

Obbligatorio e valido solo per le creatività tag di terze parti.

Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

(Facoltativo) Indica che la creatività richiede il protocollo MRAID (Mobile Rich Media Ad Interface Definitions).

Imposta questa opzione se la creatività si basa su gesti per l'interattività sui dispositivi mobili, come lo scorrimento o il tocco.

Facoltativo e valido solo per le creatività tag di terze parti.

Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

(Facoltativo) Indica che la creatività si basa su HTML5 per essere visualizzata correttamente.

Facoltativo e valido solo per le creatività tag di terze parti. Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

(Facoltativo) Indica che la creatività attenderà un ping di ritorno per l'attribuzione.

Valido solo se utilizzi un annuncio di monitoraggio Campaign Manager 360 con un parametro dell'ad server di terze parti e la macro ${DC_DBM_TOKEN}.

Facoltativo e valido solo per le creatività tag di terze parti o tag VAST di terze parti.

Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

enum (ExpandingDirection)

(Facoltativo) Specifica la direzione di espansione della creatività.

Obbligatorio e valido solo per le creatività espandibili di terze parti.

Le creatività espandibili di terze parti sono creatività con le seguenti origini hosting:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_EXPANDABLE

boolean

(Facoltativo) Indica che la creatività si espanderà automaticamente al passaggio del mouse.

Facoltativo e valido solo per le creatività espandibili di terze parti. Le creatività espandibili di terze parti sono creatività con le seguenti origini hosting:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_EXPANDABLE

string

(Facoltativo) L'URL del tag VAST per una creatività tag VAST di terze parti.

Obbligatorio e valido solo per le creatività tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

Solo output. Indica che la creatività tag VAST di terze parti richiede VPAID (interfaccia annuncio video player digitale).

Solo output valido e valido solo per le creatività tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_VIDEO

boolean

Solo output. Indica che la creatività tag VAST di terze parti richiede il supporto di video HTML5.

Solo output valido e valido solo per le creatività tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_VIDEO

string (int64 format)

Solo output. Gli ID degli elementi pubblicitari a cui è associata questa creatività.

Per associare una creatività a un elemento pubblicitario, utilizza invece LineItem.creative_ids.

boolean

Solo output. Indica che la creatività audio di terze parti supporta il formato MP3.

Solo output valido e valido solo per le creatività audio di terze parti.

Le creatività audio di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_AUDIO

boolean

Solo output. Indica che la creatività audio di terze parti supporta OGG.

Solo output valido e valido solo per le creatività audio di terze parti.

Le creatività audio di terze parti sono creatività con i seguenti hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

• CREATIVE_TYPE_AUDIO

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

enum (ApprovalStatus)

Rappresenta l'approvazione di base necessaria per avviare la pubblicazione di una creatività. Riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.

enum (ReviewStatus)

Stato di revisione della creatività e della pagina di destinazione per la creatività.

enum (ReviewStatus)

Stato di revisione dei contenuti e delle norme per la creatività.

object (ExchangeReviewStatus)

Stati di revisione della creatività nella piattaforma di scambio pubblicitario.

object (PublisherReviewStatus)

Stati di revisione del publisher relativi alla creatività.

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

enum (Exchange)

La piattaforma di scambio pubblicitario che esamina la creatività.

enum (ReviewStatus)

Stato della revisione della piattaforma di scambio pubblicitario.

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

string

Il publisher che esamina la creatività.

enum (ReviewStatus)

Stato della revisione del publisher.

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

object (Asset)

La risorsa associata.

enum (AssetRole)

Il ruolo di questo asset per la creatività.

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

string (int64 format)

L'ID dell'elemento multimediale della risorsa caricata. Si tratta di un identificatore univoco della risorsa. Questo ID può essere passato ad altre chiamate API, ad es. creatives.create per associare l'asset a una creatività.

Lo spazio dell'ID multimediale è stato aggiornato il 5 aprile 2023. Aggiorna gli ID media memorizzati nella cache prima del 5 aprile 2023 recuperando il nuovo ID multimediale dalle risorse delle creatività associate o ricaricando l'asset.

string

I contenuti della risorsa. Per gli asset caricati, i contenuti rappresentano il percorso di pubblicazione.

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

enum (ExitEventType)

Obbligatorio. Il tipo di evento di uscita.

string

Obbligatorio. L'URL di clickthrough dell'evento di uscita. Questa operazione è necessaria se type è:

• EXIT_EVENT_TYPE_DEFAULT
• EXIT_EVENT_TYPE_BACKUP

string

Il nome del clicktag dell'evento di uscita.

Il nome deve essere univoco all'interno di una creatività.

Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.

string

Il nome utilizzato per identificare questo evento nei report. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.

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

string

Obbligatorio. Il nome dell'evento timer.

string

Obbligatorio. Il nome utilizzato per identificare questo evento timer nei report.

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

string

Obbligatorio. Il nome dell'evento contatore.

string

Obbligatorio. Il nome utilizzato per identificare questo evento contatore nei report.

{

  // 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)

L'offset in percentuale della durata dell'audio o del video.

string (int64 format)

L'offset in secondi dall'inizio dell'audio o del video.

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

string

L'identificatore univoco della creatività.

enum (UniversalAdRegistry)

Il registry fornisce identificatori univoci delle creatività.

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

enum (ThirdPartyUrlType)

Il tipo di interazione deve essere monitorato dall'URL di monitoraggio

string

URL di monitoraggio utilizzato per monitorare l'interazione.

Fornisci un URL con un percorso facoltativo o una stringa di query, che inizi con https:. Ad esempio, 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

Il nome del file transcodificato.

string

Il tipo MIME del file transcodificato.

boolean

Indica se la transcodifica è riuscita.

object (Dimensions)

Le dimensioni del video transcodificato.

string (int64 format)

Velocità in bit di transcodifica del video transcodificato, in kilobit al secondo.

number

La frequenza fotogrammi del video transcodificato, in frame al secondo.

string (int64 format)

La velocità in bit dello stream audio del video transcodificato o la velocità in bit per l'audio transcodificato, in kilobit al secondo.

string (int64 format)

La frequenza di campionamento per lo stream audio del video transcodificato o la frequenza di campionamento per l'audio transcodificato, in Hertz.

string (int64 format)

Le dimensioni del file transcodificato, in byte.

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

string (int64 format)

L'ID posizionamento dell'annuncio di monitoraggio di Campaign Manager 360.

string (int64 format)

L'ID creatività dell'annuncio di monitoraggio Campaign Manager 360.

string (int64 format)

L'ID annuncio dell'annuncio di monitoraggio Campaign Manager 360.

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

string

L'URL della risorsa dell'icona OBA.

string

Tipo MIME della risorsa dell'icona OBA.

enum (ObaIconPosition)

La posizione dell'icona OBA nella creatività.

object (Dimensions)

Le dimensioni dell'icona OBA.

string

Il programma dell'icona OBA. Ad esempio: "Scegli Tu!".

string

Obbligatorio. L'URL pagina di destinazione dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:

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

string

Obbligatorio. L'URL di monitoraggio dei clic dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:

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

string

Obbligatorio. L'URL di monitoraggio delle visualizzazioni dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:

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