Configurazione per editori di app: SDK pubblicitari e di analisi per regione

Questa guida è pensata per gli editori di app mobili. Configura l'SDK di UniConsent per app con gli SDK di pubblicità, analisi e attribuzione usati dalla maggior parte delle app, in modo che ogni SDK riceva il segnale di consenso di cui ha bisogno in Europa e nelle altre regioni dei tuoi utenti.

Tempo necessario: circa 1-2 ore: circa 10 minuti per il passaggio 1, da 20 a 30 minuti per aggiungere l'SDK nel passaggio 2, da 5 a 15 minuti per ogni SDK del passaggio 4 e circa 30 minuti per i test e le verifiche dei passaggi 6 e 7. Le modifiche pubblicate nella dashboard arrivano nell'app la volta successiva che carica la schermata del consenso.

Chi fa cosa: i passaggi 1 e 3 si svolgono nella dashboard di UniConsent. I passaggi 2, 4 e 5 modificano il codice dell'app, quindi se ne occuperà il tuo sviluppatore. I passaggi 6 e 7 si svolgono su un dispositivo di test.

Passaggio 1: crea il progetto della tua app

Nella dashboard, crea un progetto per app e copia il suo App ID. Il progetto per app usa IAB TCF in Europa: Google richiede una CMP certificata da Google che usi IAB TCF per gli annunci pubblicati nel SEE, nel Regno Unito e in Svizzera, e UniConsent è una CMP certificata da Google, livello Gold.

Poi attiva le policy per le altre regioni: CCPA e US State Privacy per gli Stati Uniti, e IAB TCF Canada per il Canada. Attiva anche IAB GPP, così gli SDK pubblicitari ricevono le scelte di Stati Uniti e Canada.

Passaggio 2: aggiungi l'SDK di UniConsent

Aggiungi l'SDK di UniConsent per la tua piattaforma: Android, iOS, Flutter, React Native. Avvialo con il tuo App ID all'apertura dell'app, prima degli SDK di pubblicità e analisi, e lascia che mostri la schermata del consenso quando serve. Ogni guida dell'SDK spiega come.

Passaggio 3: cosa riceve ogni regione

L'Europa comprende l'Unione europea, Norvegia, Islanda e Liechtenstein, il Regno Unito, la Svizzera, e inoltre Albania, Andorra, Bielorussia, Bosnia ed Erzegovina, Kosovo, Moldavia, Monaco, Montenegro, Macedonia del Nord, San Marino, Serbia e Ucraina.

Nel Regno Unito, il GDPR del Regno Unito e le linee guida dell'ICO richiedono il consenso prima di archiviazione e tracciamento non essenziali, nelle app come sui siti web, quindi mantieni il Regno Unito nella tua regione Europa.

Se disattivi la policy di una regione, gli utenti di quella regione vengono trattati come se non fosse installata alcuna CMP: non compare alcuna schermata del consenso e nessun SDK viene trattenuto.

Negli Stati Uniti, la California è coperta da CCPA / CPRA, e Virginia, Colorado, Utah, Connecticut, Florida, Montana, Oregon, Texas, Delaware, Iowa, Nebraska, New Hampshire, New Jersey, Tennessee, Minnesota, Maryland, Indiana, Kentucky e Rhode Island da US State Privacy. Gli utenti possono opporsi alla vendita e alla condivisione dei propri dati e alla pubblicità mirata, e la scelta viene trasmessa agli SDK pubblicitari in IAB GPP e, per la California, nella stringa US Privacy. Vedi Configurazione di US State Privacy.

Passaggio 4: integra i tuoi SDK

Gli SDK pubblicitari e Firebase leggono da soli la scelta dell'utente, dalle chiavi IAB standard che l'SDK di UniConsent salva sul dispositivo, quindi non devi trattenerli tu. Inizia a richiedere annunci quando la scelta dell'utente è nota.

Passaggio 5: aggiungi le impostazioni della privacy alla tua app

Gli utenti devono poter cambiare la propria scelta in qualsiasi momento, e gli utenti degli Stati Uniti esercitano qui l'opt-out. Aggiungi una voce Impostazioni privacy alla schermata delle impostazioni dell'app che apra la schermata di UniConsent. La guida della tua piattaforma spiega come aprire una schermata specifica, ad esempio le impostazioni: Android, iOS, Flutter, React Native.

Passaggio 6: prova ogni regione

Imposta una regione di test nell'app per vedere le schermate di un'altra regione, poi ripeti con CA (Canada), CAQC (Québec), USCA (California), USTX (Texas) e N (fuori da queste regioni):

// for testing only: remove it in release builds
UniConsent.getInstance().setTestRegion("EU");

Le app demo di UniConsent hanno un selettore della regione di test. Rimuovi la regione di test prima di pubblicare l'app.

Passaggio 7: verifica che i tuoi SDK seguano la scelta

Esegui ogni verifica su una nuova installazione, o dopo aver cancellato i dati dell'app, così le scelte precedenti non vengono mantenute.

Verifica in Europa

1. Con la regione di test EU, apri l'app. La schermata del consenso compare al primo avvio e gli annunci si caricano solo dopo la scelta.
2. Accetta tutto. Chiudi e riapri l'app: la schermata del consenso non ricompare e gli annunci si caricano.
3. Su una nuova installazione, rifiuta tutto. Gli annunci si caricano come annunci non personalizzati o limitati, se i tuoi partner pubblicitari li supportano.
4. Apri le Impostazioni privacy dell'app, cambia la scelta e verifica che venga mantenuta dopo aver riaperto l'app.

Verifica negli Stati Uniti

1. Con la regione di test USCA, apri l'app. Non compare alcuna schermata del consenso e gli annunci si caricano.
2. Apri le Impostazioni privacy, esercita l'opt-out e riapri l'app: l'opt-out viene mantenuto.

Per il tuo sviluppatore

L'SDK di UniConsent salva la scelta nell'archiviazione standard dell'app (SharedPreferences su Android, NSUserDefaults su iOS), dove la leggono gli SDK pubblicitari. Il tuo sviluppatore può controllare queste chiavi, o leggerle con i metodi dell'SDK, ad esempio getGPPString() e getUSPrivacyString():

IABTCF_TCString        IAB TCF choice (Europe)
IABGPP_HDR_GppString   IAB GPP string (US and Canada)
IABUSPrivacy_String    US Privacy string (California)

Errori comuni

• Aggiungere la CMP senza integrare i tuoi SDK. La schermata del consenso compare, ma gli SDK di pubblicità, analisi o attribuzione che si avviano prima che la scelta sia nota, o che hai impostato sul consenso nelle loro impostazioni, la ignorano. Integra ogni SDK come nel passaggio 4 e verificalo con il passaggio 7.
• Non controllare i report dei fornitori dopo la pubblicazione. Qualche giorno dopo la pubblicazione, apri i report dei tuoi SDK, ad esempio AdMob o Ad Manager, la tua piattaforma di mediazione, Firebase e il tuo partner di attribuzione, e confrontali con i giorni precedenti. È normale un calo proporzionale alla quota di utenti che rifiutano. Un calo molto maggiore, o dati che si interrompono, di solito significa che un SDK è trattenuto del tutto o non riceve il segnale di consenso.

Hai ancora domande?

Contattaci: support@uniconsent.com