Consents and Preferences datatyp

The Consent for Privacy, Personalization and Marketing Preferences datatyp (nedan kalladConsents and Preferences datatypen") är en Experience Data Model (XDM) datatyp som är avsedd att stödja insamling av kundbehörigheter och preferenser som genereras av CMP (Consent Management Platforms) och andra källor från dataåtgärderna.

Detta dokument omfattar strukturen och den avsedda användningen av de fält som tillhandahålls av Consents and Preferences datatyp.

Förutsättningar prerequisites

Det här dokumentet kräver en fungerande förståelse av XDM och användning av scheman i Experience Platform. Läs följande dokumentation innan du fortsätter:

Datatypstruktur structure

IMPORTANT
The Consents and Preferences datatypen är avsedd att omfatta en rad olika användningsområden för samtycke och preferenshantering. Därför beskriver det här dokumentet användningen av datatypens fält i allmänna termer och ger bara förslag på hur du ska tolka användningen av dessa fält. Kontakta ditt juridiska team för sekretess för att anpassa datatypens struktur till hur din organisation tolkar och presenterar dessa samtycke och preferenser för dina kunder.

The Consents and Preferences datatypen innehåller flera fält som används för att hämta samtycke och inställning information.

Ett samtycke är ett alternativ som gör att kunden kan ange hur deras data får användas. De flesta samtycke har en juridisk aspekt, eftersom vissa jurisdiktioner kräver tillstånd innan data kan användas på ett visst sätt, eller kräver att kunden har möjlighet att stoppa användningen (avanmäl dig) om det inte krävs ett godkännande.

En preferens är ett alternativ som gör det möjligt för kunden att specificera hur olika aspekter av upplevelsen av ett varumärke ska hanteras. De kan delas in i två kategorier:

  • Personaliseringsinställningar: Inställningar för hur varumärket ska personalisera upplevelser som levereras till en kund.
  • Marknadsföringsinställningar: Inställningar för om ett varumärke får kontakta en kund via olika kanaler.

I följande skärmbild visas hur strukturen för datatypen visas i användargränssnittet för plattformen:

TIP
Se guiden på utforska XDM-resurser om du vill ha steg om hur du söker upp en XDM-resurs och inspekterar dess struktur i plattformens användargränssnitt.

I följande JSON visas ett exempel på den datatyp som Consents and Preferences kan bearbeta datatypen. Information om hur dessa fält används finns i de avsnitt som följer.

{
  "consents": {
    "collect": {
      "val": "VI",
    },
    "adID": {
      "idType": "IDFA",
      "val": "y"
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "u"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
Du kan generera JSON-exempeldata för alla XDM-scheman som du definierar i Experience Platform för att visualisera hur kundens samtycke och inställningsdata ska mappas. Mer information finns i följande dokumentation:

consents choices

consents innehåller flera fält som beskriver en kunds samtycke och önskemål. Dessa fält beskrivs närmare i underavsnitten nedan.

"consents": {
  "collect": {
    "val": "VI",
  },
  "adID": {
    "idType": "IDFA",
    "val": "y"
  },
  "share": {
    "val": "y",
  },
  "personalize": {
    "content": {
      "val": "y"
    }
  },
  "marketing": {
    "preferred": "email",
    "any": {
      "val": "u"
    },
    "email": {
      "val": "n",
      "reason": "Too Frequent",
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

collect

collect representerar kundens samtycke till att deras data samlas in.

"collect": {
  "val": "y"
}
Egenskap
Beskrivning
val
Kunden har gett sitt medgivande för det här användningsärendet. Se appendix för godkända värden och definitioner.

adID

adID representerar kundens samtycke för huruvida ett annonser-ID kan användas för att länka kunden mellan appar på den här enheten.

"adID": {
  "idType": "IDFA",
  "val": "y"
}
Egenskap
Beskrivning
idType
Typ av annons-ID, antingen IDFA för Apple ID för annonsörer eller GAID för Google Advertiser ID, även känt som Android Advertiser ID (AAID).
val
Kunden har gett sitt medgivande för det här användningsärendet. Se appendix för godkända värden och definitioner.

share

share representerar kundens samtycke för huruvida deras data kan delas med (eller säljas till) andra eller tredje part.

"share": {
  "val": "y"
}
Egenskap
Beskrivning
val
Kunden har gett sitt medgivande för det här användningsärendet. Se appendix för godkända värden och definitioner.

personalize personalize

personalize Hämtar kundpreferenser för vilka sätt deras data kan användas för personalisering. Kunder kan välja bort specifika användningsfall för personalisering eller välja bort helt från personalisering.

IMPORTANT
personalize omfattar inte användningsfall för marknadsföring. Om en kund till exempel väljer bort personalisering för alla kanaler bör de inte sluta ta emot kommunikation via dessa kanaler. De meddelanden de får ska i stället vara generiska och inte baseras på deras profil.
I samma exempel väljer en kund att inte använda direktmarknadsföring för alla kanaler (via marketing, som förklaras i nästa avsnitt) bör kunden inte få något meddelande, även om personalisering är tillåten.
"personalize": {
  "content": {
    "val": "y",
  }
}
Egenskap
Beskrivning
content
Representerar kundens önskemål om personaliserat innehåll på er webbplats eller i er tillämpning.
val
Personalisering som kunden har tillhandahållit för det angivna användningsfallet. I de fall där kunden inte behöver uppmanas att ge sitt samtycke, ska värdet i detta fält ange grunden för personaliseringen. Se appendix för godkända värden och definitioner.

marketing marketing

marketing hämtar in kundpreferenser för vilka marknadsföringssyften deras data kan användas för. Kunderna kan välja bort specifika fall av marknadsföringsanvändning eller välja bort direkt marknadsföring helt och hållet.

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}
Egenskap
Beskrivning
preferred
Anger kundens föredragna kanal för att ta emot kommunikation. Se appendix för godkända värden.
any
Representerar kundens preferenser för direktmarknadsföring som helhet. Den medgivandeinställning som anges i detta fält anses vara standardinställning för alla marknadsföringskanaler, såvida den inte åsidosätts av ytterligare delfält som anges i marketing. Om du planerar att använda fler detaljerade alternativ för samtycke rekommenderar vi att du utelämnar det här fältet.

Om värdet är nska alla mer specifika personaliseringsinställningar ignoreras. Om värdet är yså bör alla fininniga personaliseringsalternativ också behandlas som y, såvida inte explicit inställt på n. Om värdet inte anges bör värdena för varje personaliseringsalternativ respekteras enligt vad som anges.
email
Anger om kunden går med på att ta emot e-postmeddelanden.
push
Anger om kunden tillåter att push-meddelanden tas emot.
sms
Anger om kunden går med på att ta emot textmeddelanden.
val
Inställningen som tillhandahålls av kunden för det angivna användningsfallet. I de fall där kunden inte behöver uppmanas att ge sitt samtycke, ska värdet i detta fält ange grunden för användningen av marknadsföringen. Se appendix för godkända värden och definitioner.
time
En ISO 8601-tidsstämpel för när marknadsföringsinställningen ändrades, om tillämpligt. Observera att om tidsstämpeln för en enskild inställning är densamma som den som anges under metadata, ska det här fältet inte ställas in för den inställningen.
reason
När en kund väljer bort från ett marknadsföringsärende representerar det här strängfältet anledningen till varför kunden valde bort.

metadata

metadata samlar in allmänna metadata om kundens samtycke och inställningar när de senast uppdaterades.

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}
Egenskap
Beskrivning
time
En ISO 8601-tidsstämpel för senaste gången som något av kundens samtycke och inställningar uppdaterades. Det här fältet kan användas i stället för att tidsstämplar tillämpas på enskilda inställningar för att minska inläsningen och komplexiteten. Tillhandahåller en time värdet under en enskild inställning åsidosätter metadata tidsstämpel för den aktuella inställningen.

Inhämta data med datatypen ingest

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

Se självstudiekursen om skapa ett schema i användargränssnittet för steg om hur du tilldelar datatyper till fält. När du har skapat ett schema som innehåller ett fält med Consents and Preferences datatyp, se avsnittet om skapa en datauppsättning i användarhandboken för datauppsättningen följer du stegen för att skapa en datauppsättning med ett befintligt schema.

IMPORTANT
Om du vill skicka medgivandedata till Real-Time Customer Profilemåste du skapa en Profile-aktiverat schema baserat på XDM Individual Profile klassen som innehåller Consents and Preferences datatyp. Den datauppsättning som du skapar baserat på det schemat måste också aktiveras för Profile. Se självstudiekurserna som är länkade ovan för specifika steg som rör Real-Time Customer Profile krav för scheman och datauppsättningar.
Dessutom måste du se till att dina sammanfogningsprinciper är konfigurerade för att prioritera de datauppsättningar som innehåller de senaste samtycke- och inställningsdata, så att kundprofilerna uppdateras korrekt. Se översikten på sammanfogningsprinciper för mer information.

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 hjälp av 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.

Bilaga appendix

Avsnitten nedan innehåller ytterligare referensinformation om Consents and Preferences datatyp.

Godkända värden för val choice-values

I följande tabell visas godkända värden för val:

Värde
Titel
Beskrivning
y
Ja (anmälan)
Kunden har valt att ge sitt medgivande eller önskemål. Med andra ord: do samtycke till att deras uppgifter används i enlighet med det aktuella medgivandet eller den berörda förmånsbehandlingen.
n
Nej (avanmälan)
Kunden har valt bort samtycke eller önskemål. Med andra ord: inte samtycke till att deras uppgifter används i enlighet med det aktuella medgivandet eller den berörda förmånsbehandlingen.
p
Väntande verifiering
Systemet har ännu inte fått något slutligt godkännande eller inställningsvärde. Detta används oftast som en del av ett samtycke som kräver tvåstegsverifiering. Om en kund till exempel väljer att ta emot e-postmeddelanden ställs detta medgivande in på p tills de väljer en länk i ett e-postmeddelande för att verifiera att de har angett rätt e-postadress, och då uppdateras medgivandet till y.

Om detta samtycke eller denna inställning inte använder en tvåstegsverifieringsprocess ska p kan i stället användas för att ange att kunden ännu inte har svarat på frågan om samtycke. Du kan till exempel ställa in värdet automatiskt på p på första sidan av en webbplats, innan kunden har svarat på frågan om samtycke. I jurisdiktioner som inte kräver uttryckligt medgivande kan ni också använda det för att ange att kunden inte uttryckligen har avanmält sig (med andra ord antas medgivande).
u
Okänd
Kundens samtycke eller inställningsinformation är okänd.
dy
Standard för Ja (anmälan)
Kunden har inte lämnat in något medgivande i sig och behandlas som en anmälan ("Ja") som standard. Med andra ord antas samtycke tills kunden anger något annat.

Observera att om lagar eller ändringar i företagets sekretesspolicy leder till ändringar av standardvärdena för vissa eller alla användare, måste du uppdatera alla profiler som innehåller standardvärden manuellt.
dn
Standard för Nej (avanmälan)
Kunden har inte lämnat in något medgivande och behandlas som standard som avanmälan ("Nej"). Med andra ord antas kunden ha vägrat samtycke tills de anger något annat.

Observera att om lagar eller ändringar i företagets sekretesspolicy leder till ändringar av standardvärdena för vissa eller alla användare, måste du uppdatera alla profiler som innehåller standardvärden manuellt.
LI
Legitimalt intresse
Det legitima affärsintresset att samla in och behandla dessa uppgifter för det särskilda ändamålet uppväger den potentiella skada som de kan åsamka den enskilda personen.
CT
Kontrakt
Insamling av uppgifter för det angivna ändamålet krävs för att uppfylla avtalsförpliktelser med den enskilda personen.
CP
Efterlevnad av en juridisk skyldighet
Insamlingen av uppgifter för det angivna ändamålet krävs för att uppfylla företagets rättsliga skyldigheter.
VI
Enskilda personers vitala intressen
Insamling av uppgifter för det särskilda ändamålet krävs för att skydda den enskildes vitala intressen.
PI
Offentligt intresse
Insamling av uppgifter för det angivna ändamålet krävs för att utföra en uppgift i allmänhetens intresse eller vid utövandet av offentlig makt.

Godkända värden för preferred preferred-values

I följande tabell visas godkända värden för preferred. The preferred värden anger kundens föredragna kanal för att ta emot kommunikation som informerar dem om datainsamling, sekretesspolicyer och personaliseringsalternativ.

Värde
Beskrivning
email
Den här inställningen anger kundens samtycke till att ta emot meddelanden via e-post.
push
Den här inställningen anger kundens samtycke till att ta emot push-meddelanden. Det här är meddelanden eller aviseringar som skickas direkt till enheten, ofta ett mobilprogram.
inApp
Den här inställningen anger kundens samtycke till att ta emot meddelanden i appen. Dessa meddelanden levereras inom ett mobil- eller webbprogram och ger information medan användaren är aktiv i appen.
sms
Den här inställningen anger kundens samtycke till att ta emot meddelanden via SMS (Short Message Service). Det här är textmeddelanden som skickas till mobiltelefonen.
phone
Den här inställningen anger att kunden samtycker till att ta emot kommunikation via telefonsamtal.
phyMail
Den här inställningen anger kundens samtycke till att ta emot material via fysisk post.
inVehicle
Den här inställningen anger att kunden samtycker till att ta emot meddelanden när kunden är i fordonet. Dessa meddelanden kan levereras via fordonsinfogningssystem eller andra kommunikationskanaler i fordonet.
inHome
Den här inställningen anger kundens samtycke till att ta emot meddelanden hemma. Dessa meddelanden kan levereras via smarta hemenheter eller andra hembaserade kommunikationskanaler.
iot
Den här inställningen anger att kunden samtycker till att ta emot meddelanden som rör sakernas internet. Dessa meddelanden kan levereras via anslutna enheter och system i deras miljö.
social
Den här inställningen anger att kunden samtycker till att ta emot kommunikation via plattformar för sociala medier.
other
Den här inställningen omfattar kanaler som inte passar in i standardkategorier. Det representerar alternativa eller specialiserade kommunikationskanaler som kan vara specifika för ett visst företag eller en viss bransch.
none
Den här inställningen anger att kunden inte har någon föredragen kommunikationskanal.
unknown
Den här inställningen innebär att kundens önskade kommunikationskanal inte är känd eller inte har angetts. Detta kan inträffa om kunden inte har lämnat något uttryckligt medgivande eller någon särskild information om önskemål.

Fullständig Consents and Preferences schema full-schema

Visa det fullständiga schemat för Consents and Preferences datatyp, se officiell XDM-databas.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07