Guía de integración AppBurn! ! ! 1. Introducción! ! ¡Bienvenido a AppBurn! La manera más fácil de conectar con el tráfico móvil mundial. ! ! En AppBurn ofrecemos el mejor Mobile Trading Desk para anunciantes, agencias y publishers. Echa un vistazo a nuestra tabla de integraciones para encontrar la solución que mejor se adapte a tus necesidades.! ! ¿No la encuentras? Envía tu consulta a [email protected] y alguien de nuestro equipo se pondrá en contacto contigo. ! ! ! 2. Tipo de integraciones con AppBurn! ! ¿Quién eres? Anunciante /Agencia ¿Qué necesitas? ¿Qué te ofrecemos? Un tracker para mis campañas en dispositivos móviles. AppBurn SDK Comprar tráfico a AppBurn con la medición de un 3rd party tracker. AppBurn Pixel Comprar tráfico a Appburn midiendo conversiones en web (leads o cualquier otro evento customizado) Afiliado Que AppBurn me notifique las conversiones asociadas a mi tráfico. Custom Feedback Notifications ! !2.1 AppBurn SDK! ! Si estás buscando un tracker para tus campañas de apps… ¡AppBurn es tu solución!! ! Te ofrecemos acceso personalizado a nuestra herramienta para que puedas configurar tus propias campañas y hacer seguimiento en tiempo real de tus estadísticas. ! ! ¡Sólo tienes que instalar nuestro SDK en tu app y comenzar a medir!! ! !! 2.1.1 Instrucciones! ! !! ! 1. Descárgate la versión actualizada de nuestro iOS SDK y Android SDK.! ! !! ! 2. Define qué es lo que vas a medir con AppBurn e implementa el código en tu app:! ! ¿Qué quieres medir? ¿Qué debes implementar? OS iOS Sólo instalaciones de la app Integración Básica Obligatoria Android Registros en la app Integración Básica Obligatoria ! +! Leads Las compras, compradores y el importe de las transacciones de la app Integración Básica Obligatoria ! +! Transacciones Eventos personalizados de mi app Integración Básica Obligatoria ! +! Eventos Custom ! iOS Android iOS Android iOS Android !! ! 3. Contacta con tu account manager para verificar la implementación antes de la subida de la app a los markets.! ! !! ! 4. Sube la nueva versión de la app a AppStore o GooglePlay. ¡En cuanto la app esté aprobada empezarás a ver datos en tu Dashboard!! ! ! ! !2.2 AppBurn Pixel! !! El pixel de AppBurn puede ser usado para notificarnos conversiones en dos supuestos:! !! ! 2.2.1 !SDK 3rd party tracking! La implementación del pixel nos permitirá recoger la información relativa a las conversiones de tu aplicación sin necesidad de integrar el SDK propio de AppBurn.! Si en tu app has integrado un SDK de cualquier otro tracker, este podrá notificarnos las conversiones en tiempo real y de forma automática gracias a este tipo de integración. ! ¡Una forma muy rápida y sencilla de que podamos lanzar tu campaña sin necesidad de tocar el código de la app!! Para ello sólo necesitas configurar nuestro pixel en el mobile tracker con el que vayas a medir las instalaciones de campaña para que se notifique a Appburn siguiendo este proceso:! !! ! 1. Contacta con tu 3rd party tracker: No dudes en ponerte en contacto con el soporte técnico del propio tracker para que te expliquen cómo integrar un pixel de terceros en tu campaña. Nosotros mismos te ayudaremos en la gestión de la implementación. ! !! ! 2. Configura nuestro pixel en el 3rd party tracker: Configura el pixel siendo el aid el parámetro que enviaremos a través del click through y que debe ser devuelto en el siguiente formato:! http://eat.appburn.net/postback?aid=[AppBurn_ID] !! ! 3. Genera la url trackeada configurada ya con la notificación a AppBurn: Genera la url de redirección en tu tracker y envíanosla para que podamos montar la campaña. ! !! !! 2.2.1 Conversiones Web! ! La implementación del pixel nos permitirá recoger la información relativa a las conversiones de tu web como por ejemplo un registro o una compra. ! Para ello es necesario que se llame a nuestro pixel cada vez que dicho evento ocurra, siendo el aid el parámetro que enviaremos a través del click through y que debe ser devuelto en cualquier de los siguientes formatos:! http://eat.appburn.net/postback?aid=[AppBurn_ID] <img src=” http://eat.appburn.net/postback? aid=[AppBurn_ID]” width=”1px” height=”1px” Alt=”” /> <script language=”javascript” src=” http:// eat.appburn.net/postback?aid=[AppBurn_ID]”>! ! <noscript><img src=” http://eat.appburn.net/postback? aid=[AppBurn_ID]” width=”1” height=”1” border=”0”> 2.3 Custom Feedback Notifications! ! AppBurn permite notificar las conversiones asociadas a cada uno de los afiliados. ! ! Consulta nuestro listado de partners para asegurar si el afiliado se encuentra ya integrado o no con nuestro sistema.! ! Si la respuesta es no, envía tu pixel a [email protected] especificando los parámetros que necesitas que te sean devueltos en la notificación. ! ! Usa nuestra tabla de parámetros custom para saber con qué nombre debes enviárnoslos:! ! Nombre exid dp ! ! Descripción del Parámetro Identificador personalizado Dispositivo (iPhone, iPad, Galaxy S1,…) appname Nombre de la app en la que el click se ha ejecutado appcats Categoría de la app en la que el click se ha ejecutado Recomendamos añadir los identificadores únicos de los dispositivos para mejorar la asignación de las conversiones:! ! Nombre Descripción del Identificador ios_ifa El identificador de anunciante de Apple con iOS +6. El valor debe ser formado con letras mayúsculas y guiones [AAAAAAAAA-BBBBCCCC-1111-222222220000]. Si vas a usar el parámetro ios_ifa debes indicar si el usuario ha limitado el adtracking con el parámetro ios_ad_tracking_disabled, Más info. ios_ifa_md5 El identificador IFA de los dispositivos iOS encriptado con el algortimo MD5. El valor debe ser generado basándose en el valor original formado con letras mayúsculas y guiones [md5(AAAAAAAAA-BBBBCCCC-1111-222222220000)] ios_ifa_sha1 El identificador IFA de los dispositivos iOS encriptado con el algoritmo SHA1. El valor debe ser generado basándose en el valor original formado con letras mayúsculas y guiones [sha1(AAAAAAAAA-BBBBCCCC-1111-222222220000)] ios_ad_tracking_disabled Si vas a usar el parámetro ios_ifa debes indicar si el usuario ha limitado el adtracking con el parámetro ios_ad_tracking_disabled. android_id El identificador para dispositivos Android. El valor debe ser formado con letras minúsculas. Más info. android_id_md5 El identificador para dispositivos Android encriptado con el algoritmo MD5. El valor debe ser generado basándose en el valor original formado con letras minúsculas [md5(aaaaaaaa11111111)] android_id_sha1 El identificador para dispositivos Android encriptado con el algoritmo SHA1. El valor debe ser generado basándose en el valor original formado con letras minúsculas [sha1(aaaaaaaa11111111)] Échale un ojo al proceso completo para visualizar un ejemplo del flujo de comunicación:! ! 1. El afiliado nos pasa su pixel especificando los parámetros que añadirá:! http://tracking.com/mobile/postback/?at=appburn&postbackid={ADKCLICKID} ! 2. Se genera una url de tracking en AppBurn que notifique a dicho pixel:! ! http://eat.appburn.net/?antw=c62d9e9c826d00c9a58597558f117ad6 ! 3. El afiliado debe añadir, a través del click through, el parámetro axid con el valor del identificador custom que necesite que le sea devuelto:! http://eat.appburn.net/?antw=c62d9e9c826d00c9a58597558f117ad6&axid={ADKCLICKID} ! 4. Cuando se genere la conversión, AppBurn notificará al afiliado devolviendo el valor enviado en el parámetro axid así como añadiendo la siguiente información:! ! ! Nombre UDID Descripción del Parámetro Identificador único del dispositivo LATITUDE Coordenadas del dispositivo (si está habilitado en la app) LONGITUDE Coordenadas del dispositivo (si está habilitado en la app) CREATED_AT Fecha y hora en la que se realizó la instalación http://tracking.com/mobile/postback/? at=appburn&postbackid=67085243a740995bd9b5cd3c995f5143_2014-07-18_12%3A20%3A31_ 3_2&UDID=F00CD03706C097602BD87398EB2C6C4B&LATITUDE=41.394001&LONGITUDE=2.156697 &CREATED_AT=2014-01-27+12%3A22%3A20 ! ! !