Introdução

O seguinte documento descreve os passos necessários para a integração do Android SDK da e-planning. Este SDK permite publicar facilmente anúncios tradicionais, rich media MRAID compliance, intersticial e tag de terceiros provenientes de diversas fontes. O Android SDK da e-planning suporta as funções de segmentação para o delivery de anúncios do ad server da e-planning.

Implementação

A implementação de espaços de publicidade em app demanda três passos:
1. Criação de placements na ferramenta do ad server.
2. Criação de campanha e anúncios de teste.
3. Implementação do SDK no app.

1. CRIAÇÃO DE PLACEMENTS

É necessário registrar na plataforma e-planning adserver um site correspondente ao app, ao menos uma seção e um espaço para cada um dos placements (espaços de publicidade) que serão implementados dentro deste App.
Por exemplo, para implementar duas seções “Home” e “Internas”, cada seção com dois espaços de publicidade de 320x50 (superior e inferior) e um anúncio interstitial, deverão ser registrados 6 espaços (placements) diferentes na e-planning.

Para registrar o site, as seções e os espaços, deve-se acessar o adserver na aba Inventário.

Para o registro de site >> ir à opção adicionar Site

IMPORTANTE!

Ao criar o site, indicar que é um APP, as opções de SDK de outro modo não estão disponíveis:

Se o site já estivesse criado, editar e marcar a opção correta 'Tipo de Implementação' App

Para o registro de seção >> ir à opção adicionar Seção
Para o registro de espaços >> ir à opção adicionar Espaço

Para mais informações consulte os seguintes documentos em nossa Kbase

Criação de Sites
http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/917/0/criao-de-sites

Criação de Seções
http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/923/287/criao--registro-de-sees

Criação de Espaços
http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/597/287/criao-de-espaos

Uma vez registrados o site, as seções e os espaços, devem ser extraídos os IDs de plataforma e placement e fazer o download do pacote do SDK.

Para isto acesse a opção “Sites” dentro da aba “Inventário”, selecione o site correspondente a seu app e clique na opção “Mobile SDK”:

Neste local se encontram os links de download do e-planning Android SDK e o código do aplicativo de teste.

Nesta tela podem ser visualizados também os parâmetros a configurar dentro do SDK:

Parâmetros de Configuração:

1. Plataforma ID

O sistema indicará um código alfabético de duas letras: AR, US ou EU. Este código deve ser introduzido dentro do arquivo Settings.java, como indicado mais adiante.

2. Placements ID

O sistema identificará com um código alfanumérico diferente cada um dos espaços criados. Estes ids serão incluídos nas chamadas a espaços publicitários dentro do app, de acordo com as instruções indicadas neste documento.

2. CRIAÇÃO DE CAMPANHA E REGISTRO DE ANÚNCIOS DE TESTE.

Para facilitar o processo de implementação e teste sugerimos que sejam feitos os registros de uma campanha e anúncios de teste nos placements criados anteriormente. Lembre-se que devem ser implementados anúncios de tipo imagem (jpg, png ou gif).

Este procedimento deve ser realizado na plataforma da e-planning acessando a opção “Campanhas”, dentro da aba “Órdens”.

Para mais informações consulte os seguintes documentos em nossa Kbase

Registro de Campanhas
http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/925/103/formulrio-de-registro-de-campanhas

Registro de Anúncios
http://chat.e-planning.net/index.php?/Knowledgebase/Article/View/922/104/como-carregar-um-anncio-em-uma-campanha

3. IMPLEMENTAÇÃO DO SDK

Importação do SDK

Antes de iniciar os passos mais avançados da configuração do SDK, deve-se importar todo o conteúdo da mesma no workspace onde se encontra o app no qual deseja implementar o e-planning SDK.

Logo deve-se criar a referência entre projetos para que o App possa ter acesso aos objetos do SDK.

Configuração da Plataforma ID

No arquivo 'sdk/src/com/appnexus/opensdk/utils/Settings.java’ deve-se indicar o código obtido no passo anterior na variável BASE_URL ao final do string EPL_PLATAFORM_XX :

/**
* Here you have to change to other platform to get the required ad*******************************************
*/
privatefinalStringEPL_PLATFORM_US='us';
privatefinalStringEPL_PLATFORM_AR='';
privatefinalStringEPL_PLATFORM_EU='eu';
public/*final*/StringBASE_URL='http://ads.'+EPL_PLATFORM_US+'.e-planning.net/mob?&';

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

* Gist de Exemplo: https://gist.github.com/emaraschio/47f44cfd2be13ccf41fa

Implementação em Apps

Devem ser adicionadas as seguintes atividades e autorizações no Manifest do app:

<uses-permissionandroid:name='android.permission.WRITE_EXTERNAL_STORAGE'/>
<uses-permissionandroid:name='android.permission.ACCESS_NETWORK_STATE'/>
<uses-permissionandroid:name='android.permission.ACCESS_WIFI_STATE'/>
<uses-permissionandroid:name='android.permission.INTERNET'/>
<uses-permissionandroid:name='android.permission.ACCESS_FINE_LOCATION'/>
<uses-permissionandroid:name='android.permission.ACCESS_COARSE_LOCATION'/>
<uses-permissionandroid:name='android.permission.READ_PHONE_STATE'/>

<activityandroid:name='com.appnexus.opensdk.AdActivity'/>
<activityandroid:name='com.appnexus.opensdk.BrowserActivity'/>

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