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.

defaultConsent gebruiken in combinatie met setConsent using-consent

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

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.

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

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.

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:

// 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"
      }
    }
  }]
});

// 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
  }]
});

// 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.