Guía de Integración AppBurn

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 soporte@appburn.net 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 soporte@appburn.net 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
!
!
!