setConsent

Oggetto consent standard Adobe 2.0

Se invii dati a Adobe Experience Platform, includi un gruppo di campi dello schema di privacy nello schema del profilo. Consulta Governance, privacy e sicurezza in Adobe Experience Platform per ulteriori informazioni sullo standard Adobe 2.0. È possibile aggiungere dati all'interno dell'oggetto valore seguente corrispondenti allo schema del campo consents del gruppo di campi profilo Consents and Preferences.

• standard: lo standard di consenso scelto. Imposta questa proprietà su "Adobe" per lo standard Adobe 2.0.

• version: stringa che rappresenta la versione dello standard di consenso. Imposta questa proprietà su "2.0" per lo standard Adobe 2.0.

• value: oggetto contenente i valori di consenso.

  • value.collect.val: valore del consenso. Impostare su "y" quando gli utenti acconsentono e su "n" quando gli utenti rinunciano.
  • value.metadata.time: la marca temporale dell'ultimo aggiornamento delle impostazioni di consenso da parte degli utenti.

// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});

Oggetto consent standard IAB TCF 2.0

Per registrare le preferenze di consenso dell’utente fornite tramite lo standard Interactive Advertising Bureau Europe (IAB) Transparency and Consent Framework (TCF), imposta la stringa di consenso come mostrato di seguito.

Se il consenso è impostato in questo modo, Real-Time Customer Profile viene aggiornato con le informazioni sul consenso. Affinché ciò funzioni, lo schema XDM del profilo deve contenere il gruppo di campi dello schema di privacy del profilo 🔗. Durante l’invio di eventi, le informazioni sul consenso IAB devono essere aggiunte manualmente all’oggetto XDM dell’evento. Il Web SDK non include automaticamente le informazioni sul consenso negli eventi.

Per inviare le informazioni sul consenso negli eventi, è necessario aggiungere il gruppo di campi Privacy evento esperienza allo schema Profile abilitato per XDM ExperienceEvent. Consulta la sezione sull'aggiornamento dello schema ExperienceEvent​ nella guida alla preparazione del set di dati per i passaggi su come configurare questo elemento.

• standard: lo standard di consenso scelto. Impostare questa proprietà su "IAB TCF" per lo standard IAB TCF 2.0.
• version: stringa che rappresenta la versione dello standard di consenso. Impostare questa proprietà su "2.0" per lo standard IAB TCF 2.0.
• value: stringa contenente il valore del consenso.
• gdprApplies: valore booleano che determina se il RGPD si applica a questo valore di consenso. Il valore predefinito è true.
• gdprContainsPersonalData: valore booleano che determina se i dati evento associati all'utente contengono dati personali. Il valore predefinito è false.

// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

L’API IAB TCF 2.0 fornisce un evento per quando il consenso viene aggiornato dal cliente. Ciò si verifica quando il cliente imposta inizialmente le sue preferenze e quando aggiorna le sue preferenze. È possibile aggiungere un listener di eventi per eseguire il comando setConsent:

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

Il blocco di codice riportato sopra ascolta l'evento useractioncomplete e quindi imposta il consenso, passando la stringa di consenso e il flag gdprApplies. Se hai identità personalizzate per i clienti, assicurati di compilare la variabile identityMap.

Oggetto consent standard Adobe 1.0

• standard: lo standard di consenso scelto. Imposta questa proprietà su "Adobe" per lo standard Adobe 1.0.
• version: stringa che rappresenta la versione dello standard di consenso. Imposta questa proprietà su "1.0" per lo standard Adobe 1.0.
• value.general: valore del consenso. Impostare su "in" quando gli utenti acconsentono e su "out" quando gli utenti rinunciano.

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});