REST Resource: advertisers.creatives

Recurso: Creative

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. 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 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). Asignada por el sistema.

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. Asignada por el sistema.

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 predeterminado de widthPixels y heightPixels es 0 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. Puede agregar una salida a su 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 hacen un seguimiento del tiempo durante el cual un usuario ve una parte específica de una creatividad rich media e 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 establecido para las creatividades que contienen recursos de imagen únicamente.
counterEvents[]

object (CounterEvent)

Eventos de contador para una creatividad rich media. Los contadores hacen un seguimiento de 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, desplazamientos del mouse fuera, clics, presiones, 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

La información del ID que se utiliza para vincular esta creatividad a un sistema externo. Debe estar codificado en UTF-8 y con 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 tener 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 esto para la creatividad, asegúrate de que Advertiser.creative_config.ias_client_id se haya establecido con 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 elementos complementarios aparecen alrededor del reproductor de video mientras se reproduce el video y permanecen allí una vez que este finaliza.

Las creatividades que contienen 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)

La cantidad de tiempo de reproducción del video antes de que aparezca el botón 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)

Hacer un seguimiento de las URLs de terceros para realizar 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 de un publicador más opciones para elegir para cada impresión en tu video y garantizan que se publique el archivo adecuado según la conexión del usuario y el tamaño de la pantalla.

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

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

Opcional para los siguientes creativeType si los crea un anunciante que usa 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 usa para la creatividad.

Es obligatorio y solo es válido para creatividades de 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
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 de etiqueta de terceros son creatividades con los siguientes elementos hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

se combinó 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 aquellas que tienen el siguiente 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 de etiqueta de terceros son creatividades con los siguientes elementos hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

se combinó 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

se combinó 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 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 creatividades que tienen la siguiente fuente de hosting:

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

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

  • HOSTING_SOURCE_THIRD_PARTY

se combinó 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 digital).

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

se combinó 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álida para creatividades de etiquetas VAST de terceros.

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

  • HOSTING_SOURCE_THIRD_PARTY

se combinó 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 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.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

se combinó 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 el siguiente 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 alojamiento no se especifica o es desconocida 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 una de las siguientes opciones:

  • 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 creativeType es una de las siguientes opciones:

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

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

object (ExchangeReviewStatus)

Estados de revisión de intercambio de la creatividad.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Estados de revisión del publicador para la creatividad.

Estado de aprobación

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

Enumeraciones
APPROVAL_STATUS_UNSPECIFIED No se especificó el valor del tipo en esta versión o se desconoce.
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 creatividad y la revisión de la página de destino y se puede publicar, pero está a la espera de contenido adicional y revisión de cumplimiento de las políticas.
APPROVAL_STATUS_APPROVED_SERVABLE Tanto las creatividades la revisión y el contenido de la página de destino, y revisión de cumplimiento de 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 estado de revisión.

Enumeraciones
REVIEW_STATUS_UNSPECIFIED El valor de tipo no se especifica o es desconocido en esta versión.
REVIEW_STATUS_APPROVED Se aprobó la creatividad.
REVIEW_STATUS_REJECTED Se rechazó 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 intercambio que revisa la creatividad
status

enum (ReviewStatus)

Estado de la revisión del cambio.

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)

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)

La función de este recurso para la creatividad.

Recurso

Un solo activo.

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

string (int64 format)

Es el ID de los medios del recurso 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 ID de contenido multimedia se actualizó el 5 de abril de 2023. Actualiza los IDs de medios almacenados en caché antes del 5 de abril de 2023. Para ello, recupera el nuevo ID de contenido multimedia de los recursos de creatividades asociados o vuelve a subir el recurso.
content

string

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

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

Esta función 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 con una longitud de no más de 50 caracteres.

Esta función solo se admite en los siguientes creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Texto del cuerpo de una creatividad nativa.

El content debe estar codificado en UTF-8 y con 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 y 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 la página de destino es "http://www.example.com/page", la URL de la 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 tener una longitud de no más de 15 caracteres.

Esta función 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 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

El precio de compra de tu app en Google Play Store o en la 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 proporciona al guardar 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 aplicación, 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 aplicación para iOS en la App Store 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

Es 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 proporciona al guardar la creatividad.

Los recursos de este rol son de solo lectura.
ASSET_ROLE_ICON

Es el ícono de una creatividad.

Esta función solo se admite y es obligatoria 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.

Esta función solo se admite y es obligatoria en los siguientes creativeType:

  • CREATIVE_TYPE_VIDEO

ExitEvent

Evento de salida de la creatividad.

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

enum (ExitEventType)

Obligatorio. El tipo del evento de salida.
url

string

Obligatorio. Es la URL de clic del evento de salida. Esto es obligatorio cuando type es lo siguiente:

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

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. Podría haber varios eventos de salida de copia de seguridad en una creatividad.

TimerEvent

Es el evento del 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 del 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 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)

El desplazamiento en porcentaje de la duración de audio o video.
seconds

string (int64 format)

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

UniversalAdId

Un identificador de creatividad proporcionado por un registro 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 No se especifica el registro de anuncios universales o se desconoce 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 el ID del anuncio para proporcionar el ID del 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

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)

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

string

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

Proporciona una URL con una ruta de acceso o una cadena de consulta opcionales 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 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 del 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 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 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 realizar un seguimiento de la cantidad de veces que un usuario silencia el audio o 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 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 realizar un seguimiento de la cantidad de veces que un usuario expande el reproductor al tamaño de pantalla completa.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Se usa para realizar un seguimiento de la cantidad de veces que un usuario detiene el audio o 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, como hacer clic 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 realizar un seguimiento de la cantidad de veces que se reproduce un audio o video en un desplazamiento determinado por el 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

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)

Las dimensiones del video transcodificado.
bitRateKbps

string (int64 format)

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

number

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

string (int64 format)

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)

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)

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

El ID de 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)

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 de MIME del recurso del ícono de OBA.
position

enum (ObaIconPosition)

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

object (Dimensions)

Las dimensiones del ícono de 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 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 Se encuentra 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 la izquierda.
EXPANDING_DIRECTION_UP_AND_RIGHT Se expande hacia arriba y hacia la derecha.
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 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.