REVISTA 114_MaquetaciÛn 1

Guía de integración iOS SDK!
!
1. Integración Básica Obligatoria!
!
Lee atentamente toda la sección Integración Básica, necesaria para poder
medir, al menos, las instalaciones de la app asociadas a tu tráfico trackeado
en AppBurn. !
!
!1.1 Añadiendo los ficheros a tu proyecto:!
!
!!
1.1.1 Añade las siguientes librerías al proyecto:!
!
!!
!!
!!
!!
!
!!
!
!
!
!
!
!
!
!
!
- AppBurn.h!
- libeAppBurn.a!
- libeAppBurn-Simulator.a (solo para test en simulador)!
- libeAppBurn-Universal.a (simulador + dispositivo real)!
1.1.2 Añade los siguientes frameworks al proyecto:!
!!
!
!
- MobileCoreServices.framework!
!!
!
!
- CFNetwork.framework!
!!
!
!
- CoreGraphics.framework!
!!
!
!
- SystemConfiguration.framework!
!!
!
!
- QuartzCore.framework!
!!
!
!
- Libz.dylib!
!!
!
!
- CoreLocation.framework (OPCIONAL si necesitas
trackear la localización)!
!!
!
!
- AdSupport.framework!
!!
!
!
- CoreTelephony.framework!
!
!
* Si tienes problemas con esta librería puede probar borrando todos los weaklinks en Other Linker Flags.!
!
** Framework opcional significa que es obligatorio añadir el framework pero
que puedes cambiar su estado a opcional en Build Phases > Link Binary with
Libraries > Status > Set to Optional.!
!
*** AppBurn no funciona en procesos en segundo plano. Debes hacer la
llamada a AppBurn en primer plano . Si fuera necesario, se puede utilizar el
método Obj-C performSelector - OnMainThread!
!
!
!
!
!1.2 Integración Básica: !
!
!!
!
1.2.1 En tu Application Delegate:!
!!
!
Delegate:!
- Importa AppBurn en la parte superior de tu archivo App
#import “AppBurn.h"
!
!
!!
!
- Añade lo siguiente dentro de
applicationdidFinishLaunchingWithOptions!
!
[AppBurn startSession:@"YOURSESSIONKEY"];!
Consigue tu Session Key en la sección My Account > Apps dando de alta tu
app o contáctanos directamente y te lo facilitaremos.!
!
Además, si fuera necesario, puedes reportar la localización del dispositivo con
[AppBurn trackLocation]!
!
!!
!
1.2.2 Debugging tu código!
Este paso es opcional. Si necesitas ver el log de Appburn, habilítalo (antes de !
startSession) con:!
[AppBurn setDebuggerOutput:TRUE]!
!
!!
!
1.2.3 Lanzando tu app en AppStore!
En 2014 Apple cambio su política de tracking. La nueva política afecta
directamente al uso del IDFA (identifier for advertisers). Apple ha determinado
que el uso de este identificador es únicamente válido bajo los siguientes
supuestos:!
!
!!
!!
!!
!!
!!
!!
!
!
!
!
!
!
!
- Frecuencia!
- Capping!
- Eventos de conversion!
- Estimación de usuarios únicos!
- Seguridad y detección de fraude!
- Debugging!
AppBurn cumple la política establecida por Apple ya que recoge el IDFA para
determinar los eventos de conversion y estimar los usuarios únicos de sus
campañas.!
!
Con el fin de cumplir todas las reglas establecidas por Apple y garantizar la
aprobación de tu app, debes de marcar las siguientes casillas en iTunes
Connect:!
¡IMPORTANTE!!
!
El tracking a través del IDFA está habilitado en AppBurn por defecto. En el
caso de querer inhabilitarlo, debes marcar igualmente las mismas casillas
especificadas anteriormente para cumplir con la política de Apple y añadir el
siguiente método:!
[AppBurn setUseIDFA:BOOL]!
!
BOOL define cuando AppBurn debe recoger el IDFA. Si se envía el valor NO,
será usado el VendorID. El IDFA puede ser habilitado/inhabilitado en futuras
actualizaciones de la app.!
!
2. Leads!
!
AppBurn te permite medir, además de las instalaciones, los leads que se
generan a través de las instalaciones atribuidas a las campañas trackeadas.
De esta manera podrás conocer los LTRs del tráfico conseguido y optimizar tu
presupuesto en base a este parámetro.!
!
Para ello, primero, lee atentamente y sigue las instrucciones de la sección
Integración Básica Obligatoria, siempre necesaria para comenzar a trabajar
con el SDK de AppBurn.!
!
Una vez hecho, implementa el siguiente método para medir los leads y
lánzalo cada vez que se genere un registro completo en tu app:!
[AppBurn registerUserID:USER_ID forMail:MAIL]
Si además quieres obtener los web users, es decir, usuarios que se loquean
en la app sin un registro previo, lanza el siguiente método cada vez que se
realize un login:!
[AppBurn loginUserID:USER_ID forMail:MAIL]
!
3. Transacciones!
!
AppBurn permite medir trackear todas las transacciones de tu app y asignarlas
a tus fuentes de tráfico según la atribución de la instalación. De esta forma
podrás conocer el ROI directo de tus campañas y optimizar tus inversiones.!
!
Para ello, primero, lee atentamente y sigue las instrucciones de la sección
Integración Básica Obligatoria, siempre necesaria para comenzar a trabajar
con el SDK de AppBurn.!
!
Una vez hecho define el proceso de compra implementando los siguientes
métodos en cada uno de los pasos necesarios para generar la transacción:!
!
!!
!
3.1 Comenzar la transacción!
Añade startOrder cuando se inicie el proceso de compra al añadir un
producto al carrito:!
[AppBurn startOrder:YOUR_ORDER_ID
customerId:CUSTOMER_ID totalPrice:TOTAL_PRICE
coupon:COUPON extras:EXTRAS
currencyCode:CURRENCY_CODE]
!
Puedes enviarnos los siguientes parámetros:!
!
!!
!
- YOUR_ORDER_ID: NSString con el id de tu transacción.!
!!
!
- CUSTOMER_ID: NSString con el ID del comprador. Si no
envías este parámetro, AppBurn usará el ID del login (en el caso de que
exista)!
!!
!
- TOTAL_PRICE: precio total de la transacción.!
!!
!
- COUPON: NSString con el cupón canjeado si fuera necesario.!
!!
!
- EXTRAS: NSDictionary con hasta 20 parámetros extra.!
!!
!
- CURRENCY_CODE: NSString con un código de divisa válido
(EUR,USD,..) Si el código de la divisa no es valido se mostrará con la divisa
EUR. !
!
* Si no necesitas usar todos los parámetros puedes encontrar métodos
abreviados en el AppBurn.h.!
!
!
!!
!
3.2 Añadir productos a la transacción!
Añade addProduct cuando se añadan nuevos productos a la misma
transacción. Recuerda que siempre debes lanzar startOrder antes:!
[AppBurn addProduct:PRODUCT_ID name:PRODUCT_NAME
qty:QUANTITY price:PRICE extras:YOUR_EXTRAS]
!
Puedes enviarnos los siguientes parámetros:!
!
!!
!!
!!
!!
!!
!
!
!
!
!
!
!!
3.3 Confirmación de la transacción!
!
!
- PRODUCT_ID: NSString con el id del producto.!
- NAME: NSString con el nombre del producto.!
- QTY: Etiqueta con la cantidad de producto.!
- PRICE: Etiqueta con el precio del producto.!
- EXTRAS: NSDictionary con hasta 20 parámetros extra.!
Añade trackOrder cuando se finalice la transacción. Recuerda que siempre
debes lanzar startOrder y addProduct antes:!
[AppBurn trackOrder]!
!
!
!!
3.4 Cancelación de la transacción!
[AppBurn cancelOrder:ORDER_ID]!
!
Si tu m-commerce permite cancelar transacciones puedes lanzar este método
para actualizar las transacciones recogidas en AppBurn:!
!
!
!
4. Eventos Custom!
!
Los eventos te dan la posibilidad de medir cualquier acción del usuario
customizable y específica de tu app de manera que puedas conocer en detalle
los movimientos de los usuarios y actividad de tu app una vez instalada en el
dispositivo. !
!
Para ello, primero, lee atentamente y sigue las instrucciones de la sección
Integración Básica Obligatoria, siempre necesaria para comenzar a trabajar
con el SDK de AppBurn.!
!
Una vez hecho, implementa el siguiente método para medir los eventos y
lánzalo cada vez que dicho evento se produzca:!
[AppBurn trackEvent:@"EVENT_TOKEN"];!
!
Genera el EVENT_TOKEN accediendo a la sección My Account > Edit > Events
o envíanos un email a [email protected] con el listado de eventos que
deseas medir y nosotros generaremos los tokens que necesitas.!
!
Verifica que los eventos que deseas medir están siempre generados en
nuestra herramienta ya que en todos los eventos no-existentes AppBurn
devolverá un error. !
!
AppBurn establece un máximo de 30 eventos custom.!
!
Échale un ojo a nuestra tabla de eventos custom según la tipología de la app
para obtener algunos ejemplos de eventos que podrías personalizar en tu
medición:!
!
!
!
Evento
Descripción
Genérica
Sessions
Login
Contabiliza el número de aperturas de la app
Contabiliza el número de inicios de sesión
Compartir en rr.ss
Contabiliza el número de veces que se comparte
contenido de la app en redes sociales
Visitas en sección
Contabiliza el número de visitas en las distintas
secciones de la app
Errores
Contabiliza el número de errores en la app
Juegos
Niveles completados
Puntuación
Comenzar partida
Contabiliza el número de veces que se completa cada
nivel
Contabiliza el número de veces que se alcanza
diferentes puntuaciones
Contabiliza el número de inicios de partida
m-Commerce
Buscar producto
Categoría de producto
Producto añadido a carrito
Contabiliza el número de búsquedas de producto
Contabiliza el número de búsquedas por categoría de
producto
Contabiliza el número de veces que se añade un
producto al carrito
Social
Invitar amigos
Generación de contenido
Encontrar amigos
Contabiliza el número de invitaciones enviadas
Contabiliza el número de posts publicados por los
usuarios
Contabiliza el número de búsquedas de amigos
Media
Reproducciones
Compartir contenido
!
Tiempo de reproducción
Contabiliza el número de reproducciones del contenido
Contabiliza el número de veces que se comparte el
contenido
Contabiliza, por rangos, los tiempos de reproducción
!
!
!
!
!
!
!
!