Uso de macros en TAP

Anterior Siguiente

Vea también: Macros para compradores

En esta página:

Una macro es un marcador de posición que normalmente se usa en una URL de rastreador de terceros (píxel de impresión de audio) que el ad server de Triton reemplaza con un valor específico en el momento de la entrega. Esto se hace para completar dinámicamente los parámetros de consulta de URL del servicio de atribución y rastreador de terceros con valores específicos para ese anuncio, contenido o usuario.

Es posible que tenga que editar las macros para que se ajusten a la @MACRO@ formato, como se describe a continuación.

Formato de macros de Triton Digital

Las macros no distinguen entre mayúsculas y minúsculas, pero es preferible y recomendable usar TODOS LOS CARACTERES EN MAYÚSCULAS.

Las macros deben estar en formato Triton Digital @MACRO@. Algunos formatos se convierten automáticamente al formato de Triton Digital, por lo que puede usarlos tal cual (consulte la lista a continuación). De lo contrario, deberá editarlos manualmente para @MACRO@ antes de pegarlos en su URL de píxel/clic de salida. Por ejemplo, si la URL contiene una macro como _IP_ tiene que cambiarlo manualmente por @IP@.

Los formatos que automáticamente se convierten en @MACRO@ Los formatos son:

  • %%MACRO%%

  • ${MACRO}

  • [MACRO]

Los símbolos de formato de macro tienen codificación URL cuando aparecen en la barra de direcciones de un navegador web.

Macros para direccionamiento de Triton Digital

Las siguientes tablas incluyen las macros de Triton Digital más utilizadas en el direccionamiento.

También existen otras macros para uso más especializado; para obtener más información, hable con su especialista en soluciones de Triton Digital o con su administrador de éxito del cliente.

Macros de contenido para podcast

Nombre de la macro

Campo RSS

Descripción

Valor de ejemplo

C.SERIES-TITLE

canal/título

Título de la serie de contenidos.

ASESINATO EN UN PUEBLO PEQUEÑO

C.SERIES-TYPE

canal/itunes:tipo

Tipo de la serie de contenidos
Valores válidos: "episódico" o "serial."

EPISÓDICA

C.ITUNES-CAT

canal/itunes:categoría

Categoría de podcast

ARTES

C.ITUNES-SUBCAT

canal/itunes:categoría/itunes:categoría

Subcategoría de podcast (la primera definida).

LIBROS

C.EPISODE-SEASON

canal/item/itunes:temporada

Número de temporada.

1

C.EPISODE-NUMBER

canal/item/itunes:episodio

Número de episodio.

232

C.EPISODE-TITLE

canal/item/itunes:título ELSE canal/item/título

Título del episodio.

#232 - UNA EXTRAÑA FORMA DE TORTURAR - LAUREL, DELAWARE

C.EPISODE-URL

canal/item/contenedor/url

URL de origen del episodio mapeada desde la URL del contenedor.

https://omny.fm/shows/small-town-murder/232-a-strange-way-to-torture-laurel-delaware.mp3

C.EPISODE-TYPE

canal/item/itunes:tipo

Tipo de episodio
Valores válidos: "completo", "tráiler", o "adicional".

COMPLETO

C.PUBDATE

canal/item/pubdate

Fecha de publicación.

MAR, 28 SEP 2021 22:01:00 +0000

C.EPISODE-ID-RAW

canal/item/guid

ID único del episodio (desde el RSS feed); 1024 caracteres como máximo.

97095c68-aa62-40dc-930b-adb100c34ec8

C.EPISODE-ID-RSS

canal/item/guid

ID único del episodio (desde el RSS feed); con cifrado hash

efb909f5beceae6e9bae7270d132b258

C.EPISODE-ID-TRITON

---

ID único del episodio (generado por Triton)

893583-a53e9705a731ef20ed0401ae8fd7

Macros del reproductor/oyente

Nombre de la macro

Descripción

Valor de ejemplo

P.CITY

Ciudad del oyente

PORTLAND

P.COUNTRY

País del oyente

EE. UU.

P.DMA

DMA del oyente

501

P.GAM-PALN

Nonce (valor arbitrario ocasional) generado por el publisher (número de serie exclusivo para que la transacción sea única). Se utiliza para pasar el valor gam-paln del publisher a Google Ad Manager (GAM). Debe contener un valor "nonce", que usualmente es generado por el PAL SDK de GAM.

Si usa un archivo VAST externo de GAM, el publisher recibe una secuencia de Google (en general, un token JWT) que debe pasar a Triton Digital en un parámetro (gam-paln). Luego el publisher debe verificar que el archivo VAST contenga la secuencia: ?givn=${p.gam-paln}


P.MSA

MSA del oyente (consulte TAP Explore MSA notas de uso)

5600

P.REGION

Región del oyente (como el estado de EE. UU. o la provincia canadiense)

o

P.TTAG

Etiqueta de direccionamiento personalizada (puede ser una cadena separada por comas)

FOO,BAR

Otra macro compatible

Nombre de la macro

Descripción

Valor de ejemplo

Macros del inventario

BUYER_ID

El ID del anunciante del vuelo.

12345

CAMPAIGN_ID

La ID numérica de la campaña.

884461

IAB_CATEGORÍAS_PARA_EXCLUIR

Una lista separada por comas de IAB categorías que el publisher desea excluir en la solicitud de anuncio

IAB2-2,IAB24

PUB_ID

La ID numérica del publisher asignada por Triton Digital.

5679

PUB_NAME

El nombre del publisher.

BLORK_RADIO

STATION_ID

La ID numérica de la estación asignada por Triton Digital.

12345

STATION_NAME

El nombre de la estación.

KSADFM

Macros del oyente

AD_ID

La ID de la publicidad móvil (iOS o Android; es decir, IDFA o AdID).

COOKIE

La ID de cookie de Triton Digital.

GAID

La ID de publicidad de Google (dispositivos con Android).

IDFA

El IDFA de Apple (dispositivos iOS).

IP

La dirección IP del dispositivo.

USERAGENT

El encabezado User-Agent del dispositivo.

Macros transitorios

CACHEBUSTER

Una secuencia aleatoria para cache-busting. La cadena es siempre un entero positivo con una longitud fija de 9 dígitos.

RANDOM

Una secuencia aleatoria para cache-busting.

TIMESTAMP

Marca de tiempo Unix en segundos.

Macros normativas

Triton Digital es compatible con las siguientes macros relacionadas con la privacidad y definidas por la IAB:

  • ${GDPR}

  • ${GDPR_CONSENT_XXXXX} (donde XXXXX es el identificador numérico del proveedor de seguimiento donde se usa la macro)

  • ${US_PRIVACY}

  • ${GPP_STRING_XXXXX} (donde XXXXX es el identificador numérico del proveedor de seguimiento donde se usa la macro)

  • ${GPP_STRING}

  • ${GPP_SID}

Se espera que estas macros estén en etiquetas de terceros para compartir las elecciones de privacidad de los oyentes. Para más información, consulte las especificaciones de formato de la IAB: