Gestione del Consenso

Il tracciamento del consenso dell'utente è molto importante per rimanere conformi a regolamentazioni come GDPR e CCPA, ed è una buona pratica per soddisfare i tuoi utenti. Offriamo un supporto estensivo per il tracciamento granulare del consenso.

Le operazioni sui dati del Profilo utente usano il tipo di messaggio consent.

Operazioni

Il parametro operations accetta un array di operazioni. Queste possono essere del seguente tipo:

• set - aggiunge un consenso per un tipo e un valore
• unset - rimuove un consenso per un tipo e un valore

Imposta

Consenso Semplice

Puoi impostare un consenso utente di base come nell'esempio seguente, che indica che l'utente ha acconsentito all'email all'indirizzo person@example.com.

{
  "type": "consent",
  // le operazioni
  "operations": [{
    "type": "set",
    "key": "email",
    "value": "person@example.com"
  }],
  // proprietà generali del messaggio
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

        "operations": [
            {
                "type": "set",
                "key": "email",
                "value": "person@example.com",
                "purpose": [
                    {
                        "type": "marketing",
                        "topics": [
                            "Men's Clothing",
                            "Men's Accessories"
                        ]
                    }
                ]
            }
        ]
    }
]

Aggiunta di uno Scopo

Un utente può dare il consenso solo per uno scopo specifico, ad es. "marketing". Puoi aggiungere questi dettagli a un'operazione di tipo set aggiungendo un attributo purpose. Si tratta di un array di oggetti, con il type dello scopo fornito.

Questo esempio aggiunge il consenso per le email sia di "marketing" che "transazionali":

{
  "type": "consent",
  // le operazioni
  "operations": [{
    "type": "set",
    "key": "email",
    "value": "person@example.com",
    "purpose": [
      {
        "type": "marketing"
      },
      {
        "type": "transactional"
      }
    ]
  }],
  // proprietà generali del messaggio
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

Aggiunta di Argomenti

Un utente potrebbe voler essere contattato per uno scopo specifico solo riguardo a determinati argomenti. Ad esempio, un utente potrebbe voler ricevere materiale di "marketing" da te solo riguardo a "Scarpe da uomo" e "Abbigliamento da sposa".

Questo esempio aggiunge argomenti allo scopo di "marketing":

{
  "type": "consent",
  // le operazioni
  "operations": [{
    "type": "set",
    "key": "email",
    "value": "person@example.com",
    "purpose": [
      {
        "type": "marketing",
        "topics": ["Men's Shoes", "Bridal wear"]
      },
      {
        "type": "transactional"
      }
    ]
  }],
  // proprietà generali del messaggio
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

WARNING

Se vengono forniti gli argomenti, questi sovrascriveranno qualsiasi argomento esistente per uno scopo dato. Tuttavia, non è possibile utilizzarlo per rimuovere tutti gli argomenti inviando un array vuoto, ad es. topics: [].

Annulla

Questo esempio rimuove il consenso email per l'indirizzo email person@example.com. L'operazione Unset non accetta purpose o topics, e questi possono essere modificati solo utilizzando il tipo set.

{
  "type": "consent",
  // le operazioni
  "operations": [{
    "type": "unset",
    "key": "email",
    "value": "person@example.com"
  }],
  // proprietà generali del messaggio
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}