[AD.AGIO] IOS SDK Pag. 1

Dimensione: px

Iniziare la visualizzazioe della pagina:

Download "[AD.AGIO] IOS SDK 2014.07. Pag. 1"

Lucio Villani
8 anni fa
Visualizzazioni

1 [AD.AGIO] IOS SDK Pag. 1

2 PREMESSA Il presente documento riporta informazioni riservate il cui utilizzo è confidenziale e permesso esclusivamente nell'ambito del rapporto di fornitura in atto. 1. INTRODUZIONE ADGLibrary è una SDK per la gestione degli ads erogati dalla piattaforma [ad.agio] di Neodata Group, finalizzata ad integrare nella maniera più semplice possibile la logica di gestione degli ads direttamente all interno delle applicazioni ios (Iphone/Ipad), in maniera trasparente per gli sviluppatori delle applicazioni. Il presente manuale intende illustrare le operazioni di setup del progetto e le operazioni necessarie all integrazione dei banner pubblicitari sulle applicazioni. 2. CONFIGURAZIONE SDK 3.1 SPECIFICHE LIBRERIA La presente documentazione è relativa alla versione: 2.3 (o superiori). Versione minima ios supportata: IMPORTAZIONE DELLA LIBRERIA NEL PROGETTO XCODE 1. Scompattare il file compresso fornito: - ADGLibrary.zip 2. All interno del progetto Xcode, recarsi sul TAB Build phases dalle proprietà del progetto. 3. Scegliere la voce Link binary with libraries e premere il tasto +. Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

agio] di Neodata Group, finalizzata ad integrare nella maniera più semplice possibile la logica di gestione degli ads direttamente all interno delle applicazioni ios (Iphone/Ipad), in maniera

4. Navigare sino a trovare il file di libreria libadglibrary.a precedentemente scompattato 5. Aggiungere i framework standard: a. CoreLocation.framework b. CoreTelephony.framework c.

3 4. Navigare sino a trovare il file di libreria libadglibrary.a precedentemente scompattato 5. Aggiungere i framework standard: a. CoreLocation.framework b. CoreTelephony.framework c. SystemConfiguration.framework d. CoreGraphics.framework e. AdSupport.framework 6. Aggiungere alle risorse della propria applicazione il file ADGLibrary.h fornito insieme al file binario della libreria. Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

framework d. CoreGraphics.framework e. AdSupport.framework 6.

4 3. UTILIZZO IN FASE DI SVILUPPO INTEGRAZIONE BANNER Per poter integrare all interno della propria UIView una finestra ADGView, è necessario procedere 4.1 dichiarando un oggetto ADGView nell interfaccia definita sul file header (.h), includendo la direttiva: - #import "ADGLibrary.h" L interfaccia estende ADGViewDelegate per la gestione dei delegati di notifica dello stato del banner (vedi par. 4.6). L oggetto adview definito, sarà istanziato e aggiunto alla UI sul file.m Il metodo di istanza -(id)initwithframe:gpsenabled: permette di inizializzare una finestra di dimensioni arbitrarie, specificando se includere (quando disponibili) informazioni di geolocalizzazione nella richiesta al server [ad.agio]. Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

h" L interfaccia estende ADGViewDelegate per la gestione dei delegati di notifica dello stato del banner (vedi par. 4.6). L oggetto adview definito, sarà istanziato e aggiunto alla UI sul file.

5 Le dimensioni specificate in fase di creazione, sono le effettive dimensioni comunicate all adserver. Per poter effettuare una corretta richiesta al server [ad.agio] è necessario impostare con alcuni parametri come properties di ADGView attraverso i seguenti metodi: [adview setpositionid:@ NEODATA_POSITION_ID ]; [adview setclientid:neodata_client_id]; [adview setkeywords:@"some keywords"]; //opzionale I parametri: NEODATA_POSITION_ID e NEODATA_CLIENT_ID saranno comunicati off band da Neodata al cliente. Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

agio] è necessario impostare con alcuni parametri come properties di ADGView attraverso i seguenti metodi: [adview setpositionid:@ NEODATA_POSITION_ID

6 BANNER INTERSTITIAL ED ESPANDIBILI E possibile gestire banner di tipo interstitial ed espandibili. Il banner di tipo interstitial è un particolare tipo di ad che si avvia direttamente a tutto 4.2 schermo su una finestra modale provvista di tasto Chiudi. Per consentire l erogazione del formato interstitial è necessario istruire una ADGView in maniera adeguata durante la sua inizializzazione. Il banner espandibile è un particolare tipo di banner che viene visualizzato inizialmente a dimensioni ridotte, per poi espandersi al click dell utente. L espansione consiste nell apertura di una finestra modale sull app, opportunamente provvista di un bottone per la chiusura. Alla pressione sul tasto di chiusura il banner ritorna di dimensioni ridotte. La gestione dell espansione del banner è totalmente a carico della SDK e non richiede accorgimenti implementativi da parte dello sviluppatore. 4.3 REFRESH DEL BANNER E possibile impostare un valore di refresh per consentire l aggiornamento automatico del banner da visualizzare, attraverso il seguente metodo: Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

Il banner espandibile è un particolare tipo di banner che viene visualizzato inizialmente a dimensioni ridotte, per poi espandersi al click dell utente.

7 Il valore impostato indica il numero di secondi. Impostando il valore zero (0) l oggetto ADGView non sarà mai aggiornato. COMPORTAMENTO DEL BANNER E possibile assegnare ad ogni banner un comportamento, impostando il numero di secondi 4.4 in cui mostrare/nascondere il banner e numero di cicli di visualizzazione. Il setting di tali parametri avviene su [ad.agio], in fase di caricamento del banner. E possibile comunque inibire il comportamento dei banner da SDK usando il seguente metodo: 4.5 MINIBROWSER MODALE Per evitare di perdere il focus della propria applicazione, la SDK incorpora un sistema di navigazione interna dei banner su finestra modale. Per utilizzarlo è necessario, in fase di inizializzazione del banner, valorizzare la seguente proprietà come segue: 4.6 GESTIONE DELEGATI La SDK incorpora un meccanismo per notificare le proprie attività ed il proprio stato alla classe delegata che implementa il protocollo ADGViewDelegate. Di seguito una lista dei metodi attualmente implementati con relativa descrizione. Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

Il setting di tali parametri avviene su [ad.agio], in fase di caricamento del banner. E possibile comunque inibire il comportamento dei banner da SDK usando il seguente metodo: 4.

4.7 VIDEO Al fine di consentire la visualizzazione dei video inline e autoplay, è necessario impostare sull adview le seguenti due properties: adview.

8 4.7 VIDEO Al fine di consentire la visualizzazione dei video inline e autoplay, è necessario impostare sull adview le seguenti due properties: adview.mediaplaybackrequiresuseraction=false; adview.allowsinlinemediaplayback=true; Neodata Group srl Viale Vittorio Veneto 42 - Catania T / 8

mediaplaybackrequiresuseraction=false; adview.

Documenti analoghi

[AD.AGIO] ANDROID SDK

[AD.AGIO] ANDROID SDK 2013.06 Pag. 1 1. PREMESSA Il presente documento riporta informazioni riservate il cui utilizzo è confidenziale e permesso esclusivamente nell'ambito del rapporto di fornitura in