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
}
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 codificata 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à, eseguito dall'utente o dal sistema (ad es. verifica della creatività). Assegnato dal sistema.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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. Timestamp di creazione della creatività. Assegnato dal sistema.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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 è impostato su 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, chiamata anche clicktag, è un'area nella tua creatività su cui l'utente può fare clic o che può toccare per aprire la pagina di destinazione di un inserzionista. Ciascuna creatività deve includere almeno un'uscita. Puoi aggiungere un'uscita alla tua creatività in uno dei seguenti modi:

  • Utilizza "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 monitorano il 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 impostare per le creatività contenenti 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 vuoto o non impostare per le creatività contenenti 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 superare i 20.000 caratteri.
iasCampaignMonitoring

boolean

(Facoltativo) 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 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à contenenti 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) Indica per quanto tempo il video deve essere riprodotto prima che diventi disponibile il pulsante per saltare l'annuncio.

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 la 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
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 diverse versioni alternative che utilizzano o presentano formati file e proprietà differenti (risoluzione, frequenza bit audio e frequenza bit video) e ciascuna pensata per specifici video player e larghezze di banda.

Tali transcodifiche offrono al sistema del publisher più opzioni tra cui scegliere per ogni impressione relativa al video e assicurano 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
trackerUrls[]

string

(Facoltativo) URL di monitoraggio per i fornitori di analisi dati o i 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 di fornitori di verifica di terze parti supportati (ComScore, DoubleVerify, IAS, Moat). I tag di script in 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 gli 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à tag di terze parti.

Le creatività tag di terze parti sono creatività con le seguenti 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à tag di terze parti.

Le creatività tag di terze parti sono creatività con le seguenti 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 essere visualizzata correttamente.

Facoltativo e valido solo per le creatività tag di terze parti. Le creatività tag di terze parti sono creatività con le seguenti 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 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 le creatività tag VAST di terze parti.

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

  • HOSTING_SOURCE_THIRD_PARTY

in combinazione con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Le creatività tag VAST di terze parti sono creatività con i 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à tag VAST di terze parti sono creatività con i 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à tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i 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à tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i 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 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

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)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
Campi
approvalStatus

enum (ApprovalStatus)

Rappresenta l'approvazione di base necessaria perché una creatività possa essere pubblicata. 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 della piattaforma di scambio pubblicitario per la creatività.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Stati di revisione del publisher 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 fase di revisione e non è pubblicabile.
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 secondo le norme.
APPROVAL_STATUS_APPROVED_SERVABLE Sono state 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à è stata approvata.
REVIEW_STATUS_REJECTED La creatività viene rifiutata.
REVIEW_STATUS_PENDING La creatività è in attesa di revisione.

ExchangeReviewStatus

Stato di revisione dell'exchange per la creatività.

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

enum (Exchange)

L'exchange che esamina la creatività.
status

enum (ReviewStatus)

Stato della revisione della piattaforma di scambio pubblicitario.

PublisherReviewStatus

Stato di revisione del publisher per la creatività.

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

string

Il publisher che esamina la creatività.
status

enum (ReviewStatus)

Stato della revisione dell'editore.

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 questa risorsa 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 per la 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 media memorizzati nella cache prima del 5 aprile 2023 recuperando il nuovo ID media dalle risorse delle creatività associate o ricaricando l'asset.
content

string

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

AssetRole

Il ruolo di questa risorsa 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 di caricamento differito della creatività.
ASSET_ROLE_HEADLINE

Titolo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve contenere più di 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 superare i 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 abbreviata 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 pagina di destinazione è "http://www.example.com/page", l'URL didascalia 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 nel pulsante di invito all'azione di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 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 il nome dell'inserzionista o del brand.

content deve essere codificato in UTF-8 e non deve contenere più di 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 della tua 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 superare i 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 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 di accento 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 vuoto o non impostare per le creatività contenenti solo asset immagine.
reportingName

string

(Facoltativo) Il nome utilizzato per identificare questo evento nei report. Lascia vuoto o non impostare per le creatività contenenti 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à potrebbero esserci 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 di conteggio.
reportingName

string

Obbligatorio. Il nome utilizzato per identificare questo evento di conteggio nei report.

AudioVideoOffset

La durata di riproduzione di un audio o un video.

Rappresentazione JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Campi
Campo unione offset. Il valore dell'offset. offset può essere solo uno dei seguenti:
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.

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 registry fornisce identificatori univoci delle creatività in un ID annuncio universale.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Il registro dell'annuncio universale 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 facendo clic sull'area selezionabile 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 è stata eseguita correttamente.
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 fotogrammi al secondo.
audioBitRateKbps

string (int64 format)

(Facoltativo) La frequenza di bit dello stream audio del video transcodificato o dell'audio transcodificato, in kilobit al secondo.
audioSampleRateHz

string (int64 format)

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

string (int64 format)

(Facoltativo) Le dimensioni del file transcodificato, in byte.

CmTrackingAd

Un annuncio di monitoraggio di Campaign Manager 360.

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

(Facoltativo) L'ID annuncio dell'annuncio di monitoraggio di 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 In alto a sinistra nella creatività.
OBA_ICON_POSITION_LOWER_RIGHT Nella parte in basso a destra della creatività.
OBA_ICON_POSITION_LOWER_LEFT In basso a sinistra nella 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 verso sinistra.
EXPANDING_DIRECTION_UP_AND_RIGHT Si espande verso l'alto e verso destra.
EXPANDING_DIRECTION_DOWN_AND_LEFT Si espande verso il basso e verso il lato sinistro.
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

 Riceve una creatività.

list

 Elenca le creatività di un inserzionista.

patch

 Aggiorna una creatività esistente.