SDK Android - Implementação

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



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

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”.

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 :



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



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