Identifiera besökare

En besökare kan identifieras på flera olika sätt Adobe Target.

Målet använder tre identifierare:

Fältnamn
Beskrivning
tntId
The tntId är den primära identifieraren i Target för en användare. Du kan ange detta ID eller Target genererar den automatiskt om begäran inte innehåller någon.
thirdPartyId
The thirdPartyId är företagets identifierare för användaren som du kan skicka med varje samtal. När en användare loggar in på ett företags webbplats skapar företaget vanligtvis ett ID som är knutet till besökarens konto, förmånskort, medlemsnummer eller andra tillämpliga identifierare för det företaget.
marketingCloudVisitorId
The marketingCloudVisitorId används för att sammanfoga och dela data mellan olika Adobe-lösningar. The marketingCloudVisitorId krävs för integreringar med Adobe Analytics och Adobe Audience Manager.
customerIds
Tillsammans med besökar-ID:t för Experience Cloud kan ytterligare kund-ID och en autentiserad status för varje besökare kan användas.

Target ID

The Target ID eller tntId kan ses som ett enhets-ID. Detta tntId genereras automatiskt av Target om det inte anges i begäran. Därefter måste efterföljande förfrågningar innehålla detta tntId för att rätt innehåll ska kunna levereras till en enhet som används av användaren.

curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
  "context": {
    "channel": "web",
    "browser" : {
      "host" : "demo"
    },
    "address" : {
      "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
    },
    "screen" : {
      "width" : 1200,
      "height": 1400
    }
  },
    "execute": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      }
    ]
  }
}'

Exempelanropet ovan visar att en tntId behöver inte skickas in. I detta scenario Target genererar ett tntId och tillhandahålla det i svaret, vilket visas här:

{
  "status": 200,
  "requestId": "5b586f83-890c-46ae-93a2-610b1caa43ef",
  "client": "demo",
  "id": {
      "tntId": "10abf6304b2714215b1fd39a870f01afc.28_20"
  },
  "edgeHost": "mboxedge28.tt.omtrdc.net",
  ...
}

Den genererade tntId är 10abf6304b2714215b1fd39a870f01afc.28_20. Observera detta tntId måste användas när du anropar Adobe Target Delivery API för samma användare mellan sessioner.

Marketing Cloud Visitor-ID

The marketingCloudVisitorId är ett universellt och beständigt ID som identifierar besökarna i alla lösningar i Experience Cloud. När din organisation implementerar ID-tjänsten kan du med detta ID identifiera samma besökare och deras data i olika Experience Cloud-lösningar som Adobe Target, Adobe Analytics eller Adobe Audience Manager. Observera att marketingCloudVisitorId krävs för att utnyttja och integrera med Analytics och Audience Manager.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#1555632114' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
  "id": {
    "marketingCloudVisitorId": "10527837386392355901041112038610706884"
  },
  "context": {
    "channel": "web",
    "browser" : {
      "host" : "demo"
    },
    "address" : {
      "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
    },
    "screen" : {
      "width" : 1200,
      "height": 1400
    }
  },
    "execute": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      }
    ]
  }
}'

Exemplanropet ovan visar hur en marketingCloudVisitorId som hämtades från Experience Cloud ID-tjänsten skickas till Adobe Target. I detta scenario Target genererar ett tntId eftersom det inte skickades till det ursprungliga anropet som mappas till det angivna marketingCloudVisitorId som framgår av svaret nedan.

Tredjeparts-ID

Om din organisation använder ett ID för att identifiera besökaren kan du använda thirdPartyID för att leverera innehåll. Du måste dock ange thirdPartyID för varje Adobe Target Delivery API ring dig.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#1555632114' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
  "id": {
    "thirdPartyId": "B234A029348"
  },
  "context": {
    "channel": "web",
    "browser" : {
      "host" : "demo"
    },
    "address" : {
      "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
    },
    "screen" : {
      "width" : 1200,
      "height": 1400
    }
  },
    "execute": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      }
    ]
  }
}'

Exemplanropet ovan visar en thirdPartyId, som är ett beständigt ID som används i ditt företag för att identifiera en slutanvändare oavsett om de interagerar med ditt företag via webb-, mobil- eller IoT-kanaler. Med andra ord thirdPartyId refererar till användarprofildata som kan användas i alla kanaler. I detta scenario Target genererar ett tntIdeftersom det inte skickades till det ursprungliga anropet, som mappas till det angivna thirdPartyId som framgår av svaret nedan.

{
    "status": 200,
    "requestId": "55de9886-bd14-4dee-819c-7d1633b79b90",
    "client": "demo",
    "id": {
        "tntId": "10abf6304b2714215b1fd39a870f01afc.28_20",
        "thirdPartyId": "B234A029348"
    },
    "edgeHost": "mboxedge28.tt.omtrdc.net",
    ...
}

Kund-ID

Kund-ID kan läggas till och kopplas till ett Experience Cloud Visitor-ID. Vid sändning customerIds den marketingCloudVisitorId måste också anges. Dessutom kan en autentiseringsstatus anges tillsammans med varje customerId för varje besökare. Följande autentiseringsstatus kan beaktas:

Autentiseringsstatus
Användarstatus
unknown
Okänd eller aldrig autentiserad. Det här läget kan användas för scenarier som en besökare som har landat på din plats genom att klicka på ett visningsmeddelande.
authenticated
Användaren autentiseras för närvarande med en aktiv session på din webbplats eller i din app.
logged_out
Användaren autentiserades men loggades aktivt ut. Användaren avsåg att koppla från det autentiserade tillståndet. Användaren vill inte längre behandlas som autentiserad.

Observera att endast när kund-ID:t finns i authenticated kommer Target att referera till användarprofildata som lagras och länkas till kund-ID:t. Om kund-ID:t finns i unknown eller logged_out status, kund-ID:t ignoreras och alla användarprofildata som kan kopplas till det utnyttjas inte för målgruppsanpassning.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359234570e044f14e1faeeba02d6ab23439914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "context": {
        "channel": "web",
        "browser" : {
          "host" : "demo"
        },
        "address" : {
          "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
        },
        "screen" : {
          "width" : 1200,
          "height": 1400
        }
      },
      "id": {
        "marketingCloudVisitorId" : "2304820394812039",
        "customerIds": [{
          "id": "134325423",
          "integrationCode" : "crm_data",
          "authenticatedState" : "authenticated"
        }]
      },
      "property" : {
        "token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

Exemplanropet ovan visar hur du skickar en customerId med authenticatedState. När en customerId, integrationCode, idoch authenticatedState och marketingCloudVisitorId krävs. The integrationCode är alias för kundattributfil du tillhandahöll via CRS.

Sammanfogad profil

Du kan kombinera tntId, thirdPartyIDoch marketingCloudVisitorId i samma begäran. I det här scenariot behåller Adobe Target mappningen av alla dessa ID:n och fäster den vid en besökare. Läs om hur profiler sammanfogade och synkroniserade i realtid med olika identifierare.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359234570e044f14e1faeeba02d6ab23439914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "context": {
        "channel": "web",
        "browser" : {
          "host" : "demo"
        },
        "address" : {
          "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
        },
        "screen" : {
          "width" : 1200,
          "height": 1400
        }
      },
      "id": {
        "marketingCloudVisitorId" : "2304820394812039",
        "tntId": "d359234570e044f14e1faeeba02d6ab23439914e.28_78",
        "thirdPartyId":"23423432"
      },
      "property" : {
        "token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
      },
      "experienceCloud": {
        "analytics": {
          "supplementalDataId" : "23423498732598234",
          "trackingServer": "ags041.sc.omtrdc.net",
          "logging": "server_side"
        }
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

Exempelanropet ovan visar hur du kan kombinera tntId, thirdPartyIDoch marketingCloudVisitorId i samma begäran. Alla tre ID:n returneras också i svaret.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3