REST Resource: advertisers.creatives

{
  "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
}

string

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

string (int64 format)

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

string (int64 format)

Solo salida. Es el ID único de la creatividad. Asignada por el sistema.

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.

string

Obligatorio. Es el nombre visible de la creatividad.

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

enum (EntityStatus)

Obligatorio. Controla si la creatividad puede publicarse o no.

Valores aceptados:

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

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

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

enum (CreativeType)

Obligatorio. Inmutable. Indica el tipo de creatividad.

enum (HostingSource)

Obligatorio. Indica dónde se aloja la creatividad.

boolean

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

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

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.

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

enum (CreativeAttribute)

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

object (ReviewStatusInfo)

Solo salida. Es el estado actual del proceso de revisión de creatividades.

object (AssetAssociation)

Obligatorio. Son los elementos asociados a esta creatividad.

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.

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.

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.

string

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

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.

string

Notas del usuario sobre esta creatividad. Debe estar codificado en UTF-8 y con una longitud máxima de 20,000 caracteres.

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.

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

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

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

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

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

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

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

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

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

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.

object (ObaIcon)

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

Este campo solo se admite en los siguientes creativeType:

• CREATIVE_TYPE_VIDEO

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

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

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

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

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

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

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

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

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

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.

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

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

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

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

Estado de revisión de contenido y políticas de la creatividad.

object (ExchangeReviewStatus)

Estados de revisión de intercambio de la creatividad.

object (PublisherReviewStatus)

Estados de revisión del publicador de la creatividad

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

enum (Exchange)

El intercambio que revisa la creatividad

enum (ReviewStatus)

Estado de la revisión de intercambio.

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

string

El publicador que revisa la creatividad.

enum (ReviewStatus)

Estado de la revisión del publicador.

{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}

object (Asset)

El activo asociado.

enum (AssetRole)

La función de este recurso para la creatividad.

{
  "mediaId": string,
  "content": string
}

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.

string

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

{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}

enum (ExitEventType)

Obligatorio. El tipo del evento de salida.

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

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.

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.

{
  "name": string,
  "reportingName": string
}

string

Obligatorio. El nombre del evento del temporizador.

string

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

{
  "name": string,
  "reportingName": string
}

string

Obligatorio. El nombre del evento de contador.

string

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

{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}

string (int64 format)

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

string (int64 format)

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

{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}

string

Es el identificador único de la creatividad.

enum (UniversalAdRegistry)

El registro proporciona identificadores únicos de creatividades.

{
  "type": enum (ThirdPartyUrlType),
  "url": string
}

enum (ThirdPartyUrlType)

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

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

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

string

El nombre del archivo transcodificado.

string

Es el tipo de MIME del archivo transcodificado.

boolean

Indica si se realizó correctamente la transcodificación.

object (Dimensions)

Las dimensiones del video transcodificado.

string (int64 format)

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

number

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

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.

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.

string (int64 format)

El tamaño del archivo transcodificado, en bytes.

{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}

string (int64 format)

El ID de posición del anuncio de seguimiento de Campaign Manager 360.

string (int64 format)

El ID de la creatividad del anuncio de seguimiento de Campaign Manager 360.

string (int64 format)

El ID del anuncio de seguimiento de Campaign Manager 360.

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

string

La URL del recurso del ícono de OBA.

string

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

enum (ObaIconPosition)

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

object (Dimensions)

Las dimensiones del ícono de OBA.

string

El programa del ícono de OBA. Por ejemplo: "AdChoices".

string

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

Solo se permiten las URLs de los siguientes dominios:

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

string

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

Solo se permiten las URLs de los siguientes dominios:

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

string

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

Solo se permiten las URLs de los siguientes dominios:

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