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. El ID único del anunciante al que pertenece la creatividad

string (int64 format)

Solo salida. El ID único de la creatividad Lo asigna 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 sincronizadas 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 se puede publicar o no.

Valores aceptados:

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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. Es la marca de tiempo en la que se creó la creatividad. Lo asigna el sistema.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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. Es 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. Son las dimensiones principales de la creatividad. Se aplica a todos los tipos de creatividades. El valor de widthPixels y heightPixels se establece de forma predeterminada en 0 cuando creativeType es uno de los siguientes:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO

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.

string (Duration format)

Solo salida. Es la duración del medio 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

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

enum (CreativeAttribute)

Solo salida. 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. Recursos 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 su 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 formatos rich media.

object (TimerEvent)

Eventos personalizados de temporizador para una creatividad rich media. Los cronómetros realizan un seguimiento del tiempo durante el cual un usuario visualiza una parte específica de una creatividad rich media e interactúa con ella. Una creatividad puede incluir varios eventos de tiempo de exposición, cada uno con un registro independiente. Déjela vacía o no la establezca para las creatividades que contengan recursos de imagen únicamente.

object (CounterEvent)

Eventos de contador para una creatividad de rich media. Los contadores realizan 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 o fuera de él, clics, presiones, carga de datos, entradas del teclado, etc.). Cualquier evento que pueda capturarse en la creatividad se puede registrar como un contador. Déjela vacía o no la establezca para las creatividades que contengan 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 usa para vincular esta creatividad a un sistema externo. Debe estar codificado en UTF-8 con una longitud de no más de 10,000 caracteres.

string

Notas del usuario para esta creatividad. Debe estar codificado en UTF-8 con una longitud de no más de 20,000 caracteres.

boolean

Indica si está habilitada la supervisión de campañas de Integral Ad Science (IAS). Para habilitar esta función 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 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 se muestran alrededor del reproductor de video mientras se reproduce el video y permanecen después de que este finalice.

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

boolean

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)

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

El tiempo durante el cual se reproduce el 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. Es un identificador opcional de creatividades que proporciona un registro y que es único en todas las plataformas.

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

Este campo solo es compatible con los siguientes creativeType:

• CREATIVE_TYPE_VIDEO

object (ThirdPartyUrl)

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

Este campo solo es compatible con los siguientes creativeType:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Transcode)

Solo salida. Transcodificaciones de audio y video

Display & Video 360 transcodifica el elemento principal en varias versiones alternativas que usan diferentes 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 del publicador más opciones para elegir para cada impresión de tu video y garantizan que se publique el archivo apropiado 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

URL de seguimiento para proveedores de estadísticas o proveedores de tecnología publicitaria de terceros

Las URLs deben comenzar con https (excepto en inventarios que no requieren cumplimiento de SSL). Si usa macros en su URL, use solo macros compatibles con Display & Video 360.

Solo se permiten URL estándares, no se admiten 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

string

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

object (CmTrackingAd)

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

Opcional para el siguiente creativeType cuando lo crea un anunciante que usa Campaign Manager 360 y la publicación de anuncios de terceros:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE

Resultado 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 original de terceros que se usa para la creatividad.

Obligatorio y solo es válido para creatividades de etiquetas de terceros.

Las creatividades de etiqueta de terceros son creatividades con las siguientes 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 móviles para la interactividad, como deslizar o presionar.

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

Las creatividades de etiqueta de terceros son creatividades con las siguientes 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álido para creatividades de etiquetas de terceros. Las creatividades de etiqueta de terceros son creatividades con las siguientes 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á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álido para creatividades de etiquetas de terceros o creatividades de etiquetas VAST de terceros.

Las creatividades de etiqueta de terceros son creatividades con las siguientes hostingSource:

• HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes creativeType:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

Las creatividades de etiquetas VAST de terceros son creatividades con las 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.

Obligatorio y solo es válido para creatividades expandibles de terceros.

Las creatividades expandibles de terceros son aquellas 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álido para creatividades expandibles de terceros. Las creatividades expandibles de terceros son aquellas 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 de VAST para una creatividad de etiqueta de VAST de terceros.

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

Las creatividades de etiquetas VAST de terceros son creatividades con las 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 del reproductor de video digital).

Es solo de salida y es válida únicamente para creatividades de etiquetas de VAST de terceros.

Las creatividades de etiquetas VAST de terceros son creatividades con las 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 es válida únicamente para creatividades de etiquetas de VAST de terceros.

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

• HOSTING_SOURCE_THIRD_PARTY

Combinado con los siguientes creativeType:

• CREATIVE_TYPE_VIDEO

string (int64 format)

Solo salida. Son los ID 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 en su lugar.

boolean

Solo salida. Indica que la creatividad de audio de terceros admite 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 las 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 las 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 que se necesita 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 la revisión de políticas y el contenido de la creatividad

object (ExchangeReviewStatus)

Estado 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 del intercambio.

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

string

El publicador que está revisando la creatividad

enum (ReviewStatus)

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

Es el ID de medios del activo que se subió. 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 medios actualizado el 5 de abril de 2023 Actualiza los IDs de medios almacenados en caché antes del 5 de abril de 2023 recuperando el nuevo ID de medios de los recursos de creatividades asociados o volviendo a subir el recurso.

string

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

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

enum (ExitEventType)

Obligatorio. Es 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

El nombre de la etiqueta de clic del evento de salida.

El nombre debe ser único dentro de una creatividad.

Déjela vacía o no la establezca para las creatividades que contengan recursos de imagen únicamente.

string

Es el nombre que se usa para identificar este evento en los informes. Déjela vacía o no la establezca para las creatividades que contengan recursos de imagen únicamente.

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

string

Obligatorio. El nombre del evento de 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)

Es la compensación 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

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

Proporciona una URL con ruta de acceso opcional o cadena de consulta 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

El tipo de MIME del archivo transcodificado.

boolean

Indica si la transcodificación se realizó correctamente.

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

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

Es 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

El tipo de MIME del recurso de ícono de OBA.

enum (ObaIconPosition)

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

object (Dimensions)

Las dimensiones del ícono de OBA.

string

Indica el programa del ícono de la 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 vista del ícono de OBA.

Solo se permiten las URLs de los siguientes dominios:

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