#
Macros de devolución de llamada #
Las macros son marcadores de posición para valores que cambian dinámicamente en la solicitud al servidor de una URL. Estas macros están preconfiguradas para las redes integradas de Tenjin, pero conocer cómo funcionan puede resultar útil para cualquier canal personalizado que quieras añadir.
¿Para qué sirven las macros? #
Necesitamos macros para transmitir datos que cambian dinámicamente a través de parámetros de enlace de seguimiento que no varían.
Para profundizar en este tema, explicaremos cómo funcionan las URL, los parámetros, los valores y los valores que cambian dinámicamente dentro de Attribution.
URL y parámetros #
Echemos un vistazo a una URL estándar: https://track.tenjin.com?param1=value1. En esta URL se puede ver que hay una dirección de servidor track.tenjin.io y un único parámetro param1 con el valor value1. Cuando esta URL llega al servidor track.tenjin.io, el servidor de Tenjin lee esta URL y analiza el parámetro y el valor. En este caso, param1 tiene asignado el valor value1.
Para dar un ejemplo más realista relacionado con los parámetros y valores de atribución, tomemos esta URL con dos parámetros (id_publicitario y país) y dos valores: https://track.tenjin.com?advertising_id=xyz123&country=US. Cuando esta solicitud llega al servidor de Tenjin en track.tenjin.com, sabemos que el id_publicitario el dispositivo que se conecta al servidor es xyz123 con un país de EE. UU.
Valores dinámicos de los parámetros #
Ahora que sabemos cómo se pasan los valores y los parámetros a un servidor, veamos cómo se utilizan las URL en el contexto de la atribución y el seguimiento.
Para que Tenjin pueda atribuir a un usuario un clic o una impresión, Tenjin recopila información sobre el dispositivo y sus propiedades en cada clic o impresión. Estas propiedades se utilizan para cotejarlas con las propiedades recopiladas cuando se instala la aplicación en un dispositivo.
Cada vez que creas una campaña para una red que no sea SAN o un canal personalizado, se genera una URL de seguimiento de Tenjin. Esta URL de seguimiento contiene “macros” que se adaptan dinámicamente a los valores cambiantes relacionados con el clic o la impresión. Las macros se utilizan como marcadores de posición para los valores que cambian en una URL específica.
Supongamos que quieres lanzar una campaña en una red que no sea SAN. Crea un enlace de seguimiento a través del panel de control de Tenjin y facilítaselo a tu red publicitaria.
Así es como podría ser un enlace de seguimiento de Tenjin: https://track.tenjin.com?advertising_id={idfa}&country={country}
En este caso {idfa} y {país} son macros. Cuando un dispositivo utiliza este enlace, la red publicitaria rellenará estas macros con los valores reales del dispositivo. Siguiendo el ejemplo anterior, {idfa} y {país} introduciría los valores con xyz123 y US respectivamente.
Una vez rellenado, la red publicitaria o el canal accederá al servidor de Tenjin mediante la siguiente URL:
https://track.tenjin.com?advertising_id=xyz123&country=US
Por otra parte, si el dispositivo del usuario cambiara y tuviera un advertising_id de abc234 y un country de CA, la URL pasaría a ser: https://track.tenjin.com?advertising_id=abc234&country=CA
Como puedes ver, estos escenarios utilizan la misma URL, pero cambian los valores en función del dispositivo o del usuario que utiliza el enlace de seguimiento.
Las macros permiten a las redes publicitarias modificar la URL cada vez que un usuario hace clic o ve una impresión. Estas macros no son más que marcadores de posición para los valores que cambian cuando distintos usuarios interactúan con los enlaces de seguimiento.
#
Macros para las respuestas de las redes publicitarias #
Cada red publicitaria cuenta con su propio conjunto de macros de clics e impresiones para las siguientes propiedades de los dispositivos:
- Publicidad ID
- Dirección IP
- ID de paquete
- País
- Hacer clic en el ID
- Sitio web
- Plataforma del sistema operativo
- Limitar el seguimiento publicitario
- Creativo
Si la red publicitaria está preconfigurada e integrada con Tenjin, cada una de las macros de la red publicitaria aparecerá automáticamente en cada URL de clic o enlace de seguimiento de impresiones de cada campaña.
Por ejemplo:
- La macro "advertising_id" de Axon by AppLovin
tiene este aspecto:{IDFA} - La macro de Tapjoy
advertising_idtiene este aspecto:TAPJOY_ADVERTISING_ID
Por lo tanto, las URL de clic de Axon, de AppLovin y Tapjoy, podrían tener un aspecto similar al siguiente:
- Axon de AppLovin:
https://track.tenjin.com/v0/id?advertising_id={IDFA} - Tapjoy:
https://track.tenjin.com/v0/id?advertising_id=TAPJOY_ADVERTISING_ID
Una vez más, cada red tendrá su propio formato de macro. Si la red ya está preintegrada con Tenjin, no tienes que preocuparte por ello. Esto es solo para que sepas cómo se construyen las URL de clics e impresiones.
#
Macros compatibles #
Al configurar una llamada de retorno de Tenjin a otro servicio, puedes utilizar macros para representar valores de datos que cambian dinámicamente y enviarlos a otros servidores o servicios. A esto es a lo que llamamos “enrutamiento”.
Tenjin te permite “redirigir” los datos de eventos en directo a otros servidores en tiempo real.
Esta es una lista de las macros de devolución de llamada disponibles que puedes configurar al enviar datos a otros servicios.
Macros relacionadas con la aplicación #
| Macro | Explicación |
|---|---|
{{app_version}} | Versión de la aplicación. (1.0.3) |
{{bundle_id}} | ID de paquete de la aplicación. (com.tenjin.wordfinder) |
{{lowercase_bundle_id}} | El ID de paquete de la aplicación en minúsculas. (com.tenjin.wordfinder) |
{{platform}} | Plataforma de la aplicación (iOS) |
{{user_agent}} | Agente de usuario del usuario |
{{sdk_version}} | Versión del SDK de Tenjin del usuario |
{{store_id}} | ID de la aplicación en la App Store (887212194) |
Macros relacionadas con la atribución #
| Macro | Explicación |
|---|---|
{{acquired_at_s}} | Marca de tiempo del evento «Install» en segundos |
{{acquired_at_ms}} | Marca de tiempo del evento «Install» en milisegundos |
{{engaged_at_s}} | Marca de tiempo del evento de clic o de impresión, en segundos |
{{engaged_at_ms}} | Marca de tiempo del evento de clic o de impresión en milisegundos |
{{ad_network}} | Nombre del canal al que está asignado un usuario |
{{campaign_id}} | Lo mismo que {{remote_campaign_id}} |
{{campaign_name}} | Nombre de la campaña «Tenjin» a la que está asignado el usuario |
{{campaign_name_encoded}} | Nombre codificado de la campaña «Tenjin» a la que está asignado el usuario |
{{click_id}} | ID de clic del canal si el usuario se atribuye a canales de pago |
{{creative_name}} | Nombre creativo |
{{deeplink_url}} | URL de enlace directo |
{{is_conversion_integer}} | 1 para la primera vez que se abre la aplicación, 0 para el resto de eventos |
{{is_impression}} | 1 => atribución por visualización, 0 => atribución por clic |
{{is_install_or_landing}} | La primera vez que se abra la aplicación, “Install”; las siguientes veces que se abra, “landing”.” |
{{ip_address}} | Dirección IP del usuario |
{{ip_address_click}} | Dirección IP para el evento de clic o de impresión |
{{remote_campaign_id}} | ID de campaña del canal al que se atribuye al usuario |
{{site_id}} | ID del canal al que está asignado un usuario |
{{site_id_encoded}} | ID del sitio del canal codificado al que está asignado un usuario |
{{ad_network_short_id_match_type}} | Si el usuario procede de una atribución por dispositivo, probabilística o por referenciador, la parte ad_network_short_id varía según la red; ponte en contacto con nosotros para obtener más detalles. |
{{is_organic}} | ‘1’ -> el usuario se atribuye al canal orgánico; ‘0’ -> el usuario se atribuye a un canal no orgánico |
{{tenjin_campaign_id}} | ID de campaña de Tenjin al que está asignado el usuario |
{{tenjin_parameter_0}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
{{tenjin_parameter_1}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
{{tenjin_parameter_2}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
{{tenjin_parameter_3}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
{{tenjin_parameter_4}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
{{tenjin_parameter_5}} | Macro de reenvío: se puede reenviar al hacer clic en una URL |
Macros relacionadas con el identificador del dispositivo #
| Macro | Explicación |
|---|---|
{{advertising_id}} | Identificador publicitario del dispositivo |
{{analytics_installation_id}} | Identificador específico de la instalación de la aplicación. En minúsculas y sin guiones. |
{{developer_device_id}} | Identificador del proveedor (IDFV) o el identificador del dispositivo del desarrollador |
{{formatted_advertising_id}} | Identificador publicitario Formatte del dispositivo, 00000000-0000-0000-0000-000000000000 si está vacío |
{{imei}} | IMEI |
{{md5_advertising_id}} | MD5 del identificador publicitario |
{{lowercase_advertising_id}} | Identificador publicitario del dispositivo en minúsculas |
{{md5_imei}} | MD5 del IMEI |
{{md5_oaid}} | MD5 de OAID |
{{oaid}} | OAID |
{{customer_user_id}} | ID de usuario de la aplicación, tal y como se establece mediante el método setCustomerUserId del SDK |
Macros relacionadas con las propiedades de los dispositivos #
| Macro | Explicación |
|---|---|
{{allow_ad_tracking}} | ¿El dispositivo permite el seguimiento publicitario? (verdadero, falso) |
{{allow_ad_tracking_integer}} | ¿El dispositivo permite el seguimiento publicitario? (1, 0) |
{{carrier}} | Soporte para dispositivos |
{{connection_type}} | Tipo de conexión |
{{country}} | Código de país del dispositivo del usuario |
{{device}} | Dispositivo del usuario |
{{device_brand}} | Marca del dispositivo |
{{device_model}} | Modelo del dispositivo |
{{language}} | Configuración de idioma del usuario |
{{limit_ad_tracking}} | ¿El dispositivo limita el seguimiento publicitario? (verdadero, falso) |
{{limit_ad_tracking_integer}} | ¿El dispositivo limita el seguimiento publicitario? (1, 0) |
{{locale}} | Configuración regional del dispositivo |
{{os_version}} | Versión del sistema operativo del usuario |
{{os_version_release}} | Versión del sistema operativo del usuario |
{{referrer}} | Referente Android |
{{timezone}} | Zona horaria del dispositivo |
{{tracking_status}} | Número entero que indica el estado ATT del dispositivo iOS. 0 => no determinado, 1 => restringido, 2 => denegado, 3 => autorizado |
Macros relacionadas con eventos #
| Macro | Explicación |
|---|---|
{{currency}} | Código de moneda de 3 dígitos de la compra |
{{event}} | Nombre del evento |
{{time_in_seconds}} | Tiempo de solicitud en segundos |
{{time_in_ms}} | Tiempo de la solicitud en milisegundos |
{{time_iso8601}} | Solicitar la hora en formato ISO 8601 |
{{revenue}} | Ingresos brutos obtenidos por una compra en la moneda original |
{{revenue_usd_net}} | Ingresos netos en dólares estadounidenses por una compra |
{{revenue_usd_gross}} | Ingresos brutos en dólares estadounidenses por una compra |
{{value}} | Valor de evento personalizado |
{{value_micro}} | Valor de un evento personalizado dividido entre 1 000 000. Esta macro se utiliza para enviar un valor decimal mediante una llamada de retorno, enviando el valor real multiplicado por 1 000 000 a través de un evento personalizado. |
Macros relacionadas con las impresiones de anuncios #
- AppLovin
| Macro | Explicación |
|---|---|
{{ilrd::ad_unit_id}} | ID del bloque publicitario facilitado por la red ganadora |
{{ilrd::currency}} | Los ingresos publicitarios en divisas se contabilizan en |
{{ilrd::ad_format}} | Formato del bloque publicitario |
{{ilrd::mediation_country}} | País del proveedor de servicios de mediación |
{{ilrd::network_name}} | Red en la que se mostró el anuncio |
{{ilrd::ad_revenue}} | Ingresos declarados por la red publicitaria |
{{ilrd::network_placement}} | Ubicación definida por la red |
{{ilrd::placement}} | Ubicación del bloque publicitario |
{{ilrd::creative_id}} | Identificador creativo del bloque publicitario |
{{ilrd::precision}} | Exactitud de los ingresos |
- Unity LevelPlay
| Macro | Explicación |
|---|---|
{{ilrd::ab_test}} | Valor de la prueba A/B |
{{ilrd::ad_format}} | Formato del bloque publicitario |
{{ilrd::ad_revenue}} | Ingresos declarados por la red publicitaria |
{{ilrd::auction_id}} | ID de subasta procedente de la mediación de Ironsource |
{{ilrd::ecpm}} | eCPM de la mediación de Ironsource |
{{ilrd::instance_id}} | ID de instancia de la mediación de Ironsource |
{{ilrd::instance_name}} | Nombre de la instancia procedente de la mediación de Ironsource |
{{ilrd::mediation_country}} | (no se utiliza; se utilizará la macro «Tenjin country») |
{{ilrd::mediation_ltv}} | Ingresos acumulados procedentes de la mediación de Ironsource |
{{ilrd::network_name}} | Red en la que se mostró el anuncio |
{{ilrd::placement}} | Ubicación del bloque publicitario |
{{ilrd::precision}} | Exactitud de los ingresos |
{{ilrd::segment}} | Nombre del segmento procedente de la mediación de Ironsource |
- AdMob
| Macro | Explicación |
|---|---|
{{ilrd::precision}} | Tipo de precisión definido por AdMob |
{{ilrd::ad_unit_id}} | ID del bloque publicitario definido por AdMob |
{{ilrd::currency}} | Código de moneda de AdMob |
{{ilrd::adapter_class}} | Clase adaptadora de la red publicitaria |
{{ilrd::response_id}} | ID de respuesta proporcionado por AdMob |
{{ilrd::ad_revenue_micro}} | Ingresos publicitarios en microcéntimos proporcionados por AdMob |
- Topon
| Macro | Explicación |
|---|---|
{{ilrd::mediation_country}} | País del proveedor de servicios de mediación |
{{ilrd::ad_network_type}} | Tipo de red, promoción cruzada o intercambio |
{{ilrd::adsource_index}} | Ordenación de la fuente de anuncios actual en la cascada |
Atribuciones de SAN #
- Meta
| Macro | Explicación |
|---|---|
{{meta::account_id}} | Cuenta publicitaria utilizada para generar el anuncio |
{{meta::ad_id}} | Identificador único del anuncio en el que se hizo clic o que se visualizó antes de la conversión |
{{meta::ad_objective_name}} | Objetivo seleccionado al crear la campaña (por ejemplo, MOBILE_APP_INSTALLS, CONVERSIONS) |
{{meta::adgroup_id}} | ID del anuncio de Meta |
{{meta::adgroup_name}} | Nombre del anuncio meta |
{{meta::campaign_group_id}} | ID de la metacampaña |
{{meta::campaign_group_name}} | Nombre de la metacampaña |
{{meta::campaign_id}} | ID del conjunto de anuncios de Meta |
{{meta::campaign_name}} | Nombre del Meta AdSet |
{{meta::click_time}} | Fecha y hora del último clic en un anuncio antes de la atribución |
{{meta::engagement_type}} | Tipo de interacción para la atribución (p. ej., engaged_view) |
{{meta::is_fb}} | Si la instalación se realizó desde Meta |
{{meta::is_modeled}} | Si la atribución se basa en un modelo o es determinista |
{{meta::is_paid}} | Si la instalación se realizó desde un canal de pago en Meta |
{{meta::is_view_through}} | Si la atribución se basaba en las visualizaciones o en los clics |
{{meta::platform_position}} | Formato publicitario que se muestra en la plataforma |
{{meta::publisher_platform}} | Plataforma en la que se mostró el anuncio (p. ej., AUDIENCE_NETWORK, INSTAGRAM, MESSENGER, FACEBOOK) |
{{meta::view_time}} | Fecha y hora de la última visualización del anuncio antes de la atribución |
Puedes obtener más información sobre el enrutamiento y el uso de estas macros en la configuración de callbacks.