Ai sensi del Consenso degli utenti dell'UE di Google Norme, devi mostrare determinate informative agli utenti nello Spazio economico europeo (SEE) con il Regno Unito e ottenere il loro consenso all'utilizzo dei cookie o di altri tipi di archiviazione locale; laddove richiesto dalla legge e di utilizzare dati personali (ad esempio l'ID pubblicità) per pubblicare annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e delle Regolamento generale sulla protezione dei dati (GDPR).
Per supportare i publisher nell'adempimento degli obblighi previsti da queste norme, Google offre l'SDK User Messaging Platform (UMP). L'SDK UMP è stato aggiornato per supportare i più recenti standard IAB. Tutte queste configurazioni ora possono essere gestiti in AdMob Privacy e i messaggi.
Prerequisiti
- Completa la Guida introduttiva
- Se stai lavorando ai requisiti relativi al GDPR, leggi In che modo i requisiti IAB influiscono sull'UE messaggi per il consenso
Crea un tipo di messaggio
Crea messaggi per gli utenti con uno tipi di messaggi per gli utenti disponibili nel menu a discesa Privacy e nella scheda Messaggistica di AdMob . L'SDK UMP tenta di visualizzare messaggio utente creato dall' AdMob ID applicazione nel progetto. Se non viene configurato alcun messaggio per la tua applicazione, l'SDK restituisce un errore.
Per ulteriori dettagli, vedi Informazioni su privacy e messaggi.
Aggiungi l'ID applicazione
Puoi trovare il tuo ID applicazione nel UI di AdMob. Aggiungi l'ID al tuo con il seguente snippet di codice:
Richiesta di informazioni sul consenso
Devi richiedere un aggiornamento delle informazioni sul consenso dell'utente in ogni app
avvia utilizzando requestConsentInfoUpdate()
. Ciò determina
se l'utente deve fornire il consenso, se non l'ha già fatto, oppure
se il consenso è scaduto.
Ecco un esempio di come controllare lo stato all'avvio dell'app:
@override
void initState() {
super.initState();
// Create a ConsentRequestParameters object.
final params = ConsentRequestParameters();
// Request an update for the consent information.
ConsentInformation.instance.requestConsentInfoUpdate(
params,
() async {
// TODO: Load and present the consent form.
},
(FormError error) {
// Handle the error.
},
);
}
Carica e mostra un modulo di consenso, se necessario
Dopo aver ricevuto lo stato del consenso più aggiornato, chiama
loadAndShowConsentFormIfRequired()
il
ConsentForm
per caricare un modulo di consenso. Se
lo stato del consenso è obbligatorio, l'SDK carica un modulo e lo presenta immediatamente
dal fornito. callback
viene richiamato dopo la chiusura del modulo. Se il consenso non è richiesto, il callback
viene chiamato immediatamente.
@override
void initState() {
super.initState();
// Create a ConsentRequestParameters object.
final params = ConsentRequestParameters();
// Request an update for the consent information.
ConsentInformation.instance.requestConsentInfoUpdate(
params,
() async {
ConsentForm.loadAndShowConsentFormIfRequired((loadAndShowError) {
if (loadAndShowError != null) {
// Consent gathering failed.
}
// Consent has been gathered.
});
},
(FormError error) {
// Handle the error.
},
);
}
Se devi eseguire azioni dopo che l'utente ha effettuato una scelta o lo ha ignorato del modulo, inserisci questa logica nel callback per il modulo.
Richiedi annunci
Prima di richiedere annunci nella tua app, verifica di aver ottenuto il consenso
dall'utente utilizzando canRequestAds()
. Esistono due metodi
luoghi da controllare durante la raccolta del consenso:
- Una volta raccolto il consenso nella sessione corrente.
- Subito dopo aver chiamato
requestConsentInfoUpdate()
. È possibile che il consenso sia stato ottenuto nella sessione precedente. Come latenza best practice, ti consigliamo di non attendere il completamento della richiamata per poter iniziare a caricare gli annunci il prima possibile dopo l'avvio dell'app.
Se si verifica un errore durante la procedura di raccolta del consenso, devi comunque tentare di richiedere annunci. L'SDK UMP utilizza lo stato del consenso della precedente durante la sessione.
class AppExampleState extends State<AppExample> {
// Use a bool to initialize the Mobile Ads SDK and load ads once.
var _isMobileAdsInitializeCalled = false;
@override
void initState() {
super.initState();
// Create a ConsentRequestParameters object.
final params = ConsentRequestParameters();
// Request an update for the consent information.
ConsentInformation.instance.requestConsentInfoUpdate(
params,
() async {
ConsentForm.loadAndShowConsentFormIfRequired((loadAndShowError) {
if (loadAndShowError != null) {
// Consent gathering failed.
}
// Consent has been gathered.
_initializeMobileAdsSDK();
});
},
(FormError error) {
// Handle the error.
},
);
// Check if you can initialize the Mobile Ads SDK in parallel while
// checking for new consent information. Consent obtained in the
// previous session can be used to request ads.
_initializeMobileAdsSDK();
}
void _initializeMobileAdsSDK() async {
if (_isMobileAdsInitializeCalled) {
return;
}
// Initialize the Mobile Ads SDK if the SDK has gathered consent aligned with
// the app's configured messages.
var canRequestAds = await ConsentInformation.instance.canRequestAds();
if (canRequestAds) {
setState(() {
_isMobileAdsInitializeCalled = true;
});
// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();
// TODO: Request an ad.
}
}
}
Opzioni di privacy
Alcuni moduli di consenso richiedono all'utente di modificare il proprio consenso in qualsiasi momento. Adegua i seguenti passaggi per implementare un pulsante delle opzioni per la privacy, se necessario.
A questo scopo:
- Implementare un elemento UI, ad esempio un pulsante nella pagina delle impostazioni dell'app, che possono attivare un modulo per le opzioni sulla privacy.
- Una volta
loadAndShowConsentFormIfRequired()
completato, controllagetPrivacyOptionsRequirementStatus()
per stabilire se visualizzare o meno l'elemento UI che può presentare il modulo delle opzioni di privacy. - Quando un utente interagisce con l'elemento UI, richiama
showPrivacyOptionsForm()
per mostrare il modulo in modo che l'utente possa aggiornare le opzioni relative alla privacy in qualsiasi momento.
class AppExampleState extends State<AppExample> {
static const _privacySettingsText = 'Privacy Settings';
// Use a bool to initialize the Mobile Ads SDK and load ads once.
var _isMobileAdsInitializeCalled = false;
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'App Example',
home: Scaffold(
appBar: AppBar(
title: const Text('App Example'),
actions: _isMobileAdsSDKInitialized
// Regenerate the options menu to include a privacy setting.
? _privacySettingsAppBarAction()
: null
),
body: // ...
),
);
}
List<Widget> _privacySettingsAppBarAction() {
return <Widget>[
FutureBuilder(
future: ConsentInformation.instance.isPrivacyOptionsRequired(),
builder: (context, snapshot) {
final bool visibility = snapshot.data ?? false;
return Visibility(
visible: visibility,
child: PopupMenuButton<String>(
onSelected: (String result) {
if (result == _privacySettingsText) {
ConsentForm.showPrivacyOptionsForm((formError) {
if (formError != null) {
debugPrint(
"${formError.errorCode}: ${formError.message}");
}
});
}
},
itemBuilder: (BuildContext context) =>
<PopupMenuEntry<String>>[
const PopupMenuItem<String>(
value: _privacySettingsText,
child: Text(_privacySettingsText))
],
));
})
];
}
}
Test
Se vuoi testare l'integrazione nella tua app durante lo sviluppo, segui questi passaggi per registrare il dispositivo di test in modo programmatico. Assicurati di rimuovere codice che imposta questi ID dispositivo di test prima di rilasciare l'app.
- Chiama il numero
requestConsentInfoUpdate()
. Controlla nell'output del log un messaggio simile all'esempio seguente, che mostra l'ID dispositivo e come aggiungerlo come dispositivo di test:
Android
Use new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231") to set this as a debug device.
iOS
<UMP SDK>To enable debug mode for this device, set: UMPDebugSettings.testDeviceIdentifiers = @[2077ef9a63d2b398840261c8221a0c9b]
Copia l'ID del dispositivo di test negli appunti.
Modifica il codice per chiamare
ConsentDebugSettings.testIdentifiers
e passiamo un elenco degli ID dispositivo di test.ConsentDebugSettings debugSettings = ConsentDebugSettings( testIdentifiers: ["TEST-DEVICE-HASHED-ID"], ); ConsentRequestParameters params = ConsentRequestParameters(consentDebugSettings: debugSettings); ConsentInformation.instance.requestConsentInfoUpdate(params, () async { // ... };
Forzare un'area geografica
L'SDK UMP consente di testare il comportamento della tua app come se il dispositivo fosse
che si trovano nel SEE o nel Regno Unito utilizzando the DebugGeography
field on ConsentDebugSettings
. Tieni presente che
le impostazioni di debug funzionano solo sui dispositivi di test.
ConsentDebugSettings debugSettings = ConsentDebugSettings(
debugGeography: DebugGeography.debugGeographyEea,
testIdentifiers: ["TEST-DEVICE-HASHED-ID"],
);
ConsentRequestParameters params =
ConsentRequestParameters(consentDebugSettings: debugSettings);
ConsentInformation.instance.requestConsentInfoUpdate(params, () async {
// ...
};
Reimposta stato del consenso
Durante il test della tua app con l'SDK UMP, potrebbe essere utile reimpostare il
lo stato desiderato dell'SDK per simulare l'esperienza di prima installazione di un utente.
L'SDK fornisce il reset()
metodo per farlo.
ConsentInformation.instance.reset();