Fältgrupp Consents and Preferences

Consents and Preferences är en standardfältgrupp för XDM Individual Profile klassen som samlar in samtycke och inställningsinformation för en enskild kund.

Fältgruppstruktur structure

Fältgruppen Consents and Preferences tillhandahåller ett enskilt fält av objekttyp, consents, för att hämta information om samtycke och inställningar. Det här fältet utökar datatypen Consent for Privacy, Personalization and Marketing Preferences, tar bort fältet adID och lägger till ett idSpecific-mappningsfält.

I följande JSON visas ett exempel på vilken typ av data som fältgruppen Consents and Preferences kan bearbeta. Mer information om hur du använder de flesta fält som finns i fältgruppen finns i guiden för datatypen Consents and Preferences. Underavsnitten nedan fokuserar på de unika attribut som fältgruppen lägger till i datatypen.

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

idSpecific

idSpecific kan användas när ett visst samtycke eller en viss inställning inte gäller för en kund, men är begränsad till en enda enhet eller ett enda ID. En kund kan till exempel välja att inte ta emot e-post till en adress, samtidigt som e-post kan tillåtas på en annan adress.

Varje nyckel i objektet idSpecific representerar ett specifikt ID-namnområde som känns igen av Adobe Experience Platform Identity Service. Du kan definiera egna namnutrymmen för att kategorisera olika identifierare, men vi rekommenderar att du använder ett av de standardnamnutrymmen som ingår i identitetstjänsten för att minska lagringsstorlekarna för kundprofilen i realtid. Mer information om identitetsnamnutrymmen finns i översikten över identitetsnamnrymden i dokumentationen för identitetstjänsten.

Nycklarna för varje namnområdesobjekt representerar de unika identitetsvärden som kunden har angett inställningar för. Varje identitetsvärde kan innehålla en komplett uppsättning med innehåll och inställningar, formaterade på samma sätt som consents.

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

I marketing-objekt som anges i avsnittet idSpecific stöds inte fälten any och preferred. Dessa fält kan bara konfigureras på användarnivå. Dessutom stöder inte marknadsföringsinställningarna idSpecific för email, sms och push subscriptions fält.

Det finns också ett samtycke som bara kan ges i avsnittet idSpecific: adID. Detta fält beskrivs i underavsnittet nedan.

adID

adID-medgivandet representerar kundens samtycke för huruvida ett annonser-ID (IDFA eller GAID) kan användas för att länka kunden mellan appar på den här enheten. Det här värdet kan bara konfigureras under identitetsnamnområdet ECID i avsnittet idSpecific och kan inte anges för andra namnutrymmen eller på användarnivå för den här fältgruppen.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Inmatning av data med fältgruppen ingest

Om du vill använda fältgruppen Consents and Preferences för att importera medgivandedata från dina kunder måste du skapa en datauppsättning som baseras på ett schema som innehåller den fältgruppen.

I självstudiekursen Skapa ett schema i användargränssnittet finns anvisningar om hur du tilldelar fältgrupper till fält. När du har skapat ett schema som innehåller ett fält med fältgruppen Consents and Preferences kan du läsa avsnittet om att skapa en datauppsättning i användarhandboken för datauppsättningen och följa stegen för att skapa en datauppsättning med ett befintligt schema.

Hantera samtycke och ändringar av inställningar

När en kund ändrar sitt samtycke eller sina inställningar på webbplatsen bör dessa ändringar samlas in och tillämpas omedelbart med Adobe Experience Platform Web SDK. Om en kund väljer bort från datainsamlingen måste all datainsamling omedelbart upphöra. Om en kund väljer bort personalisering bör det inte finnas någon personalisering på nästa sida de besöker.

Nästa steg

Det här dokumentet innehåller strukturen och användningen av fältgruppen Consents and Preferences. Mer information om andra fält som tillhandahålls av fältgruppen finns i dokumentet om datatypen Consent for Privacy, Personalization and Marketing Preferences.