REST Resource: advertisers.creatives

Recurso: Creative

Es una sola creatividad.

Representación 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
}
Campos
name

string

Solo salida. Es el nombre del recurso de la creatividad.
advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante al que pertenece la creatividad.
creativeId

string (int64 format)

Solo salida. Es el ID único de la creatividad. El sistema lo asigna.
cmPlacementId

string (int64 format)

Solo salida. Es el ID único de la posición de Campaign Manager 360 asociada con la creatividad. Este campo solo se aplica a las creatividades que se sincronizan desde Campaign Manager.
displayName

string

Obligatorio. Es el nombre visible de la creatividad.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Obligatorio. Controla si se puede publicar la creatividad.

Valores aceptados:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que se actualizó la creatividad por última vez, ya sea por el usuario o el sistema (p.ej., revisión de la creatividad). El sistema lo asigna.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la creación de la creatividad. El sistema lo asigna.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
creativeType

enum (CreativeType)

Obligatorio. Inmutable. Es el tipo de creatividad.
hostingSource

enum (HostingSource)

Obligatorio. Indica dónde se aloja la creatividad.
dynamic

boolean

Solo salida. Indica si la creatividad es dinámica.
dimensions

object (Dimensions)

Obligatorio. Son las dimensiones principales de la creatividad. Se aplica a todos los tipos de creatividades. El valor de widthPixels y heightPixels se establece de forma predeterminada en 0 cuando creativeType es uno de los siguientes:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Opcional. Son dimensiones adicionales. Se aplica cuando creativeType es uno de los siguientes:

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

Si se especifica este campo, se requieren widthPixels y heightPixels, y ambos deben ser mayores o iguales a 0.
mediaDuration

string (Duration format)

Solo salida. Es la duración del recurso multimedia de la creatividad. Se aplica cuando creativeType es uno de los siguientes:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Solo salida. Es una lista de atributos de la creatividad que genera el sistema.
reviewStatus

object (ReviewStatusInfo)

Solo salida. Es el estado actual del proceso de revisión de la creatividad.
assets[]

object (AssetAssociation)

Obligatorio. Son los recursos asociados a esta creatividad.
exitEvents[]

object (ExitEvent)

Obligatorio. Son los eventos de salida de esta creatividad. Una salida (también conocida como etiqueta de clic) es cualquier área de tu creatividad en la que una persona puede hacer clic o presionar para abrir la página de destino de un anunciante. Todas las creatividades deben incluir al menos una salida. Puedes agregar una salida a tu creatividad de cualquiera de las siguientes maneras:

  • Usa el área para presionar de Google Web Designer.
  • Define una variable de JavaScript llamada "clickTag".
  • Usa Enabler (Enabler.exit()) para hacer un seguimiento de las salidas en formatos rich media.
timerEvents[]

object (TimerEvent)

Opcional. Son eventos personalizados de temporizador para una creatividad de rich media. Los temporizadores registran el tiempo durante el cual un usuario visualiza una parte específica de una creatividad rich media e interactúa con ella. Una creatividad puede incluir varios eventos de temporizador, cada uno con un registro de tiempo independiente. Déjalo vacío o sin configurar para las creatividades que solo contienen recursos de imagen.
counterEvents[]

object (CounterEvent)

Opcional. Son los eventos de contador de una creatividad rich media. Los contadores registran la cantidad de veces que un usuario interactúa con cualquier parte de una creatividad de rich media de una manera específica (desplazamientos del mouse sobre la creatividad o fuera de ella, clics, toques, carga de datos, entradas del teclado, etc.). Cualquier evento que se pueda capturar en la creatividad se puede registrar como contador. Déjalo vacío o sin configurar para las creatividades que solo contienen recursos de imagen.
appendedTag

string

Opcional. Es la etiqueta de seguimiento HTML de terceros que se agregará a la etiqueta de creatividad.
integrationCode

string

Opcional. Es la información del ID que se usa para vincular esta creatividad a un sistema externo. Debe estar codificado en UTF-8 y tener una longitud de no más de 10,000 caracteres.
notes

string

Opcional. Son las notas del usuario para esta creatividad. Debe estar codificado en UTF-8 y tener una longitud de no más de 20,000 caracteres.
iasCampaignMonitoring

boolean

Opcional. Indica si está habilitada la supervisión de campañas de Integral Ad Science (IAS). Para habilitar esta opción en la creatividad, asegúrate de que el objeto Advertiser.creative_config.ias_client_id se haya configurado con tu ID de cliente de IAS.
companionCreativeIds[]

string (int64 format)

Opcional. Son los IDs de las creatividades complementarias de una creatividad de video.

Puedes asignar creatividades de display existentes (con recursos de imagen o HTML5) para que se publiquen alrededor del reproductor de video del publicador. Los complementos se muestran alrededor del reproductor de video mientras se reproduce el video y permanecen después de que este finaliza.

Las creatividades que contienen additional dimensions no pueden ser creatividades complementarias.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Opcional. Indica si el usuario puede optar por omitir una creatividad de video.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Opcional. Cantidad de tiempo que se reproduce el video antes de que aparezca el botón para omitirlo.

Este campo es obligatorio cuando skippable es verdadero.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Opcional. Cantidad de tiempo que se debe reproducir el video antes de que se contabilice una vista.

Este campo es obligatorio cuando skippable es verdadero.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Opcional. Es un identificador de creatividad opcional proporcionado por un registro que es único en todas las plataformas.

El ID de anuncio universal forma parte del estándar de VAST 4.0. Se puede modificar después de crear la creatividad.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Opcional. Son URLs de seguimiento de terceros que permiten hacer un seguimiento de las interacciones con una creatividad de video.

Este campo solo se admite para los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Solo salida. Transcodificación de audio y video

Display & Video 360 transcodifica el recurso principal en varias versiones alternativas que usan diferentes formatos de archivo o tienen diferentes propiedades (resolución, tasa de bits de audio y tasa de bits de video), cada una diseñada para reproductores de video o anchos de banda específicos.

Estas transcodificaciones le brindan al sistema del publicador más opciones para elegir en cada impresión de tu video y garantizan que se publique el archivo adecuado según la conexión y el tamaño de la pantalla del usuario.

Este campo solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Opcional. URLs de seguimiento para proveedores de estadísticas o proveedores externos de tecnología publicitaria

Las URLs deben comenzar con https: (excepto en el inventario que no requiere cumplimiento con SSL). Si utilizas macros en tu URL, usa solo las que admite Display & Video 360.

Solo URLs estándar, sin etiquetas IMG ni SCRIPT

Este campo solo se puede escribir en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Opcional. Es la URL de medición de JavaScript de los proveedores de verificación externos admitidos (ComScore, DoubleVerify, IAS y Moat). No se admiten las etiquetas de secuencia de comandos HTML.

Este campo solo se puede escribir en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Opcional. Es el anuncio de seguimiento de Campaign Manager 360 asociado con la creatividad.

Es opcional para los siguientes creativeType cuando los crea un anunciante que utiliza Campaign Manager 360 y la publicación de anuncios de terceros:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Solo salida para otros casos.
obaIcon

object (ObaIcon)

Opcional. Especifica el ícono de OBA para una creatividad de video.

Este campo solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Opcional. Es la etiqueta de terceros original que se usó para la creatividad.

Es obligatorio y solo es válido para las creatividades con etiquetas de terceros.

Las creatividades con etiquetas de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Opcional. Indica que la creatividad requiere MRAID (sistema de definiciones de la interfaz de anuncios rich media para dispositivos móviles).

Establece este parámetro si la creatividad depende de gestos en dispositivos móviles para la interactividad, como deslizar o presionar.

Es opcional y solo es válido para las creatividades con etiquetas de terceros.

Las creatividades con etiquetas de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Opcional. Indica que la creatividad depende de HTML5 para renderizarse correctamente.

Es opcional y solo es válido para las creatividades con etiquetas de terceros. Las creatividades con etiquetas de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Opcional. Indica que la creatividad esperará un ping de devolución para la atribución.

Solo es válido cuando se usa un anuncio de seguimiento de Campaign Manager 360 con un parámetro de servidor de anuncios de terceros y la macro ${DC_DBM_TOKEN}.

Es opcional y solo es válido para las creatividades con etiquetas de terceros o las creatividades con etiquetas de VAST de terceros.

Las creatividades con etiquetas de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Las creatividades con etiquetas de VAST de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Opcional. Especifica la dirección de expansión de la creatividad.

Es obligatorio y solo es válido para las creatividades expandibles de terceros.

Las creatividades expandibles de terceros son creatividades con la siguiente fuente de alojamiento:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Opcional. Indica que la creatividad se expandirá automáticamente cuando se coloque el cursor sobre ella.

Es opcional y solo es válido para las creatividades expandibles de terceros. Las creatividades expandibles de terceros son creatividades con la siguiente fuente de alojamiento:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Opcional. Es la URL de la etiqueta de VAST para una creatividad con etiqueta de VAST de terceros.

Es obligatorio y solo es válido para las creatividades con etiquetas de VAST de terceros.

Las creatividades con etiquetas de VAST de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Solo salida. Indica que la creatividad de la etiqueta VAST de terceros requiere VPAID (interfaz de anuncios en reproductores de video digitales).

Es solo de salida y solo es válido para las creatividades de etiquetas de VAST de terceros.

Las creatividades con etiquetas de VAST de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Solo salida. Indica que la creatividad de la etiqueta VAST de terceros requiere compatibilidad con video HTML5.

Es solo de salida y solo es válido para las creatividades de etiquetas de VAST de terceros.

Las creatividades con etiquetas de VAST de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Solo salida. Son los IDs de las líneas de pedido con las que se asocia esta creatividad.

Para asociar una creatividad a una línea de pedido, usa LineItem.creative_ids en su lugar.
mp3Audio

boolean

Solo salida. Indica que la creatividad de audio de terceros admite MP3.

Es solo salida y solo es válido para las creatividades de audio de terceros.

Las creatividades de audio de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Solo salida. Indica que la creatividad de audio de terceros admite OGG.

Es solo salida y solo es válido para las creatividades de audio de terceros.

Las creatividades de audio de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

Son las posibles fuentes de alojamiento de una creatividad. Indica dónde se crea y aloja una creatividad.

Enumeraciones
HOSTING_SOURCE_UNSPECIFIED No se especificó la fuente de hosting o es desconocida en esta versión.
HOSTING_SOURCE_CM

Es una creatividad sincronizada desde Campaign Manager 360.

Los métodos de creación y actualización no son compatibles con este tipo de hosting.
HOSTING_SOURCE_THIRD_PARTY

Es una creatividad alojada por un servidor de anuncios de terceros (3PAS).

Los métodos de creación y actualización son compatibles con este tipo de hosting si el objeto creativeType es uno de los siguientes:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Es una creatividad creada en DV360 y alojada por Campaign Manager 360.

Los métodos de creación y actualización son compatibles con este tipo de hosting si el objeto creativeType es uno de los siguientes:

  • 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

Es una creatividad de rich media creada en Studio y alojada en Campaign Manager 360.

Los métodos de creación y actualización no son compatibles con este tipo de hosting.

CreativeAttribute

Son los atributos posibles de una creatividad.

Enumeraciones
CREATIVE_ATTRIBUTE_UNSPECIFIED El atributo de creatividad no se especificó o es desconocido en esta versión.
CREATIVE_ATTRIBUTE_VAST La creatividad es de VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR La creatividad es una creatividad de VPAID lineal.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR La creatividad es de VPAID no lineal.

ReviewStatusInfo

Estados de revisión de la creatividad

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

enum (ApprovalStatus)

Representa la aprobación básica necesaria para que se comience a publicar una creatividad. Resumen de creativeAndLandingPageReviewStatus y contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Es el estado de revisión de la creatividad y la página de destino de la creatividad.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Es el estado de revisión del contenido y la política de la creatividad.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Son los estados de revisión de Exchange para la creatividad.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Son los estados de revisión del publicador para la creatividad.

Estado de aprobación

Son los posibles tipos de estado de aprobación. Es el resumen de creativeAndLandingPageReviewStatus y contentAndPolicyReviewStatus.

Enumeraciones
APPROVAL_STATUS_UNSPECIFIED El valor del tipo no se especificó o es desconocido en esta versión.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La creatividad aún está en revisión y no se puede publicar.
APPROVAL_STATUS_PENDING_SERVABLE La creatividad superó la revisión de la creatividad y la página de destino, y se puede publicar, pero espera contenido adicional y revisión de políticas.
APPROVAL_STATUS_APPROVED_SERVABLE Se aprobaron tanto la revisión de la creatividad y la página de destino como la revisión del contenido y las políticas. La creatividad se puede publicar.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Hay un problema con la creatividad que se debe solucionar antes de que se pueda publicar.

ReviewStatus

Son los posibles tipos de estado de revisión.

Enumeraciones
REVIEW_STATUS_UNSPECIFIED El valor del tipo no se especificó o es desconocido en esta versión.
REVIEW_STATUS_APPROVED Se aprobó la creatividad.
REVIEW_STATUS_REJECTED Se rechaza la creatividad.
REVIEW_STATUS_PENDING La creatividad está pendiente de revisión.

ExchangeReviewStatus

Es el estado de la revisión de Exchange para la creatividad.

Representación JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Campos
exchange

enum (Exchange)

Es el exchange que revisa la creatividad.
status

enum (ReviewStatus)

Es el estado de la revisión del intercambio.

PublisherReviewStatus

Es el estado de revisión de la creatividad por parte del publicador.

Representación JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
Campos
publisherName

string

Es el publicador que revisa la creatividad.
status

enum (ReviewStatus)

Es el estado de la revisión del publicador.

AssetAssociation

Es la asociación del recurso con la creatividad.

Representación JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Campos
asset

object (Asset)

Opcional. Es el recurso asociado.
role

enum (AssetRole)

Opcional. Es el rol de este recurso para la creatividad.

Recurso

Es un solo activo.

Representación JSON 
{
  "mediaId": string,
  "content": string
}
Campos
mediaId

string (int64 format)

Es el ID de medios del recurso subido. Es un identificador único del activo. Este ID se puede pasar a otras llamadas a la API, p.ej., creatives.create, para asociar el activo con una creatividad.

El espacio de IDs de medios se actualizó el 5 de abril de 2023. Actualiza los IDs de medios almacenados en caché antes del 5 de abril de 2023 recuperando el nuevo ID de medios de los recursos de creatividad asociados o volviendo a subir el activo.
content

string

Es el contenido del activo. En el caso de los recursos subidos, el contenido es la ruta de acceso de entrega.

AssetRole

Es el rol de este recurso para la creatividad.

Enumeraciones
ASSET_ROLE_UNSPECIFIED El rol del activo no se especificó o es desconocido en esta versión.
ASSET_ROLE_MAIN El recurso es el principal de la creatividad.
ASSET_ROLE_BACKUP El recurso es un recurso de copia de seguridad de la creatividad.
ASSET_ROLE_POLITE_LOAD Es un recurso de carga cortés de la creatividad.
ASSET_ROLE_HEADLINE

Es el título de una creatividad nativa.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 25 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Es el título largo de una creatividad nativa.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 50 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Es el texto del cuerpo de una creatividad nativa.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 90 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Es el texto del cuerpo largo de una creatividad nativa.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 150 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Es una versión corta y amigable de la URL de la página de destino que se mostrará en la creatividad. Esta URL les da a los usuarios una idea de la página a la que llegarán después de hacer clic en la creatividad.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 30 caracteres.

Por ejemplo, si la URL de la página de destino es "http://www.example.com/page", la URL del título puede ser "example.com". El protocolo (http://) es opcional, pero la URL no puede contener espacios ni caracteres especiales.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Es el texto que se usará en el botón de llamado a la acción de una creatividad nativa.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 15 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Es el texto que identifica al anunciante o al nombre de la marca.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 25 caracteres.

Este rol solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Es el precio de compra de tu app en Google Play Store o en App Store de iOS (por ejemplo, USD 5.99).

Ten en cuenta que este valor no se sincroniza automáticamente con el valor real que aparece en la tienda. Siempre será el que se proporcione cuando se guarde la creatividad.

El content debe estar codificado en UTF-8 y tener una longitud de no más de 15 caracteres.

Los recursos de este rol son de solo lectura.
ASSET_ROLE_ANDROID_APP_ID

Es el ID de una app para Android en Google Play Store.

Puedes encontrar este ID en la URL de Google Play Store de la app después de "id". Por ejemplo, en https://play.google.com/store/apps/details?id=com.company.appname, el identificador es com.company.appname.

Los recursos de este rol son de solo lectura.
ASSET_ROLE_IOS_APP_ID

Es el ID de una app para iOS en la App Store de Apple.

Este número de ID se puede encontrar en la URL de Apple App Store como la cadena de números que aparece directamente después de "id". Por ejemplo, en https://apps.apple.com/us/app/gmail-email-by-google/id422689480, el ID es 422689480.

Los recursos de este rol son de solo lectura.
ASSET_ROLE_RATING

Es la calificación de una app en Google Play Store o App Store de iOS.

Ten en cuenta que este valor no se sincroniza automáticamente con la calificación real en la tienda. Siempre será el que se proporcione cuando se guarde la creatividad.

Los recursos de este rol son de solo lectura.
ASSET_ROLE_ICON

Es el ícono de una creatividad.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Es la imagen de portada de una creatividad de video nativo.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Es el color principal que se usará en una creatividad.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Es el color de acento que se usará en una creatividad.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Indica si la creatividad debe usar un recurso de imagen.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Indica si se pueden aplicar mejoras de recursos a la creatividad.

Este rol solo se admite y requiere en los siguientes creativeType:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Es el evento de salida de la creatividad.

Representación JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Campos
type

enum (ExitEventType)

Obligatorio. Es el tipo de evento de salida.
url

string

Obligatorio. Es la URL de clic del evento de salida. Esto es obligatorio cuando type es uno de los siguientes:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Opcional. Es el nombre de la etiqueta de clic del evento de salida.

El nombre debe ser único dentro de una creatividad.

Déjalo vacío o sin configurar para las creatividades que solo contienen recursos de imagen.
reportingName

string

Opcional. Es el nombre que se usa para identificar este evento en los informes. Déjalo vacío o sin configurar para las creatividades que solo contienen recursos de imagen.

ExitEventType

Es el tipo de evento de salida.

Enumeraciones
EXIT_EVENT_TYPE_UNSPECIFIED El tipo de evento de salida no se especificó o es desconocido en esta versión.
EXIT_EVENT_TYPE_DEFAULT El evento de salida es el predeterminado.
EXIT_EVENT_TYPE_BACKUP El evento de salida es un evento de salida de copia de seguridad. Puede haber varios eventos de salida de copia de seguridad en una creatividad.

TimerEvent

Es el evento de temporizador de la creatividad.

Representación JSON 
{
  "name": string,
  "reportingName": string
}
Campos
name

string

Obligatorio. Es el nombre del evento del temporizador.
reportingName

string

Obligatorio. Es el nombre que se usa para identificar este evento de temporizador en los informes.

CounterEvent

Es el evento de contador de la creatividad.

Representación JSON 
{
  "name": string,
  "reportingName": string
}
Campos
name

string

Obligatorio. Es el nombre del evento de contador.
reportingName

string

Obligatorio. Es el nombre que se usa para identificar este evento de contador en los informes.

AudioVideoOffset

Es la duración de la reproducción de un audio o un video.

Representación 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.
}
Campos
Campo de unión offset. Es el valor del desplazamiento. Las direcciones (offset) solo pueden ser una de las siguientes opciones:
percentage

string (int64 format)

Opcional. Es el desplazamiento en porcentaje de la duración del audio o video.
seconds

string (int64 format)

Opcional. Es el desplazamiento en segundos desde el inicio del audio o el video.

UniversalAdId

Es un identificador de creatividad proporcionado por un registro que es único en todas las plataformas. Esto forma parte del estándar de VAST 4.0.

Representación JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Campos
id

string

Opcional. Es el identificador único de la creatividad.
registry

enum (UniversalAdRegistry)

Opcional. El registro proporciona identificadores únicos de creatividad.

UniversalAdRegistry

El registro proporciona identificadores únicos de creatividad en un ID de anuncio universal.

Enumeraciones
UNIVERSAL_AD_REGISTRY_UNSPECIFIED El registro de anuncios universales no está especificado o se desconoce en esta versión.
UNIVERSAL_AD_REGISTRY_OTHER Usa un proveedor personalizado para proporcionar el ID de anuncio universal.
UNIVERSAL_AD_REGISTRY_AD_ID Usa el Ad-ID para proporcionar el ID de anuncio universal.
UNIVERSAL_AD_REGISTRY_CLEARCAST Usa clearcast.co.uk para proporcionar el ID de anuncio universal.
UNIVERSAL_AD_REGISTRY_DV360 Usa Display & Video 360 para proporcionar el ID de anuncio universal.
UNIVERSAL_AD_REGISTRY_CM Usa Campaign Manager 360 para proporcionar el ID de anuncio universal.

ThirdPartyUrl

URLs de seguimiento de terceros para hacer un seguimiento de las interacciones con una creatividad de audio o video

Representación JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Campos
type

enum (ThirdPartyUrlType)

Opcional. El tipo de interacción que debe hacer un seguimiento de la URL de seguimiento
url

string

Opcional. Es la URL de seguimiento que se usa para hacer un seguimiento de la interacción.

Proporciona una URL con una ruta o cadena de consulta opcional, que comience con https:. Por ejemplo, https://www.example.com/path

ThirdPartyUrlType

La URL de seguimiento de terceros debe hacer un seguimiento del tipo de interacción.

Enumeraciones
THIRD_PARTY_URL_TYPE_UNSPECIFIED El tipo de URL de terceros no se especificó o se desconoce en esta versión.
THIRD_PARTY_URL_TYPE_IMPRESSION Se usa para contar las impresiones de la creatividad después de que se completa el almacenamiento en búfer de audio o video.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Se usa para hacer un seguimiento de los clics del usuario en el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Se usa para hacer un seguimiento de la cantidad de veces que un usuario inicia el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Se usa para hacer un seguimiento de la cantidad de veces que se reproduce el audio o el video hasta un 25% de su duración.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Se usa para hacer un seguimiento de la cantidad de veces que se reproduce el audio o el video hasta un 50% de su duración.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Se usa para hacer un seguimiento de la cantidad de veces que se reproduce el audio o el video hasta un 75% de su duración.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Se usa para hacer un seguimiento de la cantidad de veces que se reproduce el audio o el video hasta el final.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Se usa para hacer un seguimiento de la cantidad de veces que un usuario silencia el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Se usa para hacer un seguimiento de la cantidad de veces que un usuario pausa el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Se usa para hacer un seguimiento de la cantidad de veces que un usuario vuelve a reproducir el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Se usa para hacer un seguimiento de la cantidad de veces que un usuario expande el reproductor a pantalla completa.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Se usa para hacer un seguimiento de la cantidad de veces que un usuario detiene el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Se usa para hacer un seguimiento de la cantidad de veces que un usuario hace un clic personalizado, por ejemplo, en la zona activa de un video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Se usa para hacer un seguimiento de la cantidad de veces que se omitió el audio o el video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Se usa para hacer un seguimiento de la cantidad de veces que el audio o el video se reproducen hasta un desplazamiento determinado por progressOffset.

transcodificar

Representa información sobre el archivo de audio o video transcodificado.

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

string

Opcional. Nombre del archivo transcodificado.
mimeType

string

Opcional. Tipo MIME del archivo transcodificado.
transcoded

boolean

Opcional. Indica si la transcodificación se realizó correctamente.
dimensions

object (Dimensions)

Opcional. Son las dimensiones del video transcodificado.
bitRateKbps

string (int64 format)

Opcional. Es la tasa de bits de transcodificación del video transcodificado, en kilobits por segundo.
frameRate

number

Opcional. Es la velocidad de fotogramas del video transcodificado, en fotogramas por segundo.
audioBitRateKbps

string (int64 format)

Opcional. Es la tasa de bits de la transmisión de audio del video transcodificado o la tasa de bits del audio transcodificado, en kilobits por segundo.
audioSampleRateHz

string (int64 format)

Opcional. Es la tasa de muestreo en hercios de la transmisión de audio del video transcodificado o del audio transcodificado.
fileSizeBytes

string (int64 format)

Opcional. Es el tamaño del archivo transcodificado en bytes.

CmTrackingAd

Es un anuncio de seguimiento de Campaign Manager 360.

Representación JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Campos
cmPlacementId

string (int64 format)

Opcional. Es el ID de la posición del anuncio de seguimiento de Campaign Manager 360.
cmCreativeId

string (int64 format)

Opcional. Es el ID de la creatividad del anuncio de seguimiento de Campaign Manager 360.
cmAdId

string (int64 format)

Opcional. Es el ID del anuncio de seguimiento de Campaign Manager 360.

ObaIcon

Ícono de OBA para una creatividad

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

string

Opcional. Es la URL del recurso del ícono de la OBA.
resourceMimeType

string

Opcional. Es el tipo de MIME del recurso del ícono de OBA.
position

enum (ObaIconPosition)

Opcional. Es la posición del ícono de la OBA en la creatividad.
dimensions

object (Dimensions)

Opcional. Son las dimensiones del ícono de OBA.
program

string

Opcional. Programa del ícono de OBA. Por ejemplo, “AdChoices”.
landingPageUrl

string

Obligatorio. Es la URL de la página de destino del ícono de la OBA.

Solo se permiten las URLs de los siguientes dominios:

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

string

Obligatorio. Es la URL de seguimiento de clics del ícono de OBA.

Solo se permiten las URLs de los siguientes dominios:

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

string

Obligatorio. Es la URL de seguimiento de vistas del ícono de OBA.

Solo se permiten las URLs de los siguientes dominios:

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

ObaIconPosition

Es la posición del ícono de la OBA en la creatividad.

Enumeraciones
OBA_ICON_POSITION_UNSPECIFIED No se especificó la posición del ícono de la OBA.
OBA_ICON_POSITION_UPPER_RIGHT En la parte superior derecha de la creatividad
OBA_ICON_POSITION_UPPER_LEFT En la parte superior izquierda de la creatividad
OBA_ICON_POSITION_LOWER_RIGHT En la parte inferior derecha de la creatividad
OBA_ICON_POSITION_LOWER_LEFT En la parte inferior izquierda de la creatividad

ExpandingDirection

Es la dirección de expansión de la creatividad expandible de terceros.

Enumeraciones
EXPANDING_DIRECTION_UNSPECIFIED No se especificó la dirección de expansión.
EXPANDING_DIRECTION_NONE No se expande en ninguna dirección.
EXPANDING_DIRECTION_UP Se expande hacia arriba.
EXPANDING_DIRECTION_DOWN Se expande hacia abajo.
EXPANDING_DIRECTION_LEFT Se expande hacia la izquierda.
EXPANDING_DIRECTION_RIGHT Se expande hacia la derecha.
EXPANDING_DIRECTION_UP_AND_LEFT Se expande hacia arriba y hacia el lado izquierdo.
EXPANDING_DIRECTION_UP_AND_RIGHT Se expande hacia arriba y hacia el lado derecho.
EXPANDING_DIRECTION_DOWN_AND_LEFT Se expande hacia abajo y hacia el lado izquierdo.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Se expande hacia abajo y hacia el lado derecho.
EXPANDING_DIRECTION_UP_OR_DOWN Se expande hacia arriba o hacia abajo.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Se expande hacia la izquierda o la derecha.
EXPANDING_DIRECTION_ANY_DIAGONAL Se puede expandir en cualquier dirección diagonal.

Métodos

create

 Crea una creatividad nueva.

delete

 Borra una creatividad.

get

 Obtiene un elemento creativo.

list

 Enumera las creatividades de un anunciante.

patch

 Actualiza una creatividad existente.