¡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

http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/138/208/formulario-de-alta-de-pautas

Alta de Anuncios

http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/344/213/cmo-cargar-un-anuncio-a-una-pauta

¡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?&';

//************************************************************************************************************

Recordar que en el caso de AR la url queda sin el AR: ads.e-planning.net

* 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'/>

*Gist con Manifest de Ejemplo: https://gist.github.com/emaraschio/0eda4aaf8a6869a94cc8

Browser not supported