In questa pagina viene descritto il metodo setConsent di Server SDK. Per il Web SDK, vedere setConsent.
Il metodo setConsent indica al Server SDK se può inviare dati per un visitatore (consenso) o se deve eliminarli (rinuncia). SDK invia le preferenze del visitatore ad Edge Network, quindi memorizza il risultato nel cookie kndctr_<orgId>_consent tramite il servizio cookie che passi a forRequest.
SDK supporta i seguenti standard di consenso:
- Adobe standard: versioni 1.0 e 2.0.
- IAB Transparency & Consent Framework (TCF): versione 2.0.
Questo metodo è disponibile solo quando l’istanza include il componente Consent, che createInstance include per impostazione predefinita.
Chiamare setConsent per un visitatore call
Il consenso appartiene a un singolo visitatore, pertanto chiama sempre setConsent sull’handle forRequest del visitatore, mai sull’istanza di livello superiore. L’esempio seguente utilizza lo standard Adobe 2.0:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: { val: "y" }
}
}]
});
L’esempio seguente utilizza lo standard Adobe 1.0:
await visitor.setConsent({
consent: [{
standard: "Adobe",
version: "1.0",
value: { general: "in" }
}]
});
L’esempio seguente utilizza lo standard IAB TCF 2.0:
await visitor.setConsent({
consent: [{
standard: "IAB TCF",
version: "2.0",
value: "CO052l-O052l-DGAMBFRACBgAIBAAAAAAIYgEawAQEagAAAA",
gdprApplies: true
}]
});
Se utilizzi lo standard IAB TCF e desideri i dati sul consenso sul profilo del visitatore, includi le informazioni sul consenso IAB anche nell’oggetto evento xdm. SDK non lo aggiunge automaticamente agli eventi.
Come viene memorizzato il consenso stored-consent
SDK legge e scrive il cookie di consenso tramite il servizio cookie che passi a forRequest:
- Se il servizio dei cookie legge i cookie del browser del visitatore, accetta che il visitatore abbia già effettuato la registrazione in precedenza, sul server o nel browser con il Web SDK. Non è necessario chiamare di nuovo
setConsentfinché le preferenze del visitatore non cambiano. - Se non passi un servizio cookie, SDK non può ricordare il consenso tra le richieste. Ogni richiesta inizia da
defaultConsent.
SDK ignora la richiesta se ha già inviato le stesse preferenze per il visitatore. Tiene traccia delle preferenze inviate tramite il servizio storage, pertanto questo controllo funziona tra le richieste solo se trasmetti il servizio storage del visitatore a forRequest. In caso contrario, ogni chiamata invia una richiesta all’Edge Network, anche se le preferenze del visitatore non sono cambiate. Chiamare setConsent quando il visitatore effettua o modifica una scelta di consenso, anziché a ogni richiesta.
Richiesta non autenticata. Assicurati che lo stream di dati accetti le richieste non autenticate. Vedere Impostare il tipo di accesso allo stream di dati.
Opzioni options
Il metodo setConsent accetta un oggetto con le seguenti proprietà:
consent: obbligatorio. Un array di oggetti di consenso, ciascuno in uno degli standard supportati.identityMap: mappa di identità per il visitatore. Edge Network applica il consenso a livello di dispositivo, quindi utilizza soloECIDdi questa mappa.edgeConfigOverrides: oggetto di override della configurazione dello stream di dati per questa richiesta.
Oggetto risultato result
Il metodo setConsent restituisce una promessa che si risolve con un oggetto vuoto quando l’Edge Network accetta le preferenze di consenso.