Declared IDs declared-ids

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

Declared ID Doelstelling declared-id-targeting

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

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

Sommige browsers en de meeste mobiele apparaten kunnen niet door derden worden geaccepteerd cookies. Hierdoor is het moeilijk om informatie over sitebezoekers te behouden of permanente id's toe te wijzen. Om dit probleem op te lossen, Audience Manager gebruik DIL om in te gaan declared IDs op een gebeurtenisvraag. Ook declared ID kan 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 vormen Experience Cloud ID-service en DIL over de pagina's op uw plaats die u voor gegevensinzameling wilt gebruiken. Zie DIL maken en Opgegeven id-variabelen.

Uitgaande oproepen opt-out-calls

De declared ID proces respecteert voorkeuren sitebezoekers om te weigeren Audience Manager door uw website. Wanneer Audience Manager ontvangt een "opt-out"-verzoek, JSON geretourneerd door de DCS bevat foutcode 171, met het bericht Encountered opt out tagin plaats van de Audience Manager gebruikersnaam.

Zie Gegevensprivacy voor meer informatie over het opting-out van gegevensinzameling.

Declared ID Voorbeelden voor uitschakelen opt-out-examples

U kunt een declared ID opt-out-verzoeken met de d_cid en d_cid_ic sleutelwaardeparen. 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

In de volgende tabel worden de sleutelwaardeparen weergegeven die in uw Audience Manager de gegevensleverancier-id en de gebruikers-id's of integratiecodes, indien gebruikt. Opmerking: cursief Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven. 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 over te gaan declared IDs doorheen DIL tot Audience Manager.

DIL gebruikt de Adobe Experience Platform Identity Service Aan controle Declared IDs dil-id-service-pass-declared-ids

Indien gebruikt met de Adobe Experience Platform Identity Service, hoeft u niet meer door te geven declared IDs met de afgekeurde dpid en dpuuid variabelen. In plaats daarvan, de huidige versies van DIL zich op de visitorService functie om de declared IDs van de setCustomerIDs in de Adobe Experience Platform Identity Service. Zie voor meer informatie Klant-id's en verificatiestatus. U wilt bellen visitorService in DIL.create zoals hieronder weergegeven.

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

In de namespace sleutelwaardepaar, MCORG is uw Experience Cloud Organisatie-id. Als u deze id niet hebt, kunt u deze vinden in het dialoogvenster Administration van de Experience Cloud dashboard. U hebt beheerdersmachtigingen nodig om dit dashboard weer te geven. Zie Beheer: Core Services.

Verouderde functies deprecated-functions

Met de nieuwste versies van DIL (6.2+), te hoeven u niet deze zeer belangrijk-waardeparen te gebruiken om binnen over te gaan declared IDs. Dat komt omdat DIL is nu afhankelijk van de visitorService in het bovenstaande codevoorbeeld. Deze functie krijgt declared IDs van de Adobe Experience Platform Identity Service. Maar we verwijzen hier naar deze variabelen voor historische en oudere doeleinden. Zie de code hieronder voor een voorbeeld van hoe te vormen DIL.create om een declared ID van de Visitor ID Service.
In de volgende tabel worden de oudere variabelen beschreven die door de declaredId object:

DPID en DPUUID

Audience Manager vergelijkt en past gecombineerd aan DPID en DPUUID aan een overeenkomstige gebruiker - identiteitskaart in ons systeem. Als een id niet bestaat, Audience Manager maakt een nieuwe gebruikersnaam en synchroniseert deze met de DPID/DPUUID combinatie. Eenmaal Audience Manager komt overeen met of maakt een gebruikers-id (de UUID) wordt die id geretourneerd in het dialoogvenster JSON reactie op de cookie in het domein van de client (first-party) cookie) of andere lokale opslag.

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

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

ID's doorgeven na DIL Instantiëren

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 gebruikersnaam 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 wordt geschreven.

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

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

De declared ID proces respecteert voorkeuren sitebezoekers om te weigeren Audience Manager door uw website. Wanneer Audience Manager ontvangt een "opt-out"-verzoek, DCS retourneert een lege waarde JSON object in plaats van het Audience Manager gebruikersnaam.