SDK IOS - Implementação

Introdução

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


Implementação

A implementação de espaços de publicidade em app demanda três passos:
1. Criação de placements na ferramenta de 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.

Open

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 Open

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

Open

Neste local se encontram os links de download do e-planning iOS SDK e o código do aplicativo de teste. Nesta tela podem ser visualizados também os parâmetros a configurar dentro do SDK.

Open

Parâmetro de Configuração:

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.
Devem ser adicionados os seguintes frameworks pois são necessários para o funcionamento do SDK.

• AdSupport.framework

• AudioToolbox.framework

• AVFoundation.framework

• CFNetwork.framework

• CoreGraphics.framework

• CoreTelephony.framework

• EventKit.framework

• Foundation.framework

• iAd.framework

• MediaPlayer.framework

• MessageUI.framework

• MobileCoreServices.framework

• PassKit.framework

• QuartzCore.framework

• Security.framework

• Social.framework

• StoreKit.framework

• SystemConfiguration.framework

• UIKit.framework

Finalmente, em XCode, dentro da aba Build Settings, seleccione All e acesse a seção “Linking”. Clicando duas vezes na opção ”Other Linking Flags” adicione '-ObjC' sem aspas.