setConsent

De opdracht setConsent geeft aan de Web SDK door of gegevens moeten worden verzonden (opt-in), gegevens moeten worden verwijderd (opt-out) of defaultConsent (toestemming onbekend) moet worden gebruikt.

De SDK van het Web ondersteunt de volgende standaarden:

Na het gebruiken van dit bevel, schrijft het Web SDK de voorkeur van de gebruiker aan een koekje. De volgende keer dat de gebruiker uw website in de browser laadt, haalt de SDK deze voorkeuren die nog steeds aanwezig zijn op om te bepalen of gebeurtenissen naar de Adobe kunnen worden verzonden.

Adobe raadt u aan om voorkeuren voor het toestemmingsdialoogvenster los van de toestemming van Web SDK op te slaan. De Web SDK biedt geen manier om toestemming terug te winnen. Om ervoor te zorgen dat de gebruikersvoorkeuren synchroon blijven met de SDK, kunt u de opdracht setConsent aanroepen bij elke pagina die wordt geladen. SDK van het Web maakt slechts een servervraag wanneer de toestemming verandert.

De Web SDK biedt twee aanvullende opdrachten voor de configuratie van toestemmingen:

  • defaultConsent: deze opdracht is bedoeld om de voorkeuren voor toestemming van Adobe klanten vast te leggen met gebruik van Web SDK.
  • setConsent: deze opdracht is bedoeld om de voorkeuren voor toestemming van uw sitebezoekers vast te leggen.

Wanneer deze instellingen samen worden gebruikt, kunnen ze leiden tot verschillende resultaten voor gegevensverzameling en cookie-instellingen, afhankelijk van de geconfigureerde waarden.

Zie de onderstaande tabel om te begrijpen wanneer gegevensverzameling plaatsvindt en wanneer cookies worden ingesteld, op basis van toestemmingsinstellingen.

defaultConsent
setConsent
Gegevensverzameling vindt plaats
Web SDK stelt browsercookies in
in
in
Ja
Ja
in
out
Nee
Ja
in
Niet ingesteld
Ja
Ja
pending
in
Ja
Ja
pending
out
Nee
Ja
pending
Niet ingesteld
Nee
Nee
out
in
Ja
Ja
out
out
Nee
Ja
out
Niet ingesteld
Nee
Nee

De volgende cookies worden ingesteld wanneer de configuratie van de toestemming dit toestaat:

Naam
Max. leeftijd
Beschrijving
AMCV_##@AdobeOrg
34128000 (395 dagen)
Wordt weergegeven wanneer idMigrationEnabled is ingeschakeld. Het helpt bij het overschakelen naar Web SDK terwijl sommige delen van de site nog steeds visitor.js gebruiken.
het koekje van de Index
15552000 (180 dagen)
Presenteren als id-synchronisatie is ingeschakeld. Audience Manager stelt dit cookie zo in dat een unieke id wordt toegewezen aan een sitebezoeker. Het demdex-cookie helpt Audience Manager basisfuncties uit te voeren, zoals bezoekersidentificatie, id-synchronisatie, segmentatie, modellering, rapportage, enzovoort.
kndctr_orgid_cluster
1800 (30 minuten)
Hiermee slaat u het gebied Edge Network op dat de verzoeken van de huidige gebruiker dient. Het gebied wordt gebruikt in de weg URL zodat de Edge Network het verzoek aan het correcte gebied kan leiden. Als een gebruiker met een verschillend IP adres of in een verschillende zitting verbindt, wordt het verzoek opnieuw verpletterd aan het dichtstbijzijnde gebied.
kCt_orgid_identity
34128000 (395 dagen)
Hiermee slaat u de ECID op, evenals andere informatie over de ECID.
kndctr_orgid_permission
15552000 (180 dagen)
Hiermee slaat u de voorkeur van de gebruikers voor toestemming voor de website op.
s_ecid
63115200 (2 jaar)
Bevat een exemplaar van Experience Cloud identiteitskaart (ECID) of MID. MID wordt opgeslagen in een sleutelwaardepaar dat deze syntaxis volgt, s_ecid=MCMID|<ECID>.

Toestemming instellen met de extensie van de Web SDK-tag

Het plaatsen van toestemming wordt uitgevoerd als actie binnen een regel in de de etiketteninterface van de Inzameling van Gegevens van Adobe Experience Platform.

  1. Login aan experience.adobe.comgebruikend uw geloofsbrieven van Adobe ID.
  2. Ga naar Data Collection > Tags.
  3. Selecteer de gewenste eigenschap tag.
  4. Navigeer naar Rules en selecteer vervolgens de gewenste regel.
  5. Selecteer onder Actions een bestaande actie of maak een actie.
  6. Stel het vervolgkeuzeveld Extension in op Adobe Experience Platform Web SDK en stel de waarde Action Type in op Set consent .
  7. Stel de gewenste velden rechts in, inclusief Standard en General consent .
  8. Klik op Keep Changes en voer vervolgens de publicatieworkflow uit.

U kunt meerdere objecten voor toestemming in deze handeling opnemen.

Goedkeuring instellen met de Web SDK JavaScript-bibliotheek

Voer het setConsent bevel in werking wanneer het roepen van uw gevormde instantie van het Web SDK. U kunt de volgende objecten in deze opdracht opnemen:

  • consent[]: een array van consent -objecten. Het bevestigingsobject wordt op een andere manier opgemaakt, afhankelijk van de standaard en versie die u kiest. Zie de onderstaande tabbladen voor voorbeelden van elk object permission, afhankelijk van de toestemmingsstandaard.
  • identityMap: Een object dat bepaalt hoe een ECID wordt gegenereerd en aan welke ID's toestemmingsinformatie is gekoppeld. Adobe raadt aan dit object op te nemen wanneer setConsent wordt uitgevoerd vóór andere opdrachten, zoals sendEvent .
  • edgeConfigOverrides: Een voorwerp dat datastreamconfiguratie met voeten treedtbevat.
Adobe 2.0

Als u Adobe Experience Platform gebruikt, moet u een veldgroep met het privacyschema in uw profielschema opnemen. Zie Governance, privacy, en veiligheid in Adobe Experience Platformvoor meer informatie over Adobe 2.0 norm. U kunt gegevens in het onderstaande waardeobject toevoegen die overeenkomen met het schema van het veld consents van de Consents and Preferences -profielveldgroep.

  • standard: De toestemmingsnorm die u kiest. Stel deze eigenschap in op "Adobe" voor de standaard Adobe 2.0.

  • version: Een tekenreeks die de versie van de toestemmingsstandaard vertegenwoordigt. Stel deze eigenschap in op "2.0" voor de standaard Adobe 2.0.

  • value: Een object met toestemmingswaarden.

    • value.collect.val: De waarde van de toestemming. Stel deze in op "y" wanneer gebruikers zich aanmelden en op "n" wanneer gebruikers weigeren.
    • value.metadata.time: Het tijdstempel waarin gebruikers hun instellingen voor toestemming voor het laatst hebben bijgewerkt.
code language-js
// 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"
      }
    }
  }]
});
IAB TCF 2.0

Als u de voorkeuren voor gebruikerstoestemming wilt vastleggen die via de TCF-standaard (Interactive Advertising Bureau Europe) (IAB) Transparency and Consent Framework) zijn opgegeven, stelt u de verbindingstekenreeks in zoals hieronder wordt getoond.

Wanneer de toestemming op deze manier wordt geplaatst, wordt het Real-Time Profiel van de Klant bijgewerkt met de toestemmingsinformatie. Voor dit aan werk, moet het profielXDM schema de het schemagroep van de Privacy van het Profielbevatten. Bij het verzenden van gebeurtenissen moet de informatie over de IAB-toestemming handmatig worden toegevoegd aan het XDM-gebeurtenisobject. De SDK van het Web neemt automatisch niet de toestemmingsinformatie in de gebeurtenissen op.

Als u toestemmingsinformatie in gebeurtenissen wilt verzenden, moet u de het gebiedsgroep van de Privacy van de Gebeurtenis van de Ervaring aan uw Profile - toegelaten XDM ExperienceEvent schema toevoegen. Zie de sectie op het bijwerken van het schema ExperienceEventin de gids van de datasetvoorbereiding voor stappen op hoe te om dit te vormen.

  • standard: De toestemmingsnorm die u kiest. Stel deze eigenschap in op "IAB TCF" voor de IAB TCF 2.0-standaard.
  • version: Een tekenreeks die de versie van de toestemmingsstandaard vertegenwoordigt. Stel deze eigenschap in op "2.0" voor de IAB TCF 2.0-standaard.
  • value: Een tekenreeks die de waarde voor toestemming bevat.
  • gdprApplies: Een Booleaanse waarde die bepaalt of GDPR op deze waarde voor toestemming van toepassing is. De standaardwaarde is true .
  • gdprContainsPersonalData: Een Booleaanse waarde die bepaalt of de gebeurtenisgegevens die aan deze gebruiker zijn gekoppeld, persoonlijke gegevens bevatten. De standaardwaarde is false .
code language-js
// 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
  }]
});
Adobe 1.0
  • standard: De toestemmingsnorm die u kiest. Stel deze eigenschap in op "Adobe" voor de standaard Adobe 1.0.
  • version: Een tekenreeks die de versie van de toestemmingsstandaard vertegenwoordigt. Stel deze eigenschap in op "1.0" voor de standaard Adobe 1.0.
  • value.general: De waarde van de toestemming. Stel deze in op "in" wanneer gebruikers zich aanmelden en op "out" wanneer gebruikers weigeren.
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

Meerdere standaarden verzenden in één aanvraag multiple-standards

De SDK van het Web steunt ook het verzenden van meer dan één toestemmingsvoorwerp in een verzoek, zoals aangetoond in het hieronder voorbeeld.

alloy("setConsent", {
    consent: [{
        standard: "Adobe",
        version: "2.0",
        value: {
            collect: {
                val: "y"
            },
            metadata: {
                time: "2021-03-17T15:48:42-07:00"
            }
        }
    }, {
        standard: "IAB TCF",
        version: "2.0",
        value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
        gdprApplies: true
    }]
});

Voorkeuren voor blijvende toestemming persistence

Nadat u gebruikersvoorkeuren met de opdracht setConsent aan de SDK van het web hebt doorgegeven, blijven de gebruikersvoorkeuren van de SDK behouden voor een cookie. De volgende keer dat de gebruiker uw website in browser laadt, zal SDK van het Web deze persisted voorkeur terugwinnen en gebruiken om te bepalen of de gebeurtenissen naar Adobe kunnen worden verzonden of niet.

U moet de gebruikersvoorkeuren afzonderlijk opslaan om het bevestigingsvenster met de huidige voorkeuren te kunnen weergeven. Er is geen manier om de gebruikersvoorkeur van SDK van het Web terug te winnen. Om ervoor te zorgen dat de gebruikersvoorkeuren synchroon blijven met de SDK, kunt u de opdracht setConsent aanroepen bij elke pagina die wordt geladen. De SDK van het Web zal slechts een servervraag maken als de voorkeur is veranderd.

Identiteiten synchroniseren tijdens instellen van toestemming sync-identities

Wanneer de standaardtoestemming (die door de wordt geplaatst defaultConsentparameter) aan pending of out wordt geplaatst, kan het setConsent plaatsen het eerste verzoek zijn dat uit gaat en identiteit vestigt. Daarom kan het belangrijk zijn om identiteiten op het eerste verzoek te synchroniseren. U kunt het identiteitsoverzicht aan het setConsent bevel enkel zoals op het sendEvent bevel toevoegen. Zie gebruikend identityMapvoor een voorbeeld van hoe te om de identiteitskaart op uw bevel te omvatten.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636