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. Es 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. Indica la marca de tiempo en la que el usuario o el sistema actualizó la creatividad por última vez (p.ej., la revisió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".

createTime

string (Timestamp format)

Solo salida. Indica la marca de tiempo en la que se creó 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. Indica 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. 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, los valores de widthPixels y heightPixels son obligatorios y deben ser mayores o iguales que 0.

mediaDuration

string (Duration format)

Solo salida. Duración de medios 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. Son los elementos 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:

  • Usar el área para presionar de Google Web Designer
  • Define una variable de JavaScript llamada "clickTag".
  • Use Enabler (Enabler.exit()) para realizar un seguimiento de las salidas en formatos de 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 cronómetro, cada uno con un registro independiente. Déjalo vacío o no establecido para las creatividades que contienen recursos de imagen únicamente.

counterEvents[]

object (CounterEvent)

Son 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 establecido para las creatividades que contienen recursos de imagen únicamente.

appendedTag

string

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

Notas del usuario sobre 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 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)

Son los ID de las creatividades complementarias para 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 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 optar por 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)

La cantidad de tiempo de reproducción del video antes de contar 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

Anuncios gráficos y Video 360 transcodifica el activo principal en varias versiones alternativas que usan distintos formatos de archivo o tienen propiedades diferentes (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 externos de tecnología publicitaria.

Las URLs deben comenzar con https (excepto en el inventario que no requiere el cumplimiento de SSL). Si utiliza macros en su URL, use solo las macros compatibles con Display & Video en 360°

Solo URL estándar, sin etiquetas IMG ni SCRIPT.

Este campo solo se puede escribir en el siguiente 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 compatibles (ComScore, DoubleVerify, IAS, Moat). Las etiquetas de secuencias de comandos HTML no son compatibles.

Este campo solo se puede escribir en el siguiente 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

Salida solo 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 los siguientes 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 de 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

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

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

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

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

Solo es válida 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

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

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

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Opcional. Indica que la creatividad se expande automáticamente cuando se coloca el cursor sobre ella.

Opcional y solo es válida para las creatividades expandibles de terceros. Las creatividades expandibles de terceros son creatividades que tienen la siguiente fuente de hosting:

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes 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 creatividades de etiquetas 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 reproductor de video digital).

Es solo de salida y solo es válida para creatividades de etiquetas 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_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 de etiqueta VAST de terceros son creatividades con los siguientes hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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

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

Las creatividades de audio de terceros son creatividades con 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 se 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 una de las siguientes opciones:

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

Una creatividad de 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 atributos posibles 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 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)

Estado de revisión de la creatividad y la página de destino de la creatividad.

contentAndPolicyReviewStatus

enum (ReviewStatus)

Estado de revisión de contenido y 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 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 No se especificó el valor del tipo en esta versión o se desconoce.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La creatividad aún 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 corregir para que se pueda publicar.

ReviewStatus

Tipos posibles de estado 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 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 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)

Estado de la revisión del publicador.

AssetAssociation

Asociación del recurso de 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)

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. 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 publicación.

AssetRole

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

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.

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

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.

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_BODY

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.

Esta función 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 breve y sencilla de la URL de 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 cuando hagan clic en la creatividad.

El content debe estar codificado en UTF-8 y con 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.

Esta función 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 con 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 al nombre de la marca.

El content debe estar codificado en UTF-8 y con 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_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 proporciona al guardar 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 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 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

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 en 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

La imagen de portada de una creatividad de video nativa.

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. 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 establecido para las creatividades que contienen recursos de imagen únicamente.

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 respaldo. 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. 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 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)

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 únicos de creatividades.

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 Use 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

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/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 se desconoce 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 realizar un seguimiento de la cantidad de veces que un usuario inicia el audio o video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Se usa para realizar un seguimiento de la cantidad de veces que se reproduce un audio o video hasta el 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 realizar un seguimiento de la cantidad de veces que se reproduce un audio o video hasta el 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 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 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 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 realizar un seguimiento de la cantidad de veces que se omitió un audio o 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 de MIME del archivo transcodificado.

transcoded

boolean

Indica si se realizó correctamente la transcodificación.

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

La velocidad de fotogramas del video transcodificado, expresada 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)

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)

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

La URL del recurso del í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 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 Se encuentra 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 Se ubica 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 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 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 hacia la derecha.
EXPANDING_DIRECTION_ANY_DIAGONAL Se puede expandir en cualquier dirección diagonal.

Métodos

create

Crea una nueva creatividad.

delete

Borra una creatividad.

get

Obtiene una creatividad.

list

Muestra una lista de las creatividades de un anunciante.

patch

Actualiza una creatividad existente.