Declared IDs declared-ids

Hoe declared IDs werkt, procedures instellen, codevoorbeelden en variabelen.

Declared ID Doel declared-id-targeting

U kunt gebruikers-id's uitwisselen en synchroniseren met Audience Manager van apparaten of browsers die geen permanente opslagmechanismen, zoals derden, gebruiken of accepteren cookies .

Doel van Declared ID gericht declared-id-targeting-purpose

Sommige browsers en de meeste mobiele apparaten accepteren cookies niet van derden. Hierdoor is het moeilijk om informatie over sitebezoekers te behouden of permanente id's toe te wijzen. Om dit probleem op te lossen, gebruikt Audience Manager DIL om u declared IDs toe te staan bij een gebeurtenisaanroep. Een declared ID kan ook fungeren als een universele id die van toepassing is op dezelfde gebruiker voor alle oplossingen in de Experience Cloud . In de volgende tabel wordt het proces beschreven voor het zoeken naar en zoeken naar id's.

Om te beginnen moet u de Experience Cloud id-service en DIL configureren voor alle pagina's op uw site die u wilt gebruiken voor gegevensverzameling. Zie DIL creeerten Verklaarde Variabelen van identiteitskaart.

Uitgaande oproepen opt-out-calls

Het declared ID -proces houdt rekening met de voorkeuren van de sitebezoeker om Audience Manager -doelen niet te kiezen voor uw website. Wanneer Audience Manager een aanvraag om te weigeren ontvangt, bevat de JSON die door DCS wordt geretourneerd, de foutcode 171 met het bericht Encountered opt out tag in plaats van de gebruikers-id van Audience Manager .

Zie Privacy van Gegevensvoor meer informatie over het opting-uit van gegevensinzameling.

Declared ID Voorbeelden voor uitschakelen opt-out-examples

U kunt een declared ID -aanvraag indienen met de sleutelwaardeparen d_cid en d_cid_ic . De oude parameters zoals d_dpid en d_dpuuid werken nog steeds, maar worden beschouwd als afgekeurd. Zie CID vervangt DPID en DPUUID. In de voorbeelden geeft cursief een plaatsaanduiding voor variabelen aan.

Opt-out met CID en CID_IC

Zie URL-variabelen en syntaxis voor gedeclareerde id’s voor een beschrijving en syntaxis.

Opt-out met DPID, DPUUID en UUID (afgekeurd)

Deze methoden werken nog wel, maar worden als afgekeurd beschouwd. Deze informatie wordt verstrekt voor erfenisdoeleinden en verwijzing. Oudere opt-outs zijn:

Variabelen en syntaxis voor Declared IDs variables-and-syntax

De volgende tabel bevat een lijst met sleutelwaardeparen die uw Audience Manager -gegevensaanbieder-id en -gebruikers-id's of integratiecodes doorgeven, indien gebruikt. Nota, cursief wijst op veranderlijke placeholder. Er zijn spaties toegevoegd om deze beter leesbaar te maken.

In elk zeer belangrijk-waardepaar:

Voorbeeld van gebeurtenisaanroepen sample-event-calls

Op basis van deze sleutelwaardeparen en hun vereiste syntaxis kunt u gebeurtenisaanroepen uitvoeren zoals hieronder wordt weergegeven.

Declared ID Variabelen declared-id-variables

Beschrijft de configuratievariabelen die worden gebruikt om declared IDs tot en met DIL door te geven aan Audience Manager.

DIL gebruikt de lus Adobe Experience Platform Identity Service to Pass Declared IDs dil-id-service-pass-declared-ids

Wanneer gebruikt met de Dienst van de Identiteit van Adobe Experience Platform, te hoeven u niet meer binnen declared IDs met de afgekeurde dpid en dpuuid variabelen over te gaan. In plaats daarvan vertrouwen de huidige versies van DIL op de visitorService functie om declared IDs van de setCustomerIDs functie in Adobe Experience Platform Identity Service te krijgen. Voor meer informatie, zie Klant IDs en de Staten van de Authentificatie. U roept visitorService in DIL.create aan, zoals hieronder wordt weergegeven.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

In het namespace key-value paar is MCORG uw Experience Cloud Organisatie-id. Als u deze id niet hebt, vindt u deze in de sectie Administration van het dashboard van Experience Cloud . U hebt beheerdersmachtigingen nodig om dit dashboard weer te geven. Zie begonnen worden met de diensten van Experience Cloud.

Verouderde functies deprecated-functions

Met de nieuwste versies van DIL (6.2+) hoeft u deze sleutel-waardeparen niet te gebruiken om declared IDs door te geven. Dat komt omdat DIL nu afhankelijk is van de functie visitorService die in het bovenstaande codevoorbeeld wordt weergegeven. Deze functie krijgt declared IDs van Adobe Experience Platform Identity Service. Maar we verwijzen hier naar deze variabelen voor historische en oudere doeleinden. Zie de onderstaande code voor een voorbeeld van het configureren van DIL.create voor het ophalen van een declared ID from the Visitor ID Service .
In de volgende tabel worden de oudere variabelen beschreven die door het object declaredId worden gebruikt:

DPID en DPUUID

Audience Manager vergelijkt en koppelt de gecombineerde DPID en DPUUID -id met een bijbehorende gebruikers-id in ons systeem. Als een id niet bestaat, maakt Audience Manager een nieuwe gebruiker-id en wordt deze gesynchroniseerd met de combinatie DPID/DPUUID . Als Audience Manager eenmaal een gebruikersnaam aanpast of maakt (de UUID ), wordt die id geretourneerd in het JSON -antwoord op de cookie in het domein van de client (de eerste partij cookie ) of andere lokale opslag.

Roep deze functie aan wanneer u DIL v6.1 of eerder gebruikt. Deze functie is echter vervangen door de nieuwe versie die declared IDs krijgt van Adobe Experience Platform Identity Service .

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

ID's doorgeven na DIL Instantiëring

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Voorbeelden van aanvragen/antwoorden request-response-examples

De aanvraag verzendt een gegevensaanbieder en een gebruikers-id naar Audience Manager :

https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

De reactie retourneert de Audience Manager-id (bijvoorbeeld UUID ) die naar een cookie van de eerste partij in het paginadomein is geschreven.

myCallback({
...
   "uuid":"abc123"
})

Niet de Vraag van het Doel en van de Weigering do-not-target

Het declared ID -proces houdt rekening met de voorkeuren van de sitebezoeker om Audience Manager -doelen niet te kiezen voor uw website. Wanneer Audience Manager een aanvraag om te weigeren ontvangt, retourneert de DCS een leeg JSON -object in plaats van de Audience Manager gebruikers-id.