REST Resource: advertisers.creatives

Recurso: Creatividad

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. El ID único de la creatividad. Asignada por el sistema.
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 la creatividad puede publicarse o no.

Valores aceptados:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de la creatividad, ya sea por parte del usuario o del sistema (p.ej., revisión de creatividades). El sistema lo asigna.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
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 es 0 de forma predeterminada cuando creativeType es uno de los siguientes:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

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, widthPixels y heightPixels son obligatorios y deben ser mayores o iguales que 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 creatividades.
assets[]

object (AssetAssociation)

Obligatorio. Recursos asociados a esta creatividad.
exitEvents[]

object (ExitEvent)

Obligatorio. Eventos de salida para esta creatividad. Una salida (también conocida como etiqueta de clic) es cualquier área de tu creatividad en la que un usuario puede hacer clic o presionar para abrir la página de destino de un anunciante. Cada creatividad debe 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 los formatos rich media.
timerEvents[]

object (TimerEvent)

Eventos personalizados del temporizador para una creatividad rich media Los temporizadores registran el tiempo durante el cual un usuario visualiza una parte específica de una creatividad rich media y, además, interactúa con ella. Una creatividad puede incluir varios eventos de timer, cada uno con un registro de tiempo independiente. Déjalo vacío o no lo configures para las creatividades que solo contengan recursos de imagen.
counterEvents[]

object (CounterEvent)

Eventos de contador para una creatividad rich media. Los contadores registran la cantidad de veces que un usuario interactúa con cualquier parte de una creatividad rich media de una manera específica (desplazamientos del mouse sobre el anuncio o fuera de él, 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 no lo configures para las creatividades que solo contengan recursos de imagen.
appendedTag

string

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

string

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

string

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

boolean

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 Advertiser.creative_config.ias_client_id se haya configurado en tu ID de cliente de IAS.
companionCreativeIds[]

string (int64 format)

Los IDs de las creatividades complementarias de una creatividad de video.

Puedes asignar creatividades gráficas existentes (con recursos de imagen o HTML5) para que se publiquen en torno al reproductor de video del publicador. Los anuncios complementarios se muestran alrededor del reproductor de video mientras se reproduce el video y permanecen después de que este finaliza.

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

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Indica si el usuario puede omitir una creatividad de video.

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Es la cantidad de tiempo que se reproduce el video antes de que aparezca el botón para omitir.

Este campo es obligatorio cuando skippable es verdadero.

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Es la cantidad de tiempo que se debe reproducir el video antes de registrar una vista.

Este campo es obligatorio cuando skippable es verdadero.

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

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

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

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

Este campo solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Solo salida. Transcodificaciones 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 para cada impresión en tu video y garantizan que se publique el archivo adecuado en función de 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

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

Las URLs deben comenzar con https (excepto en el inventario que no requiere cumplimiento de SSL). Si usas macros en tu URL, usa solo macros compatibles con 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

URL de medición de JavaScript de proveedores de verificación externos admitidos (ComScore, DoubleVerify, IAS y Moat). No se admiten 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)

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)

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 creatividades de etiquetas de terceros.

Las creatividades con etiquetas de terceros son aquellas que tienen el siguiente 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 esta opción si la creatividad se basa en gestos para dispositivos móviles para la interactividad, como deslizar o presionar.

Opcional y solo es válida para creatividades de etiquetas de terceros.

Las creatividades con etiquetas de terceros son aquellas que tienen el siguiente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Opcional. Indica que la creatividad se basa en HTML5 para renderizarse correctamente.

Es opcional y solo es válido para las creatividades con etiquetas de terceros. Las creatividades de etiqueta de terceros son creatividades con los siguientes elementos 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}.

Opcional y solo es válida para creatividades de etiquetas de terceros o de etiquetas VAST de terceros.

Las creatividades con etiquetas de terceros son aquellas que tienen el siguiente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Las creatividades con etiquetas VAST de terceros son aquellas que tienen el siguiente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes 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 aquellas que tienen 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 creatividades expandibles de terceros. Las creatividades expandibles de terceros son aquellas que tienen 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 VAST de una creatividad de etiqueta VAST de terceros.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes 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 digital).

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

Las creatividades de etiqueta 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 de VAST de terceros requiere compatibilidad con videos HTML5.

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

Las creatividades con etiquetas VAST de terceros son aquellas que tienen el siguiente hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinado con el siguiente creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Solo salida. Los IDs de las líneas de pedido con las que está asociada esta creatividad

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

boolean

Solo salida. Indica que la creatividad de audio de terceros es compatible con MP3.

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

Las creatividades de audio de terceros son aquellas que tienen 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 de salida y solo es válida para creatividades de audio de terceros.

Las creatividades de audio de terceros son aquellas que tienen los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

Posibles fuentes de hosting de una creatividad. Indica dónde se crea y aloja una creatividad.

Enumeraciones
HOSTING_SOURCE_UNSPECIFIED La fuente de hosting no se especificó o se desconoce en esta versión.
HOSTING_SOURCE_CM

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 creativeType es uno de los siguientes:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

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 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 rich media creada en Studio y alojada por Campaign Manager 360.

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

CreativeAttribute

Son los posibles atributos de una creatividad.

Enumeraciones
CREATIVE_ATTRIBUTE_UNSPECIFIED En esta versión, no se especificó el atributo de la creatividad o se desconoce.
CREATIVE_ATTRIBUTE_VAST La creatividad es de VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR La creatividad es de VPAID lineal.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR La creatividad es una creatividad de VPAID no lineal.

ReviewStatusInfo

Revise los estados 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 una creatividad comience a publicarse. Resumen de creativeAndLandingPageReviewStatus y contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

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

enum (ReviewStatus)

Estado de revisión del contenido y de las políticas de la creatividad
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Estados de revisión de Exchange para la creatividad
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Estados de revisión del publicador de la creatividad

Estado de aprobación

Posibles tipos de estado de aprobación. Es el resumen de creativeAndLandingPageReviewStatus y contentAndPolicyReviewStatus.

Enumeraciones
APPROVAL_STATUS_UNSPECIFIED El valor de tipo no se especifica o es desconocido en esta versión.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La creatividad todavía está en proceso de revisión y no se puede publicar.
APPROVAL_STATUS_PENDING_SERVABLE La creatividad pasó 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 la revisión de la creatividad y la página de destino, y 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 para que se pueda publicar.

ReviewStatus

Posibles tipos de estados de revisión

Enumeraciones
REVIEW_STATUS_UNSPECIFIED No se especificó el valor del tipo en esta versión o se desconoce.
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

Estado de revisión de Exchange de la creatividad.

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

enum (Exchange)

El mercado de intercambio que revisa la creatividad
status

enum (ReviewStatus)

Estado de la revisión de intercambio.

PublisherReviewStatus

Estado de revisión del publicador de la creatividad.

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

string

El publicador que revisa la creatividad
status

enum (ReviewStatus)

Es el estado de la revisión del publicador.

AssetAssociation

Asociación de recursos para la creatividad.

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

object (Asset)

El activo asociado.
role

enum (AssetRole)

El rol de este recurso para la creatividad.

Recurso

Un solo activo

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

string (int64 format)

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

El espacio de Media ID se actualizó el 5 de abril de 2023. Para actualizar los IDs de medios almacenados en caché antes del 5 de abril de 2023, recupera el nuevo ID de medios de los recursos de creatividad asociados o vuelve a subir el activo.
content

string

El contenido del activo En el caso de los recursos subidos, el contenido es la ruta de publicación.

AssetRole

El rol de este recurso para la creatividad.

Enumeraciones
ASSET_ROLE_UNSPECIFIED El rol del recurso no se especificó o se desconoce en esta versión.
ASSET_ROLE_MAIN El recurso es el recurso principal de la creatividad.
ASSET_ROLE_BACKUP El recurso es un recurso de copia de seguridad de la creatividad.
ASSET_ROLE_POLITE_LOAD El recurso es un recurso de carga educado de la creatividad.
ASSET_ROLE_HEADLINE

Es el título de una creatividad nativa.

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

Este rol solo es compatible con los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Título largo de una creatividad nativa.

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

Este rol solo es compatible con 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 es compatible con 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 con una longitud de no más de 150 caracteres.

Este rol solo es compatible con 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 fácil de entender de la URL de página de destino que se mostrará en la creatividad. Esta URL les da a las personas 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 página de destino es “http://www.example.com/página”, la URL de leyenda puede ser “example.com”. El protocolo (http://) es opcional, pero la URL no puede contener espacios ni caracteres especiales.

Este rol solo es compatible con 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 con una longitud de no más de 15 caracteres.

Este rol solo es compatible con 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 el nombre de la marca.

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

Este rol solo es compatible con 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 aplicación en Google Play Store o en la tienda de aplicaciones 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 con 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 tienda de aplicaciones de Apple.

Este número de ID se puede encontrar en la URL de la App Store de Apple como la cadena de números que aparece inmediatamente 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

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

Ten en cuenta que este valor no se sincroniza automáticamente con la calificación real de 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 es compatible y obligatorio 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 es compatible y obligatorio en los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO

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. La URL de clic del evento de salida. Esto es obligatorio cuando type tiene las siguientes características:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

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 no lo configures para las creatividades que solo contengan recursos de imagen.
reportingName

string

Es el nombre que se usa para identificar este evento en los informes. Déjalo vacío o no establecido para las creatividades que contienen recursos de imagen únicamente.

ExitEventType

Es el tipo de un evento de salida.

Enumeraciones
EXIT_EVENT_TYPE_UNSPECIFIED El tipo de evento de salida no se especifica 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 la 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. 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 un audio o un video que se reprodujo.

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)

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

string (int64 format)

El desplazamiento en segundos desde el inicio del audio o video.

UniversalAdId

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

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

string

Es el identificador único de la creatividad.
registry

enum (UniversalAdRegistry)

El registro proporciona identificadores de creatividad únicos.

UniversalAdRegistry

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

Enumeraciones
UNIVERSAL_AD_REGISTRY_UNSPECIFIED El registro de anuncios universales no se especifica o es desconocido en esta versión.
UNIVERSAL_AD_REGISTRY_OTHER Use un proveedor personalizado para proporcionar el ID de anuncio universal.
UNIVERSAL_AD_REGISTRY_AD_ID Usa 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 del anuncio universal.
UNIVERSAL_AD_REGISTRY_CM Usa Campaign Manager 360 para proporcionar el ID del anuncio universal.

ThirdPartyUrl

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

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

enum (ThirdPartyUrlType)

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

string

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

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

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 especifica o es desconocido en esta versión.
THIRD_PARTY_URL_TYPE_IMPRESSION Se usa para registrar 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 realizar un seguimiento de los clics de los usuarios en el audio o 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 realizar un seguimiento de la cantidad de veces que se reproduce un audio o video hasta el 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 realizar un seguimiento de la cantidad de veces que se reproduce el audio o 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 realizar un seguimiento de la cantidad de veces que un usuario pausa el audio o video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Se usa para realizar un seguimiento de la cantidad de veces que un usuario vuelve a reproducir el audio o 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 realizar un seguimiento de la cantidad de veces que un usuario hace un clic personalizado, como 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 se reproduce el audio o el video en 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

Es el nombre del archivo transcodificado.
mimeType

string

Es el tipo MIME del archivo transcodificado.
transcoded

boolean

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

object (Dimensions)

Son las dimensiones del video transcodificado.
bitRateKbps

string (int64 format)

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

number

La velocidad de fotogramas del video transcodificado, expresada en fotogramas por segundo.
audioBitRateKbps

string (int64 format)

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)

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

string (int64 format)

El tamaño del archivo transcodificado, en bytes.

CmTrackingAd

Un anuncio de seguimiento de Campaign Manager 360

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

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

string

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

enum (ObaIconPosition)

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

object (Dimensions)

Son las dimensiones del ícono de la OBA.
program

string

El programa del ícono de la OBA. Por ejemplo, "AdChoices".
landingPageUrl

string

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

Solo se permiten las URLs de los siguientes dominios:
clickTrackingUrl

string

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

Solo se permiten las URLs de los siguientes dominios:
viewTrackingUrl

string

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

Solo se permiten las URLs de los siguientes dominios:

ObaIconPosition

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

Enumeraciones
OBA_ICON_POSITION_UNSPECIFIED No se especificó la posición del ícono de OBA.
OBA_ICON_POSITION_UPPER_RIGHT En la parte superior derecha de la creatividad.
OBA_ICON_POSITION_UPPER_LEFT Se encuentra en el lado superior izquierdo 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 especifica 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 la derecha.
EXPANDING_DIRECTION_DOWN_AND_LEFT Se expande hacia abajo y hacia la izquierda.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Se expande hacia abajo y hacia la derecha.
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 una creatividad.

list

 Muestra las creatividades de un anunciante.

patch

 Actualiza una creatividad existente.