Implementera samtycke med en plattform för samtyckeshantering (CMP) med plattformens SDK-tillägg

Många juridiska sekretessbestämmelser har infört krav på aktivt och specifikt samtycke när det gäller datainsamling, personalisering och andra användningsfall inom marknadsföring. För att uppfylla dessa krav kan Adobe Experience Platform inhämta information om samtycke i enskilda kundprofiler och använda dessa inställningar som en avgörande faktor i hur varje kunds data används i arbetsflöden för plattformen.

I den här självstudiekursen visas hur du implementerar och aktiverar data som inhämtats från en CMP (Consent Management Platform) med plattformstillägget för Web SDK i datainsamling. Vi gör detta med hjälp av båda Adobe-standarderna och IAB TCF 2.0-medgivandestandarden, med OneTrust eller SourcePoint som exempel på CMP.

I den här självstudiekursen används tillägget Platform Web SDK för att skicka data om samtycke till plattformen. En översikt över Web SDK finns på den här sidan.

Förhandskrav

Kraven för att använda Web SDK visas här.

På den sidan finns det ett krav på en"händelsedatauppsättning" och, precis som den låter, är detta en datauppsättning som innehåller data för upplevelsehändelser. Om du vill skicka medgivandeinformation med händelser måste fältgruppen IAB TCF 2.0 Consent Details läggas till i Experience Event-schemat:

För standard v2.0 för plattformsgodkännande behöver vi även tillgång till Adobe Experience Platform för att skapa ett enskilt XDM-profilschema och datauppsättning. En självstudiekurs om hur du skapar scheman finns i Skapa ett schema med Schemaredigeraren och för den obligatoriska fältgruppen för samtycke och inställningsinformation i Konfigurera en datauppsättning för insamling av samtycke och inställningsdata.

I den här självstudien förutsätts att du har tillgång till datainsamling och har skapat en taggegenskap på klientsidan med tillägget Web SDK installerat och ett arbetsbibliotek som skapats och byggts för utveckling. Dessa ämnen är detaljerade och demonstrerade i följande dokument:

Vi använder också Chrome-tillägget Platform Debugger för att inspektera och validera implementeringen.

Om du vill implementera IAB TCF-exemplet med en CMP på din egen webbplats behöver du tillgång till en CMP som OneTrust eller SourcePoint för att generera de data som de tillhandahåller. Du kan också följa med och se resultaten nedan.

Använda Web SDK med Adobe Consent Standard (v1.0 eller v2.0)

Mer information om de här standarderna finns i Supporting customer medgivande preferences.

Steg 1: Konfigurera samtycke i Web SDK-tillägget

När vi har installerat tillägget Platform Web SDK i en Tags-egenskap kan vi konfigurera alternativen för att adressera medgivandedata på skärmen för tilläggskonfiguration:

Avsnittet Sekretess anger medgivandenivån för SDK om användaren inte tidigare har gett sitt medgivande. Detta anger standardtillståndet för insamling av samtycke och händelsedata i SDK. Den valda inställningen besvarar frågan om"vad ska SDK göra om användaren ännu inte har gjort explicita medgivandeinställningar?"

Om standardinställningen för samtycke är "In", anger detta för SDK att den inte ska vänta på uttryckligt medgivande och att den ska samla in de händelser som inträffar innan användaren ger sitt medgivande. Dessa inställningar hanteras och lagras vanligtvis i en CMP.

Om standardinställningen för samtycke är "Ut", anger detta för SDK att den inte ska samla in några händelser som inträffar innan användarens inställningar för anmälan har angetts. Besöksaktivitet som inträffar innan inställningen för samtycke har angetts inkluderas inte i data som skickas av SDK när samtycke har angetts. Om du till exempel bläddrar och visar en webbsida innan du väljer medgivandebanderollen, och den här inställningen "Ut" används, skickas inte rullningsaktiviteten och visningstiden om användaren senare ger ett uttryckligt medgivande för datainsamling.

Om standardinställningen för samtycke är Väntande kommer SDK att ställa in alla händelser som inträffar innan användaren ger sitt medgivande, så händelserna kan skickas efter att inställningarna för medgivande har angetts och efter att SDK initialt har konfigurerats under ett besök.

Med den här inställningen "Väntande" kommer ett försök att köra kommandon som kräver användarens inställningar för deltagande (till exempel händelsekommandot) att resultera i att kommandot köas i SDK:n. Dessa kommandon bearbetas inte förrän du har meddelat användarens inställningar för deltagande till SDK:n.

När en CMP samlar in användarens inställningar kan vi meddela dessa inställningar till SDK:n. I ett senare avsnitt nedan får vi se hur vi får tillgång till denna anmälningsinformation och använder den med Web SDK-tillägget.

"Tillhandahålls av dataelement" ger oss åtkomst till ett dataelement som innehåller eventuella medgivandeinställningsdata som samlats in av en anpassad kod eller en CMP på din webbplats, eller i ditt datalager. Ett dataelement som används för detta ändamål ska resultera i"in","ut" eller"pending".

Obs! Den här konfigurationsinställningen för SDK bevaras inte för användarprofiler, den är specifik för att ställa in SDK:s beteende innan besökaren anger explicit samtycke.

Mer information om hur du konfigurerar Web SDK-tillägget finns i översikten över plattformstillägget för Web SDK och Supporting customer medgivande preferences (Stöd för kundens samtycke).

I det här exemplet väljer vi alternativet Väntande och väljer Spara för att spara konfigurationsinställningarna.

Steg 2: Kommunicera i Inställningar för samtycke

Nu när vi har angett standardbeteendet för SDK kan vi använda taggar för att skicka en besökares uttryckliga medgivandeinställningar till Platform. Det är enkelt att implementera data som skickas med medgivande enligt Adobe 1.0- eller 2.0-standarden med hjälp av Web SDK-åtgärden setConsent i taggreglerna.

Ställa in samtycke med plattformsgodkännande Standard 1.0

Låt oss skapa en regel för att visa detta. Välj Regler i plattformstaggegenskapen och klicka sedan på den blå knappen Lägg till regler. Låt oss namnge regeln"setAdobeConsent" och välja att lägga till en händelse. För Händelsetyp väljer du "Fönster inläst" som aktiverar den här regeln varje gång en sida läses in på vår webbplats. Under Åtgärder väljer du sedan Lägg till för att öppna skärmen för åtgärdskonfiguration. Det är här vi ställer in data för samtycke. Välj listrutan "Tillägg" och välj "Platform Web SDK", välj sedan "Åtgärdstyp" och välj "Ange samtycke".

Välj "Fyll i ett formulär" under "Samtyckesinformation". I den här regelåtgärden använder vi Web SDK för att ange medgivande till medgivandandarestandarden för Adobe 1.0 genom att fylla i formuläret som visas:

Vi kan välja att skicka"In","Ut" eller"Tillhandahålls av dataelement" med den här åtgärden för att ange samtycke. Ett dataelement här bör resultera i "in" eller "out".

I det här exemplet väljer vi"In" för att ange att besökaren har godkänt att Web SDK skickar data till Platform. Välj den blå knappen "Behåll ändringar" om du vill spara den här åtgärden och sedan "Spara" om du vill spara regeln.

Obs! När en webbplatsbesökare har avanmält sig kan du inte ange användarens samtycke i SDK.

Dina taggregler kan aktiveras av en mängd inbyggda eller anpassade händelser som kan användas för att skicka medgivandedata vid lämplig tidpunkt under en besökarsession. I exemplet ovan använde vi händelsen loaded för fönstret för att utlösa regeln. I ett senare avsnitt kommer vi att använda en medgivandeinställningshändelse från en CMP för att utlösa en Set Consent-åtgärd. Du kan använda åtgärden Ange samtycke i en regel som aktiveras av en händelse som du föredrar som anger en inställning för deltagande.

Ställa in samtycke med plattformsgodkännande Standard 2.0

Version 2.0 av plattformens medgivandestandard fungerar med XDM-data. Du måste också lägga till fältgruppen för samtycke och inställningsinformation i ditt profilschema i plattformen. Mer information om standardversionen 2.0 och den här fältgruppen finns i Samtyckesbearbetning i plattformen.

Vi skapar ett anpassat kodelement för att skicka data till egenskaperna collect och metadata för det innehållsobjekt som visas i schemat nedan:

Den här fältgruppen för innehåll- och inställningsinformation innehåller fält för XDM-datatypen Consents & Preferences som kommer att innehålla de data för medgivandeinställningar som vi skickar till plattformen med plattformens SDK-tillägg i vår regelåtgärd. För närvarande är de enda nödvändiga egenskaperna för att implementera Platform Consent Standard 2.0 insamlingsvärdet (val) och tidsvärdet för metadata, som markeras ovan med rött.

Låt oss skapa ett dataelement för dessa data. Välj Dataelement och den blå knappen Lägg till dataelement. Låt oss ringa detta "xdm-medgivande 2.0" och använda Core-tillägget, vi väljer en anpassad kodtyp. Du kan ange eller kopiera och klistra in följande data i det anpassade kodredigeringsfönstret:

var dateString = new Date().toISOString();

return {
  collect: {
    val: "y"
  },
  metadata: {
    time: dateString
  }
}

Tidsfältet ska ange när användaren senast uppdaterade sina medgivandeinställningar. Vi skapar en tidsstämpel här som exempel med en standardmetod i JavaScript Date-objektet. Välj Spara för att spara den anpassade koden och välj Spara igen för att spara dataelementet.

Sedan väljer vi Regler och sedan den blå knappen Lägg till regel och skriver namnet"setConsent onLoad - Consent 2.0". Låt oss välja händelsen Fönsterinläst som regelutlösare och sedan välja Lägg till under Åtgärder. Välj plattformens SDK-tillägg och välj Ange medgivande för åtgärdstypen. Standard ska vara Adobe och version 2.0 ska vara. För Värde använder vi det dataelement vi nyss skapade som innehåller de insamlings- och tidsvärden vi måste skicka till Platform:

För att granska den här exempelåtgärden anropar vi Set Consent från Platform Web SDK-tillägget och skickar in Standard och Version från formuläret, samtidigt som vi skickar värdena för samling och tid från dataelementet som vi skapade tidigare.

Klicka på den blå knappen Spara och spara regeln igen.

Vi har nu två regler, en för varje standard för plattformsgodkännande. I praktiken väljer du förmodligen en standard för alla webbplatser. Sedan ska vi skapa ett exempel med hjälp av IAB TCF 2.0-medgivandestandarden.

Använda Web SDK med IAB TCF 2.0 Consent Standard

Du kan läsa mer om version 2.0 av IAB-ramverket för genomskinlighet och samtycke på webbplatsen IAB Europe.

Om du vill ange data för medgivandeinställningen med den här standarden måste vi lägga till schemafältgruppen IAB TCF 2.0 Consent Details i vårt Experience Event-schema i plattformen:

Den här fältgruppen innehåller de medgivandefält som krävs av IAB TCF 2.0-standarden. Mer information om scheman och fältgrupper finns i XDM-systemöversikt.

Steg 1: Skapa ett dataelement för samtycke

För att kunna skicka data om medgivandehändelser från taggar med hjälp av IAB TCF 2.0-medgivandestandarden måste vi först skapa ett xdm-dataelement med de obligatoriska medgivandefälten:

I taggarnas klientsidesegenskap väljer du Dataelement och den blå knappen "Lägg till dataelement". Vi namnger det här dataelementet"xdm-medgivandeStrings" för det här exemplet. Dessa xdm-fält kommer att innehålla användarens medgivandedata som krävs för IAB TCF 2.0-standarden.

I listrutan Tillägg väljer du "Platform Web SDK" och under Data Element Type väljer du "XDM Object". xdm-mappningen ska visas så att du kan markera och expandera objektet "medgivandeStrings", vilket visas på skärmbilden ovan.

Vi ställer in alla medgivandeSträngar enligt följande:

Fälten consentStandard och consentStandardVersion är båda bara textsträngar för den standard som vi använder, som är IAB TCF version 2.0. consentStringValue refererar till ett dataelement med namnet"IAB TCF Consent String". Procenttecknen som omger texten anger namnet på ett dataelement, och vi tittar på det om en stund. Fältet containsPersonalData anger om IAB TCF 2.0-medgivandesträngen innehåller några personliga data med antingen True eller False. Fältet gdprApplies anger antingen "true" för GDPR gäller, "false" för GDPR gäller inte, eller "undefined" för okänd om GDPR gäller. För närvarande kommer Web SDK att behandla"undefined" som"true", vilket innebär att data om samtycke som skickas med"gdprApplies: undefined" kommer att behandlas som om besökaren befinner sig i ett område där GDPR gäller.

Mer information om de här egenskaperna och om IAB TCF 2.0 i taggar finns i medgivandedokumentationen.

Steg 2: Skapa en regel för att ställa in samtycke med IAB TCF 2.0-standarden

Därefter skapar vi en regel för att ange samtycke med Web SDK när data för godkännande för den här standarden anges eller ändras av en webbplatsbesökare. I den här regeln ska vi också se hur du fångar in dessa godkännandeändringssignaler från en CMP som OneTrust eller SourcePoint.

Lägga till en regelhändelse

Välj avsnittet Regler i plattformstaggegenskapen och klicka sedan på den blå knappen Lägg till regel. Vi namnger regeln setConsent - IAB och väljer Lägg till under Händelser. Vi ger händelsen namnet tcfapi addEventListener och väljer Öppna redigerare för att öppna den anpassade kodredigeraren.

Kopiera och klistra in följande kod i redigeringsfönstret:

// Wait for window.__tcfapi to be defined, then trigger when the customer has completed their consent and preferences.
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && (tcData.eventStatus === "useractioncomplete" || tcData.eventStatus === "tcloaded")) {
        // save the tcData.tcString properties in data elements
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF Consent GDPR", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn't defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

Den här koden skapar och kör en funktion med namnet addEventListener. Funktionen kontrollerar om objektet window.__tcfapi finns och om det gör det lägger den till en händelseavlyssnare enligt specifikationerna i API:t. Du kan läsa mer om de här specifikationerna i IAB-svaret på GitHub. Om den här händelseavlyssnaren har lagts till och webbplatsbesökaren har slutfört sina val för samtycke och inställningar, anger koden anpassade variabler för tcData.tcString och indikatorn för GDPR-regioner. Om du vill veta mer om IAB TCF kan du gå till IAB:s webbplats och GitHub-repo för teknisk information. När du har angett dessa värden kör koden den utlösarfunktion som aktiverar den här regeln för körning.

Om objektet window.__tcfapi inte fanns första gången funktionen kördes kommer funktionen att söka efter det igen var 100:e millisekund, så händelseavlyssnaren kan läggas till. Den sista kodraden kör helt enkelt funktionen addEventListener som definierats i kodraderna ovanför den.

Sammanfattningsvis har vi skapat en funktion som kontrollerar om en besökare på webbplatsen har gett sitt samtycke med hjälp av en CMP-banner (eller anpassad). När inställningen för samtycke är angiven skapar koden två anpassade variabler (anpassade kodelement) som kan användas i vår regelåtgärd. När du har klistrat in ovanstående kod i det anpassade kodredigeringsfönstret för händelsen väljer du den blå knappen Spara för att spara regelhändelsen.

Nu ställer vi in åtgärden Ange medgivningsregel för att använda dessa värden och skicka dem till plattformen.

Lägg till en regelåtgärd

Välj Lägg till i avsnittet Åtgärder. Välj Platform Web SDK i listrutan under Tillägg. Välj Ange samtycke under Åtgärdstyp. Låt oss namnge den här åtgärden setConsent.

Välj Fyll i ett formulär i åtgärdskonfigurationen under Samtycksinformation. I Standard väljer du IAB TCF och i Version anger du 2.0. För värdet använder vi den anpassade variabeln från vår händelse och anger %IAB TCF Consent String% som kommer från tcData som vi har hämtat i vår anpassade funktion för regelhändelsen ovan.

Under GDPR Applies kommer vi att använda den andra anpassade variabeln från vår händelse och ange %IAB TCF Consent GDPR% som också kommer från tcData som vi har hämtat i vår anpassade funktion för regelhändelsen ovan. Om du vet att GDPR definitivt kommer att eller inte kommer att gälla för besökare på den här webbplatsen kan du välja Ja eller Nej, beroende på vad som är tillämpligt, i stället för att använda den anpassade variabeln (dataelementet). Du kan också använda villkorsstyrd logik i ett dataelement för att kontrollera om GDPR gäller och returnera rätt värde.

Under GDPR innehåller personuppgifter väljer du alternativet att ange om uppgifterna för den här användaren innehåller personuppgifter eller inte. Ett dataelement här ska vara true eller false.

Välj den blå knappen Spara för att spara funktionsmakrot och den blå knappen Spara (eller Spara i bibliotek) för att spara regeln. Nu har du implementerat dataelementet och regeln i taggar för att ange samtycke med hjälp av Web SDK-tillägget med IAB TCF 2.0-medgivandestandarden.

Steg 3: Spara i bibliotek och bygg

Om du använder förutsättningen för arbetsbiblioteket har du redan sparat dessa ändringar och byggt ditt utvecklingsbibliotek:

Steg 4: Inspect och validera datainsamling

På vår webbplats uppdaterar vi sidan och bekräftar biblioteksbygget i Chrome-tillägget Debugger i taggmenyavsnittet:

Vi kan också kontrollera setConsent-anropet för Adobe 1.0- eller 2.0-standarderna i felsökningsplattformens Web SDK-avsnitt genom att välja på innehållsraden i POSTEN i nätverksbegäran där {"consent":[{"value":{"general":"in"},"version… visas:

För att validera setConsent-anropet och vår regel för IAB TCF 2.0-standarden använder vi OneTrust-bannern på vår testwebbplats för att ange våra medgivandeinställningar och skapa de tcData som beskrivs ovan:

När du har valt"Jag accepterar" kan vi undersöka setConsent-anropet för IAB TCF 2.0-standarden i felsökningsplattformens Web SDK-avsnitt genom att välja på POSTENS innehållsrad i nätverksbegäran där {"consent":[{"value":"someAlphaNumericCharacters… visas.

Här ser vi de data vi skapade tidigare i våra dataelement och taggregler. Egenskapen value innehåller de kodade tcString-data som vi såg tidigare.

OneTrust, SourcePoint och andra CMP som implementerar IAB TCF 2.0-standarden kommer alla att producera liknande data på våra sidor. Vi kan hämta dessa data och använda dem med Web SDK-tillägget i taggar med hjälp av den anpassade kodhändelsen i regeln som vi skapade ovan. Den anpassade koden är densamma oavsett vilken CMP som används för att generera IAB TCF 2.0-data. Den anpassade koden kan också användas med någon av standarderna för plattformsgodkännande (1.0 eller 2.0).

Skicka data om samtycke med upplevelsehändelser

Du kanske har lagt märke till att vi inte refererade till dataelementet"xdm-medgivandeStrings" som vi skapade tidigare i ett dataelementfält i någon av våra regler. Det här dataelementet är avsett att användas när du behöver skicka medgivandedata med en Experience Event.

Eftersom det här dataelementet innehåller alla fält som krävs för IAB TCF 2.0-standarden, behöver du bara referera till dataelementet när du skickar xdm-data med dina Experience Events:

Slutsats

Nu när vi har inspekterat och validerat data bör du se hur man implementerar och aktiverar data som vi fått från en CMP med plattformstillägget Web SDK för Platform.