SDK iOS - Implementación
- Sebastian Perez (Unlicensed)
| ¡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 iOS SDK de e-planning. Usando dicho SDK podrá servir facilmente anuncios tradicionales, rich media MRAID compliance, intersticiales y tag de terceros provenientes de diversas fuentes. El iOS 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 anucios de prueba.
- Implementación del SDK en la app.
1. CREACIÓN DE PLACEMENTS
En la plataforma de e-planning adserver 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 adserver 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 los placement IDs y descargar el paquete del SDK.
Para ello ingrese 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 iOS SDK, y el código de la aplicación de prueba. En dicha pantalla podrá visualizar también los parámetros a configurar dentro del SDK.
Parámetro de Configuración:
El sistema identificará con un codigo alfanumérico diferente cada uno de los espacios creados. Dichos ids se incluirán en las llamadas a espacios publicitarios dentro de la app, de acuerdo a las intrucciones indicadas en este documento.
2. CREACIÓN 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 Mobile
Dicho proceso se realiza en la plataforma de e-planning ingresando en la opción Pautas dentro de la solapa Órdenes.
| Para más información consulto los siguientes documentos en nuestra Kbase: Alta de Pautas
Alta de Anuncios |
| ¡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 o más requests son de la misma página. |
3. IMPLEMENTACIÓN DEL SDK
Importación del SDK
Antes de comenzar con los pasos mas avanzados de la configuración del SDK, se debe importar todo el contenido de la misma en el proyecto donde se encuentra la app en la cuál que desea implementar e-planning SDK. Agregue la carpeta “sdk” al mismo.Se deben agregar los siguientes frameworks ya que son requeridos para el funcionamiento del SDK.
- AdSupport.framework
- AudioToolbox.framework
- AVFoundation.framework
- CFNetwork.framework
- CoreGraphics.framework
- CoreTelephony.framework
- EventKit.framework
- Foundation.framework
- iAd.framework
- MediaPlayer.framework
- MessageUI.framework
- MillennialMedia.framework
- MobileCoreServices.framework
- PassKit.framework
- QuartzCore.framework
- Security.framework
- Social.framework
- StoreKit.framework
- SystemConfiguration.framework
- UIKit.framework
Finalmente en XCode, dentro del la solapa Build Settings seleccione All e ingrese a la sección “Linking”. Haciendo doble click en la opción ”Other Linking Flags” agregue '-ObjC' sin comillas.