SDK Android - Implementación
- Sebastian Perez (Unlicensed)
| ¡IMPORTANTE! Para poder hacer uso de los códigos SDK la cuenta debe tener activo el servicio de Rich Media. En caso de no tenerlo y requerir asistencia contacte a su Ejecutivo de Cuentas o directamente al equipo Comercial. |
Introducción
El siguiente documento describe los pasos requeridos para la integración del Android SDK de e-planning. Usando dicho SDK podrá servir fácilmente anuncios tradicionales, rich media MRAID compliance, intersticiales y tag de terceros provenientes de diversas fuentes. El Android SDK de e-planning soporta las funcionalidades de segmentación provistas para el delivery de anuncios de e-planning ad server.
Implementación
La implementación de espacios de publicidad en app requiere de tres pasos:
- Creación de placements en la herramienta de ad server.
- Creación de pauta y anuncios de prueba.
- Implementación del SDK en la app.
1. CREACIÓN DE PLACEMENTS
En la plataforma de e-planning ad server es necesario dar de alta un sitio correspondiente a la app, al menos una sección y un espacio por cada uno de los placements (espacios de publicidad) que se quieren implementar dentro de dicha app.
Por ejemplo, si se quieren implementar dos secciones “Home” e “Internas”, cada sección con dos espacios de publicidad de 320x50 (superior e inferior) y un anuncio interstitial, se deberán dar de alta 6 espacios (placements) diferentes en e-planning.
Para dar de alta el sitio, las secciones y los espacios, se debe ingresar en el ad server en la solapa Inventario.
Para el alta de sitio >> ir a la opción agregar Sitio
| IMPORTANTE! Al crear el sitio, señalar que es una Aplicación, de lo contrario las opciones propias para SDK no estarán disponibles:
En caso de que el sitio ya este creado, editarlo y marcar la opción correcta de 'Tipo de Implementación': Aplicación
|
Para el alta de sección >> ir a la opción agregar Sección
Para el alta de espacios >> ir a la opción agregar Espacio
| Para más información consulte los siguientes documentos en nuestra Kbase
Creación y Alta de Sitios http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/549/245/creacin--alta-de-sitios
Creación y Alta de Secciones http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/27/247/creacin--alta-de-secciones
Creación y Alta de Espacios http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/29/246/creacin--alta-de-espacios |
Una vez dados de alta el sitio, secciones y espacios se deberá extraer la plataforma y placement IDs y descargar el paquete del SDK.
Para ello ingrese a a la opción Sitios dentro de la solapa “Inventario”, seleccione el Sitio correspondiente a su App y haga click en la opción “Mobile SDK”:
Allí encontrará los links de descarga de e-planning Android SDK, y el código de la aplicación de prueba. En dicha pantalla podrá visualizar también los parámetros a configurar dentro de la SDK.
Parámetros de Configuración:
- Plataforma ID.
El sistema indicará un código alfabético de dos letras: AR, US o EU. Dicho código se debe introducir dentro del archivo Settings.java, como se indica más adelante.
- Placements ID
El sistema identificará con un código alfanumérico diferente cada uno de los espacios creados. Dichos ids se incluirán en las llamadas a espacios publicitarios dentro del app, de acuerdo a las instrucciones indicadas en este documento.
2. CREACION DE PAUTA Y ALTA DE ANUNCIOS DE PRUEBA.
Para facilitar el proceso de implementación y prueba se sugiere el alta de una pauta y anuncios de prueba en los placements creados anteriormente.
Se pueden implementar anuncios de tipo: Imagen (jpg, png o gif) / Anuncios de Ad Studio
Dicho proceso se realiza en la plataforma de e-planning ingresando en la opción “Pautas” dentro de la solapa “Ordenes”.
| Para más información consulto los siguientes documentos en nuestra Kbase Alta de Pautas Alta de Anuncios |
| ¡IMPORTANTE! Este tipo de implementación con SDK tiene limitaciones funcionales cuya lógica está relacionada al conjunto de espacios pertenecientes a una sección : Competencia entre pautas y anuncios en Espacios Gemelos. Está preparado para hacer un request por espacio, y no se puede relacionar que dos requests son de la misma página. |
3. IMPLEMENTACIÓN DEL SDK
Importación del SDK
Antes de comenzar con los pasos más avanzados de la configuración del SDK, se debe importar todo el contenido de la misma en el workspace donde se encuentra la app en la cual que desea implementar e-planning SDK.
Luego se deberá crear la referencia entre proyectos para que la app pueda tener acceso a los objetos del SDK.
Configuración de la Plataforma ID
En el archivo 'sdk/src/com/appnexus/opensdk/utils/Settings.java' deberá indicar el código obtenido en el paso anterior en la variable BASE_URL al final del string EPL_PLATAFORM_XX :
| /** * Here you have to change to other platform to get the required ad******************************************* */ private final String EPL_PLATFORM_US = 'us'; private final String EPL_PLATFORM_AR = ''; private final String EPL_PLATFORM_EU = 'eu'; public /*final*/ String BASE_URL = 'http://ads.' + EPL_PLATFORM_US + '.e-planning.net/mob?&'; //************************************************************************************************************ |
* Gist de Ejemplo: https://gist.github.com/emaraschio/47f44cfd2be13ccf41fa
Implementación en apps
Se deben agregar las siguientes actividades y permisos en el Manifest de la app:
| <uses-permission android:name='android.permission.WRITE_EXTERNAL_STORAGE'/> <uses-permission android:name='android.permission.ACCESS_NETWORK_STATE'/> <uses-permission android:name='android.permission.ACCESS_WIFI_STATE'/> <uses-permission android:name='android.permission.INTERNET'/> <uses-permission android:name='android.permission.ACCESS_FINE_LOCATION'/> <uses-permission android:name='android.permission.ACCESS_COARSE_LOCATION'/> <uses-permission android:name='android.permission.READ_PHONE_STATE'/>
<activity android:name='com.appnexus.opensdk.AdActivity'/> <activity android:name='com.appnexus.opensdk.BrowserActivity'/> |
*Gist con Manifest de Ejemplo: https://gist.github.com/emaraschio/0eda4aaf8a6869a94cc8