Documentatie Audience Manager Audience Manager-gebruikershandleiding

Declared IDs

Laatst bijgewerkt: 20 mei 2023

Onderwerpen:

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

Declared ID Doelstelling

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

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.

Proces	Beschrijving
Gebeurtenisoproep	Als u wilt werken, hebt u DIL en de Adobe Experience Platform Identity Servicecode op de pagina. DIL get gedeclareerde id's van de `setVisitorID` door de Adobe Experience Platform Identity Service en geeft dat door aan Audience Manager .
Identiteitskaart afstemmen	Audience Manager probeert de client- en bezoekersidentiteitskaart te koppelen aan een bijbehorende id in ons systeem. Als er geen overeenkomende id bestaat, maakt Audience Manager een nieuwe id en koppelt deze aan de client- en bezoeker-id. Opmerking: De meest recente toewijzing wordt gebruikt als uw identiteitskaart aan meer dan één Audience Manager ID toewijst.
Return-id	Audience Manager schrijft zijn gesynchroniseerde identiteitskaart aan een eerderangs koekje (of andere adresseerbare opslagruimte) in het cliëntdomein of de toepassing.
Volgende gebeurtenisaanroepen	De extra gebeurtenisvraag leest identiteitskaart van de Audience Manager van het domein van de cliënt en verzendt dat naar Audience Manager.

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

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.

Audience Manager kan een declared ID opt-out naast een Audience Manager UUID in de URL.
De declared ID opt-out wordt opgeslagen in de Profile Cache Server (PCS) per partner. Er is geen opt-out op platformniveau declared IDs. Daarnaast Audience Manager kiest de gebruiker uit dat bepaalde gebied op de rand (de opt-out gaat niet over DCS regio's).

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

Declared ID Voorbeelden voor uitschakelen

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	Codevoorbeeld
Een dataprovider-id en een gebruikers-id.	`https://domain name/demoptout.jpg?d_cid=123%01987...`
Een integratiecode en een gebruikers-id.	`https://domain name/demoptout?d_cid_ic=456%01321...`
Meerdere `d_cid` en `d_cid_ic` sleutelwaardeparen.	`https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...`

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:

Uitschakelen (afgekeurd) Codevoorbeeld

d_uuid alleen https://domain/demoptout.jpg?d_uuid=AAM ID

Optie op partnerniveau

Uitschakelen (afgekeurd)	Codevoorbeeld
`d_uuid` alleen	`https://domain/demoptout.jpg?d_uuid=AAM ID`
Optie op partnerniveau	`https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID` Een partner niveau opt-out wordt opgeslagen voor de recentste afbeelding van dit `dpid` + `dpuuid` koppelen aan een AAM UUID. Als er nog geen bestaande toewijzing is, controleert de Audience Manager of de aanvraag een AAM UUID in het cookie bevat en, als dit het geval is, gebruikt deze om de opt-out op te slaan. Anders genereert Audience Manager een nieuwe AAM UUID en slaat de opt-out onder deze UID op.
`d_dpuuid` + `d_dpid` en uitdrukkelijk `d_uuid`	`https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID` `d_uuid` heeft altijd voorrang. Als de `dpid` + `dpuuid` combinatie kaarten aan een andere AAM UUID, wordt de opt-out opgeslagen onder AAM UUID die in het verzoek wordt overgegaan ( `d_uuid` ).

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

Een partner niveau opt-out wordt opgeslagen voor de recentste afbeelding van dit dpid + dpuuid koppelen aan een AAM UUID. Als er nog geen bestaande toewijzing is, controleert de Audience Manager of de aanvraag een AAM UUID in het cookie bevat en, als dit het geval is, gebruikt deze om de opt-out op te slaan. Anders genereert Audience Manager een nieuwe AAM UUID en slaat de opt-out onder deze UID op.

d_dpuuid + d_dpid en uitdrukkelijk d_uuid

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid heeft altijd voorrang. Als de dpid + dpuuid combinatie kaarten aan een andere AAM UUID, wordt de opt-out opgeslagen onder AAM UUID die in het verzoek wordt overgegaan ( d_uuid ).

Variabelen en syntaxis voor Declared IDs

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:

De = Hiermee scheidt u de toets van de gerelateerde waarden.
Niet-afdrukbaar ASCII teken %01 scheidt de waarden.

Variabele	Beschrijving
`d_cid =data provider ID %01user ID`	Bevat een gegevensleverancier-id en een bijbehorende unieke gebruikers-id in één sleutel-waardepaar. `d_cid` vervangt `d_dpid` en `d_dpuuid` , die als afgekeurd worden beschouwd, maar nog steeds worden ondersteund. Zie CID vervangt DPID en DPUUID.
`d_cid_ic =integration code %01user ID`	Bevat een integratiecode en een bijbehorende unieke gebruiker - identiteitskaart in één enkel zeer belangrijk-waardepaar. `d_cid_ic` vervangt `d_dpid` en `d_dpuuid` , die zijn vervangen, maar nog steeds worden ondersteund. Zie CID vervangt DPID en DPUUID.

Voorbeeld van gebeurtenisaanroepen

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

Gebeurtenisoproep omvat	Codevoorbeeld
Een dataprovider-id en een gebruikers-id.	`https://domain name/event?d_cid=123%01987...`
Een integratiecode en een gebruikers-id.	`https://domain name/event?d_cid_ic=456%01321...`
Meerdere `d_cid` en `d_cid_ic` sleutelwaardeparen.	`https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...`

Declared ID Variabelen

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

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

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:

Naam

Type

Beschrijving

dpid

String

Identiteitskaart van de partner van gegevens die door Audience Manager wordt toegewezen.

dpuuid

String

De unieke id van de gegevensaanbieder voor de gebruiker.

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

NOTE

U moet programmatically de code ontwikkelen die de waarden van identiteitskaart voor d_dpuuid en d_dpid toetsen.

ID's doorgeven na DIL Instantiëren

NOTE

Als u een API vraag met een verschillende declaredID combinatie, zal de nieuwe combinatie slechts voor die vraag worden gebruikt. Verdere regelmatige gebeurtenisvraag zal origineel gebruiken DIL.create declaredID combinatie.

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

Voorbeelden van aanvragen/antwoorden

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

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.

recommendation-more-help