Besökaridentifiering via FPID

First-party IDs (FPIDs) är enhets-ID:n som genereras, hanteras och lagras av kunder. Detta ger kunderna kontroll över att identifiera användarenheter. Genom att skicka FPIDs genererar Edge Network inte en helt ny ECID för en begäran som inte innehåller någon.

FPID kan inkluderas i API-begärandetexten som en del av identityMap eller skickas som en cookie.

En FPID kan översättas till en ECID av Edge Network, vilket innebär att FPID-identiteter är helt kompatibla med Experience Cloud-lösningar. Att hämta ECID från en specifik FPID ger alltid samma resultat, så användarna får en konsekvent upplevelse.

ECID som hämtas på det här sättet kan hämtas via en identity.fetch-fråga:

{
   "query":{
      "identity":{
         "fetch":[
            "ECID"
         ]
      }
   }
}

För förfrågningar som innehåller både en FPID och en ECID har ECID som redan finns i begäran företräde framför den som kan genereras från FPID. Edge Network använder med andra ord ECID som redan angetts och FPID ignoreras. En ny ECID genereras bara när en FPID tillhandahålls separat.

När det gäller enhets-ID:n bör server-datastreams använda FPID som enhets-ID. Andra identiteter (t.ex. EMAIL) kan också anges i begärandetexten, men Edge Network kräver att en primär identitet anges explicit. Primär identitet är den grundläggande identitet som profildata ska lagras i.

Följande identityMap-fältgrupp är korrekt formaterad för en server-datastream-begäran:

{
   "identityMap":{
      "FPID":[
         {
            "id":"123e4567-e89b-12d3-a456-426614174000",
            "authenticatedState":"ambiguous",
            "primary":true
         }
      ],
      "EMAIL":[
         {
            "id":"email@mail.com",
            "authenticatedState":"authenticated"
         }
      ]
   }
}

Följande identityMap-fältgrupp kommer att resultera i ett felsvar när den anges för en server datastream-begäran:

{
   "identityMap":{
      "FPID":[
         {
            "id":"123e4567-e89b-12d3-a456-426614174000",
            "authenticatedState":"ambiguous"
         }
      ],
      "EMAIL":[
         {
            "id":"email@mail.com",
            "authenticatedState":"authenticated"
         }
      ]
   }
}

Felsvaret som returnerades av Edge Network i det här fallet liknar följande:

{
   "type":"https://ns.adobe.com/aep/errors/EXEG-0306-400",
   "status":400,
   "title":"No primary identity set in request (event)",
   "detail":"No primary identity found in the input event. Update the request accordingly to your schema and try again.",
   "report":{
      "requestId":"{REQUEST_ID}",
      "configId":"{CONFIG_ID}",
      "orgId":"{ORG_ID}"
   }
}

Besökaridentifiering med FPID

Om du vill identifiera användare via FPID måste du se till att FPID-cookien har skickats innan du skickar några begäranden till Edge Network. FPID kan skickas i en cookie eller som en del av identityMap i förfrågningens brödtext.

Begäran med FPID skickad som identityMap-fält

I exemplet nedan skickas FPID som en identityMap-parameter.

curl -X POST "https://server.adobedc.net/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "FPID": [
               {
                  "id": "e98f38e6-6183-442d-8cd2-0e384f4c8aa8",
                  "authenticatedState": "ambiguous",
                  "primary": true
               }
            ]
         },
         "web": {
            "webPageDetails": {
               "URL": "https://alloystore.dev"
            },
            "webReferrer": {
               "URL": ""
            }
         },
         "device": {
            "screenHeight": 1440,
            "screenWidth": 3440,
            "screenOrientation": "landscape"
         },
         "environment": {
            "type": "browser",
            "browserDetails": {
               "viewportWidth": 1907,
               "viewportHeight": 545
            }
         },
         "placeContext": {
            "localTime": "2022-03-21T21:32:59.991-06:00",
            "localTimezoneOffset": 360
         },
         "timestamp": "2022-03-22T03:32:59.992Z",
         "implementationDetails": {
            "name": "https://ns.adobe.com/experience/alloy/reactor",
            "version": "1.0",
            "environment": "serverapi"
         }
      }
   },
   "query": {
      "identity": {
         "fetch": [
            "ECID"
         ]
      }
   }
}'