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.

 

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

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.