REST Resource: advertisers.creatives

Risorsa: creatività

Una singola creatività.

Rappresentazione 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)
}
Campi
name

string

Solo output. Il nome della risorsa della creatività.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

Solo output. L'ID univoco del posizionamento Campaign Manager 360 associato alla creatività. Questo campo è applicabile solo alle creatività sincronizzate da Campaign Manager.
displayName

string

Obbligatorio. Il nome visualizzato della creatività.

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

enum (EntityStatus)

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

I valori accettati sono:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
creativeType

enum (CreativeType)

Obbligatorio. Immutabile. Il tipo di creatività.
hostingSource

enum (HostingSource)

Obbligatorio. Indica dove è ospitata la creatività.
dynamic

boolean

Solo output. Indica se la creatività è dinamica.
dimensions

object (Dimensions)

Obbligatorio. Dimensioni principali della creatività. Applicabile a tutti i tipi di creatività. Il valore di widthPixels e heightPixels è 0 per impostazione predefinita quando creativeType è uno dei seguenti valori:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Facoltativo. Dimensioni aggiuntive. Applicabile quando creativeType è uno dei seguenti valori:

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

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

string (Duration format)

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

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

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

object (ReviewStatusInfo)

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

object (AssetAssociation)

Obbligatorio. Asset associati a questa creatività.
exitEvents[]

object (ExitEvent)

Obbligatorio. Eventi di uscita per questa creatività. Un'uscita (nota anche come clicktag) è qualsiasi area della creatività su cui un utente può fare clic o toccare per aprire la pagina di destinazione di un inserzionista. Ogni creatività deve includere almeno un'uscita. Puoi aggiungere un'uscita alla tua 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.
timerEvents[]

object (TimerEvent)

Facoltativo. Eventi personalizzati timer 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 il campo vuoto o non impostarlo per le creatività che contengono solo asset immagine.
counterEvents[]

object (CounterEvent)

Facoltativo. Eventi contatore per una creatività rich media. I contatori monitorano il numero di volte in cui un utente interagisce con qualsiasi parte di una creatività rich media in un modo specifico (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 il campo vuoto o non impostarlo per le creatività che contengono solo asset immagine.
appendedTag

string

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

string

Facoltativo. Informazioni sull'ID utilizzate per collegare questa creatività a un sistema esterno. Deve essere codificato in UTF-8 e non deve contenere più di 10.000 caratteri.
notes

string

Facoltativo. Note dell'utente per questa creatività. Deve essere codificato in UTF-8 e non deve contenere più di 20.000 caratteri.
iasCampaignMonitoring

boolean

Facoltativo. Indica se è attivato il monitoraggio delle campagne Integral Ad Science (IAS). Per attivare questa opzione per la creatività, assicurati che Advertiser.creative_config.ias_client_id sia impostato sul tuo ID client IAS.
companionCreativeIds[]

string (int64 format)

Facoltativo. Gli ID delle creatività companion per 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à che contengono additional dimensions non possono essere creatività companion.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Facoltativo. Tempo di riproduzione del video prima che venga visualizzato il pulsante Salta.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Facoltativo. Quantità di tempo per riprodurre il video prima di conteggiare una visualizzazione.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Facoltativo. Un identificatore della 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
thirdPartyUrls[]

object (ThirdPartyUrl)

Facoltativo. 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
transcodes[]

object (Transcode)

Solo output. Transcodifiche audio/video.

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

Queste transcodifiche offrono al sistema di un publisher più opzioni tra cui scegliere per ogni impressione sul tuo video e garantiscono che venga pubblicato il file appropriato 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
trackerUrls[]

string

Facoltativo. URL di monitoraggio per fornitori di analisi dati o fornitori di tecnologie pubblicitarie di terze parti.

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

Solo URL standard (i tag IMG o SCRIPT non sono supportati).

Questo campo è scrivibile solo nel seguente creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

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

Questo campo è scrivibile solo nel seguente creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Facoltativo. L'annuncio di monitoraggio 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

Solo output per altri casi.
obaIcon

object (ObaIcon)

Facoltativo. Specifica l'icona OBA per una creatività video.

Questo campo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

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

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

Le creatività con tag di terze parti sono creatività con il seguente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Facoltativo. Indica che la creatività richiede 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à con tag di terze parti.

Le creatività con tag di terze parti sono creatività con il seguente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Facoltativo. Indica che la creatività si basa su HTML5 per una visualizzazione corretta.

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

Valido solo quando si utilizza 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à con tag di terze parti o con tag VAST di terze parti.

Le creatività con tag di terze parti sono creatività con il seguente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

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 la seguente origine di hosting:

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

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 la seguente origine di hosting:

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Solo output. Indica che la creatività del tag VAST di terze parti richiede VPAID (Digital Video Player-Ad Interface).

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

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

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.
mp3Audio

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

Facoltativo. Se aggiungere un'etichetta alla creatività come creata o modificata con l'AI quando viene pubblicata in regioni con normative locali sull'etichettatura dell'AI.

HostingSource

Possibili origini di hosting per una creatività. Indica dove viene creata e ospitata una creatività.

Enum
HOSTING_SOURCE_UNSPECIFIED L'origine dell'hosting non è specificata o è sconosciuta in questa versione.
HOSTING_SOURCE_CM

Una creatività sincronizzata da Campaign Manager 360.

I metodi di creazione e aggiornamento non sono supportati per questo tipo di hosting.
HOSTING_SOURCE_THIRD_PARTY

Una creatività ospitata da un ad server di terze parti (3PAS).

I metodi di creazione e aggiornamento sono supportati per questo tipo di hosting se creativeType è uno dei seguenti:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Una creatività creata in DV360 e ospitata da Campaign Manager 360.

I metodi di creazione e aggiornamento sono supportati per questo tipo di hosting se creativeType è uno dei seguenti:

  • 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

Una creatività rich media creata in Studio e ospitata da Campaign Manager 360.

I metodi di creazione e aggiornamento non sono supportati per questo tipo di hosting.

CreativeAttribute

Possibili attributi di una creatività.

Enum
CREATIVE_ATTRIBUTE_UNSPECIFIED L'attributo della creatività non è specificato o è sconosciuto in questa versione.
CREATIVE_ATTRIBUTE_VAST La creatività è una creatività VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR La creatività è una creatività VPAID lineare.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR La creatività è una creatività VPAID non lineare.

ReviewStatusInfo

Controlla gli stati della creatività.

Rappresentazione JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
Campi
approvalStatus

enum (ApprovalStatus)

Rappresenta l'approvazione di base necessaria per iniziare a pubblicare una creatività. Riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

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

enum (ReviewStatus)

Stato della revisione dei contenuti e della conformità alle norme per la creatività.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Stati di revisione delle piattaforme di scambio pubblicitario per la creatività.

StatoApprovazione

Possibili tipi di stato di approvazione. È il riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.

Enum
APPROVAL_STATUS_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La creatività è ancora in corso di revisione e non può essere pubblicata.
APPROVAL_STATUS_PENDING_SERVABLE La creatività ha superato la revisione della creatività e della pagina di destinazione ed è pubblicabile, ma è in attesa di un'ulteriore revisione dei contenuti e delle norme.
APPROVAL_STATUS_APPROVED_SERVABLE Sono approvate sia la revisione della creatività e della pagina di destinazione sia la revisione dei contenuti e della conformità alle norme. La creatività è pubblicabile.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Si è verificato un problema con la creatività che deve essere risolto prima che possa essere pubblicata.

ReviewStatus

Possibili tipi di stato della revisione.

Enum
REVIEW_STATUS_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
REVIEW_STATUS_APPROVED La creatività è approvata.
REVIEW_STATUS_REJECTED La creatività viene rifiutata.
REVIEW_STATUS_PENDING La creatività è in attesa di revisione.

ExchangeReviewStatus

Stato di revisione della piattaforma di scambio pubblicitario per la creatività.

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

enum (Exchange)

La piattaforma di scambio pubblicitario che esamina la creatività.
status

enum (ReviewStatus)

Stato della revisione della piattaforma di scambio pubblicitario.

AssetAssociation

Associazione degli asset per la creatività.

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

object (Asset)

Facoltativo. La risorsa associata.
role

enum (AssetRole)

Facoltativo. Il ruolo di questo asset per la creatività.

Asset

Un singolo asset.

Rappresentazione JSON 
{
  "mediaId": string,
  "content": string
}
Campi
mediaId

string (int64 format)

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

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

string

I contenuti dell'asset. Per gli asset caricati, i contenuti sono il percorso di pubblicazione.

AssetRole

Il ruolo di questo asset per la creatività.

Enum
ASSET_ROLE_UNSPECIFIED Il ruolo della risorsa non è specificato o è sconosciuto in questa versione.
ASSET_ROLE_MAIN L'asset è l'asset principale della creatività.
ASSET_ROLE_BACKUP L'asset è un asset di backup della creatività.
ASSET_ROLE_POLITE_LOAD L'asset è un asset con caricamento "polite" della creatività.
ASSET_ROLE_HEADLINE

Titolo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 25 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Titolo lungo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve contenere più di 50 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Corpo del testo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 90 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Corpo del testo lungo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 150 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Una versione breve e intuitiva dell'URL pagina di destinazione da mostrare nella creatività. Questo URL dà agli utenti un'idea di dove arriveranno dopo aver fatto clic sulla creatività.

content deve essere codificato in UTF-8 e non deve superare i 30 caratteri.

Ad esempio, se l'URL della pagina di destinazione è "http://www.example.com/page", l'URL dei sottotitoli codificati può essere "example.com". Il protocollo (http://) è facoltativo, ma l'URL non può contenere spazi o caratteri speciali.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Il testo da utilizzare sul pulsante di invito all'azione di una creatività nativa.

content deve essere codificato in UTF-8 e non deve contenere più di 15 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Il testo che identifica l'inserzionista o il nome del brand.

content deve essere codificato in UTF-8 e non deve superare i 25 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Il prezzo di acquisto dell'app nel Google Play Store o nell'App Store iOS (ad esempio, 5,99 $).

Tieni presente che questo valore non viene sincronizzato automaticamente con il valore effettivo elencato nel negozio. Sarà sempre quello fornito al momento del salvataggio della creatività.

content deve essere codificato in UTF-8 e non deve contenere più di 15 caratteri.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_ANDROID_APP_ID

L'ID di un'app per Android nel Google Play Store.

Puoi trovare questo ID nell'URL del Google Play Store dell'app dopo "id". Ad esempio, in https://play.google.com/store/apps/details?id=com.company.appname l'identificatore è com.company.appname.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_IOS_APP_ID

L'ID di un'app per iOS nell'Apple App Store.

Questo numero ID si trova nell'URL dell'App Store di Apple come stringa di numeri immediatamente dopo "id". Ad esempio, in https://apps.apple.com/us/app/gmail-email-by-google/id422689480 l'ID è 422689480.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_RATING

La valutazione di un'app nel Google Play Store o nell'App Store di iOS.

Tieni presente che questo valore non viene sincronizzato automaticamente con la valutazione effettiva nello store. Sarà sempre quello fornito al momento del salvataggio della creatività.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_ICON

L'icona di una creatività.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

L'immagine di copertina di una creatività video nativa.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Il colore principale da utilizzare in una creatività.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Il colore intenso da utilizzare in una creatività.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Indica se la creatività deve utilizzare un asset immagine.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Se i miglioramenti degli asset possono essere applicati alla creatività.

Questo ruolo è supportato e richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Evento di uscita della creatività.

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

enum (ExitEventType)

Obbligatorio. Il tipo di evento di uscita.
url

string

Obbligatorio. L'URL di clickthrough dell'evento di uscita. Questo campo è obbligatorio quando type è:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Facoltativo. Il nome del clicktag dell'evento di uscita.

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

Lascia il campo vuoto o non impostarlo per le creatività che contengono solo asset immagine.
reportingName

string

Facoltativo. Il nome utilizzato per identificare questo evento nei report. Lascia il campo vuoto o non impostarlo per le creatività che contengono solo asset immagine.

ExitEventType

Il tipo di evento di uscita.

Enum
EXIT_EVENT_TYPE_UNSPECIFIED Il tipo di evento di uscita non è specificato o è sconosciuto in questa versione.
EXIT_EVENT_TYPE_DEFAULT L'evento di uscita è quello predefinito.
EXIT_EVENT_TYPE_BACKUP L'evento di uscita è un evento di uscita di backup. In una creatività possono essere presenti più eventi di uscita di backup.

TimerEvent

Evento timer della creatività.

Rappresentazione JSON 
{
  "name": string,
  "reportingName": string
}
Campi
name

string

Obbligatorio. Il nome dell'evento timer.
reportingName

string

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

CounterEvent

Evento contatore della creatività.

Rappresentazione JSON 
{
  "name": string,
  "reportingName": string
}
Campi
name

string

Obbligatorio. Il nome dell'evento contatore.
reportingName

string

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

AudioVideoOffset

La durata di riproduzione di un audio o un video.

Rappresentazione 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.
}
Campi
Il valore dell'offset. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
percentage

string (int64 format)

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

string (int64 format)

Facoltativo. L'offset in secondi dall'inizio dell'audio o del video.
Fine dei campi che si escludono a vicenda.

UniversalAdId

Un identificatore della creatività fornito da un registro univoco su tutte le piattaforme. Fa parte dello standard VAST 4.0.

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

string

Facoltativo. L'identificatore univoco della creatività.
registry

enum (UniversalAdRegistry)

Facoltativo. Il registro fornisce identificatori univoci delle creatività.

UniversalAdRegistry

Il registro fornisce identificatori univoci delle creatività in un ID annuncio universale.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Il registro degli annunci universali non è specificato o è sconosciuto in questa versione.
UNIVERSAL_AD_REGISTRY_OTHER Utilizza un provider personalizzato per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_AD_ID Utilizza Ad-ID per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_CLEARCAST Utilizza clearcast.co.uk per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_DV360 Utilizza Display & Video 360 per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_CM Utilizza Campaign Manager 360 per fornire l'ID annuncio universale.

ThirdPartyUrl

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

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

enum (ThirdPartyUrlType)

Facoltativo. Il tipo di interazione deve essere monitorato dall'URL di monitoraggio
url

string

Facoltativo. URL di monitoraggio utilizzato per monitorare l'interazione.

Fornisci un URL con percorso o stringa di query facoltativi, che inizi con https:. Ad esempio, https://www.example.com/path

ThirdPartyUrlType

Il tipo di interazione deve essere monitorato dall'URL di monitoraggio di terze parti.

Enum
THIRD_PARTY_URL_TYPE_UNSPECIFIED Il tipo di URL di terze parti non è specificato o è sconosciuto in questa versione.
THIRD_PARTY_URL_TYPE_IMPRESSION Utilizzato per conteggiare le impressioni della creatività al termine del buffering audio o video.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Utilizzato per monitorare i clic degli utenti sull'audio o sul video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Utilizzato per monitorare il numero di volte in cui un utente avvia l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 25% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 50% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 75% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino alla fine.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Utilizzato per monitorare il numero di volte in cui un utente disattiva l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Utilizzato per monitorare il numero di volte in cui un utente mette in pausa l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Utilizzato per monitorare il numero di volte in cui un utente riproduce l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Utilizzato per monitorare il numero di volte in cui un utente espande il player alla dimensione schermo intero.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Utilizzato per monitorare il numero di volte in cui un utente interrompe l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Utilizzato per monitorare il numero di volte in cui un utente esegue un clic personalizzato, ad esempio un clic su un'area sensibile di un video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Utilizzato per monitorare il numero di volte in cui l'audio o il video è stato saltato.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino a un offset determinato da progressOffset.

Transcodifica

Rappresenta le informazioni sul file audio o video transcodificato.

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

string

Facoltativo. Il nome del file transcodificato.
mimeType

string

Facoltativo. Il tipo MIME del file transcodificato.
transcoded

boolean

Facoltativo. Indica se la transcodifica è andata a buon fine.
dimensions

object (Dimensions)

Facoltativo. Le dimensioni del video transcodificato.
bitRateKbps

string (int64 format)

Facoltativo. La velocità in bit della transcodifica del video transcodificato, in kilobit al secondo.
frameRate

number

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

string (int64 format)

Facoltativo. La velocità in bit dello stream audio del video transcodificato o dell'audio transcodificato, in kilobit al secondo.
audioSampleRateHz

string (int64 format)

Facoltativo. La frequenza di campionamento in hertz dello stream audio del video transcodificato o dell'audio transcodificato.
fileSizeBytes

string (int64 format)

Facoltativo. Le dimensioni del file transcodificato, in byte.

CmTrackingAd

Un annuncio di monitoraggio Campaign Manager 360.

Rappresentazione JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Campi
cmPlacementId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

ObaIcon

Icona OBA per una creatività

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

string

Facoltativo. L'URL della risorsa dell'icona OBA.
resourceMimeType

string

Facoltativo. Il tipo MIME della risorsa icona OBA.
position

enum (ObaIconPosition)

Facoltativo. La posizione dell'icona OBA sulla creatività.
dimensions

object (Dimensions)

Facoltativo. Le dimensioni dell'icona OBA.
program

string

Facoltativo. Il programma dell'icona OBA. Ad esempio, "AdChoices".
landingPageUrl

string

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

Sono consentiti solo gli URL dei seguenti domini:

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

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
viewTrackingUrl

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

ObaIconPosition

La posizione dell'icona OBA sulla creatività.

Enum
OBA_ICON_POSITION_UNSPECIFIED La posizione dell'icona OBA non è specificata.
OBA_ICON_POSITION_UPPER_RIGHT Nella parte in alto a destra della creatività.
OBA_ICON_POSITION_UPPER_LEFT Nella parte in alto a sinistra della creatività.
OBA_ICON_POSITION_LOWER_RIGHT Nella parte inferiore destra della creatività.
OBA_ICON_POSITION_LOWER_LEFT Nella parte inferiore sinistra della creatività.

ExpandingDirection

La direzione di espansione della creatività espandibile di terze parti.

Enum
EXPANDING_DIRECTION_UNSPECIFIED La direzione di espansione non è specificata.
EXPANDING_DIRECTION_NONE Non si espande in nessuna direzione.
EXPANDING_DIRECTION_UP Si espande verso l'alto.
EXPANDING_DIRECTION_DOWN Si espande verso il basso.
EXPANDING_DIRECTION_LEFT Si espande a sinistra.
EXPANDING_DIRECTION_RIGHT Si espande a destra.
EXPANDING_DIRECTION_UP_AND_LEFT Si espande verso l'alto e a sinistra.
EXPANDING_DIRECTION_UP_AND_RIGHT Si espande verso l'alto e a destra.
EXPANDING_DIRECTION_DOWN_AND_LEFT Si espande verso il basso e a sinistra.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Si espande verso il basso e verso destra.
EXPANDING_DIRECTION_UP_OR_DOWN Si espande verso l'alto o verso il basso.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Si espande sul lato sinistro o destro.
EXPANDING_DIRECTION_ANY_DIAGONAL Può espandersi in qualsiasi direzione diagonale.

Metodi

create

 Crea una nuova creatività.

delete

 Elimina una creatività.

get

 Recupera una creatività.

list

 Elenca le creatività di un inserzionista.

patch

 Aggiorna una creatività esistente.