Guía de integración Android SDK!

 
SEGUIR LEYENDO
Guía de integración Android 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 el fichero AppBurn.jar a tu classpath:!
!
Si estás usando Eclipse, modifica tu Java Build Path y escoge Add External
JAR.!
!
Si estás usando directamente las herramientas del SDK, añádelo en la
carpeta de tus librerías y el task ant lo recogerá.!
!!
!!      1.1.2 Añade el fichero gcm.jar a tu classpath:!
!
Si estás usando Eclipse, modifica tu Java Build Path y escoge Add External
JAR.!
!
Si estás usando directamente las herramientas del SDK, añádelo en la
carpeta de tus librerías y el task ant lo recogerá.!
!
Añade también la librería del servicio de GooglePlay. Aquí puedes obtener
toda la información.!
!
!!     1.1.3 Configura el AndroidManifest.xml!
!
!!     1.1.3.1 Añade los siguientes permisos:!
!
!!     -Permisos Obligatorios:!
!
android.permission.INTERNET!
android.permission.ACCESS_NETWORK_STATE!
android.permission.READ_PHONE_STATE!
!
!!     - Permisos Opcionales:!
!
android.permission.ACCESS_COARSE_LOCATION or!
android.permission.ACCESS_FINE_LOCATION!
!
!!     1.1.3.2 Añade el siguiente método para obtener el Android
Advertising ID:!
.!
                                       .!
           !
                                       .!
                                       .!

!
* Si tu app tiene permisos de localización, AppBurn podrá trackear la
  ubicación de su usuo. Para inhabilitarlo, aun cuando tu app tenga permisos,
  debes hacer una llamada a AppBurn.disableReportLocation() antes
  de AppBurn.startSession()!
!
!
!1.2 Integración Básica: !
!
!!    1.2.1 Importa la librería:!
!
!!     !        - Importa AppBurn en tu actividad:!

                 import com.appburn.android.AppBurn;

!
!
!!     !        - En el método onCreate() añade la siguiente llamada:!
!

            AppBurn.startSession(this,"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.!

!
!
!!     1.2.2 Activa el Android Install Referrer!
!
El Android Install Referrer es el identificador que permite una atribución exacta
con el tráfico generado y trackeado a través de AppBurn.!
!
Android lanzará una llamada com.android.vending.INSTALL_REFERRER
en el proceso de instalación de la app. Esta llamada se ejecuta antes de que
la app sea abierta por primera vez. Para capturar esta información relevante
añade el receptor AppBurnReferralReceiveir broadcast a tu
AndroidManifest.xml:!

                              .!
                              .!
                              .!
                             
Si estás usando tu propio receptor sigue estos pasos:!
!
1. Registra lo siguiente en tu receptor broadcast:!
!!     1.2.3 Debugging tu código!
!
Este paso es opcional. Si necesitas ver el log de Appburn, habilítalo (antes de !
startSession) con:!

                 AppBurn.setDebuggerOutput:(true);

!
!!     !
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(this, userId, 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(this, userId, 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:!

       startOrder(Context ctx, String orderId, String
                         customerId,!
     float totalPrice, String coupon, Map
                extras, String currencyCode);

!
Puedes enviarnos los siguientes parámetros:!
!
!!     !     - ctx: Context object (como la Actividad o el Servicio)!
!!     !     - orderId: String con el id de tu transacción.! !
!!     !     - customerId: String con el ID del comprador. Si no envías
este parámetro, AppBurn usará el ID del login (en el caso de que exista)!
!!     !     - totalPrice: Precio total de la transacción.!
!!     !     - coupon: String con el cupón canjeado si fuera necesario.!
!!     !     - extras: añade hasta 20 parámetros extra.!
!!     !     - currencyCode: String 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.jar.!
!
!
!!     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:!

        addProduct(String productId, String name, float
         qty, float price, Map extras);!

!
Puedes enviarnos los siguientes parámetros:!
!
!!     !      - PRODUCT_ID: NSString con el id del producto.!
!!     !
!!     !      - productId: String con el identificador del producto.!
!!     !      - name: String con el nombre del producto.!
!!     !      - qty: Etiqueta con la cantidad de producto.!
!!     !      - price: Etiqueta con el precio del producto.!
!!     !      - extras: Añade hasta 20 parámetros extra.!
!
!!     3.3 Confirmación de la transacción!
!
Añade trackOrder cuando se finalice la transacción. Recuerda que siempre
debes lanzar startOrder y addProduct antes:!

                       trackOrder(Context ctx);!

!
!!      3.4 Cancelación de la transacción!
 !
Si tu m-commerce permite cancelar transacciones puedes lanzar este método
para actualizar las transacciones recogidas en AppBurn:!

             cancelOrder(Context c, String orderId);!

!
!
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:!

              trackEvent(Context ctx, String event)
Genera el parámetro event accediendo a la sección My Account > Edit >
Events o envíanos un email a soporte@appburn.net 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             Contabiliza el número de aperturas de la app

              Login              Contabiliza el número de inicios de sesión

                                 Contabiliza el número de veces que se comparte
        Compartir en rr.ss
                                 contenido de la app en redes sociales

                                 Contabiliza el número de visitas en las distintas
        Visitas en sección
                                 secciones de la app

             Errores             Contabiliza el número de errores en la app

                                        Juegos

                                 Contabiliza el número de veces que se completa cada
      Niveles completados
                                 nivel

                                 Contabiliza el número de veces que se alcanza
           Puntuación
                                 diferentes puntuaciones

        Comenzar partida         Contabiliza el número de inicios de partida

                                    m-Commerce

        Buscar producto          Contabiliza el número de búsquedas de producto

                                 Contabiliza el número de búsquedas por categoría de
     Categoría de producto
                                 producto

                                 Contabiliza el número de veces que se añade un
    Producto añadido a carrito
                                 producto al carrito

                                        Social

          Invitar amigos         Contabiliza el número de invitaciones enviadas

                                 Contabiliza el número de posts publicados por los
    Generación de contenido
                                 usuarios

        Encontrar amigos         Contabiliza el número de búsquedas de amigos

                                        Media
Reproducciones        Contabiliza el número de reproducciones del contenido

                             Contabiliza el número de veces que se comparte el
     Compartir contenido
                             contenido

    Tiempo de reproducción   Contabiliza, por rangos, los tiempos de reproducción
!
!
!
!
!
!
!
!
!
También puede leer