Declared IDs declared-ids

Så här fungerar declared IDs, konfigurerar procedurer, kodexempel och variabler.

Målinriktning för Declared ID declared-id-targeting

Utbyt och synkronisera användar-ID:n med Audience Manager från enheter eller webbläsare som inte använder eller accepterar beständiga lagringsmekanismer, till exempel från tredje part cookies.

Syftet med Declared ID-målning declared-id-targeting-purpose

Vissa webbläsare, och de flesta mobila enheter, accepterar inte cookies från tredje part. Detta gör det svårt att behålla information om webbplatsbesökare eller tilldela beständiga ID:n. För att lösa det här problemet använder Audience Manager DIL så att du kan skicka in declared IDs för ett händelseanrop. Dessutom kan en declared ID fungera som ett universellt ID som gäller för samma användare för alla lösningar i Experience Cloud. I följande tabell beskrivs ID-målnings-/matchningsprocessen:

För att komma igång måste du konfigurera Experience Cloud ID-tjänsten och DIL på alla sidor på webbplatsen som du vill använda för datainsamling. Se Skapa och Deklarerade ID-variabler i DIL.

Avanmäl samtal opt-out-calls

Processen declared ID respekterar besökarens inställningar för att avanmäla Audience Manager för din webbplats. När Audience Manager tar emot en avanmälningsbegäran innehåller JSON som returneras av DCS felkoden 171, med meddelandet Encountered opt out tag, i stället för användar-ID:t Audience Manager.

Mer information om att avanmäla dig från datainsamling finns i Dataintegritet.

Exempel på Declared ID avanmälan opt-out-examples

Du kan göra en declared ID-avanmälningsbegäran med nyckelvärdepar d_cid och d_cid_ic. Gamla parametrar som d_dpid och d_dpuuid fungerar fortfarande, men betraktas som föråldrade. Se CID ersätter DPID och DPUUID. I exemplen visar kursiv stil platshållaren för en variabel.

Avanmäl dig med CID och CID_IC

En beskrivning och syntax finns i URL-variabler och syntax för deklarerade ID:n.

Avanmäl dig med DPID, DPUUID och UUID (borttaget)

Dessa metoder fungerar fortfarande men anses vara föråldrade. Denna information tillhandahålls för äldre syften och referens. Äldre avanmälningar inkluderar:

Variabler och syntax för Declared IDs variables-and-syntax

I följande tabell visas nyckelvärdepar som skickas i ditt Audience Manager-dataleverantörs-ID och användar-ID eller integreringskoder, om sådana används. Obs! kursiv anger en variabelplatshållare. Blanksteg har lagts till för att göra dem enklare att läsa.

I varje nyckelvärdepar:

Exempelhändelseanrop sample-event-calls

Med tanke på dessa nyckelvärdepar och deras obligatoriska syntax gör du händelseanrop enligt nedan.

Declared ID variabler declared-id-variables

Beskriver de konfigurationsvariabler som används för att skicka declared IDs till DIL till Audience Manager.

DIL använder Adobe Experience Platform Identity Service för att skicka Declared IDs dil-id-service-pass-declared-ids

När den används med Adobe Experience Platform Identity Service behöver du inte längre skicka in declared IDs med de inaktuella dpid- och dpuuid-variablerna. I stället förlitar sig de aktuella versionerna av DIL på funktionen visitorService för att hämta declared IDs från funktionen setCustomerIDs i Adobe Experience Platform Identity Service. Mer information finns i Kund-ID:n och autentiseringstillstånd. Du anropar visitorService i DIL.create enligt nedan.

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

I nyckelvärdepar namespace är MCORG ditt Experience Cloud-organisations-ID. Om du inte har det här ID:t kan du hitta det i Administration-avsnittet på Experience Cloud-instrumentpanelen. Du behöver administratörsbehörighet för att kunna visa den här instrumentpanelen. Se Administration: bastjänster.

Föråldrade funktioner deprecated-functions

Med de senaste versionerna av DIL (6.2+) behöver du inte använda dessa nyckelvärdepar för att skicka in declared IDs. Det beror på att DIL nu förlitar sig på funktionen visitorService som visas i kodexemplet ovan. Den här funktionen hämtar declared IDs från Adobe Experience Platform Identity Service. Men vi refererar till dessa variabler här av historiska och äldre skäl. I koden nedan finns ett exempel på hur du konfigurerar DIL.create för att hämta en declared ID från Visitor ID Service.
I följande tabell beskrivs de äldre variablerna som används av objektet declaredId:

DPID och DPUUID

Audience Manager jämför och matchar den kombinerade DPID och DPUUID med ett motsvarande användar-ID i vårt system. Om ett ID inte finns skapar Audience Manager ett nytt användar-ID och synkroniserar det med kombinationen DPID/DPUUID. När Audience Manager matchar eller skapar ett användar-ID (UUID) returnerar det ID:t i JSON-svaret på cookie i klientens domän (förstapartsserver cookie) eller annan lokal lagring.

Anropa den här funktionen när du använder DIL v6.1 eller tidigare. Den här funktionen har ersatts med den nya versionen som får declared IDs från Adobe Experience Platform Identity Service.

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

Skicka ID:n efter DIL instanser

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

Exempel på begäran/svar request-response-examples

Begäran skickar en DataProvider och ett användar-ID till Audience Manager:

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

Svaret returnerar Audience Manager-ID (t.ex. UUID) som är skrivet till en cookie för första part i siddomänen.

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

Anrop för inte mål och avanmäl do-not-target

Processen declared ID respekterar besökarens inställningar för att avanmäla Audience Manager för din webbplats. När Audience Manager tar emot en avanmälningsbegäran returnerar DCS ett tomt JSON-objekt i stället för användar-ID:t Audience Manager.