DocumentazioneTargetGuida per gli sviluppatori di Target

Identificazione dei visitatori

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Un visitatore può essere identificato in più modi in Adobe Target.

Target utilizza tre identificatori:

Nome campo
Descrizione
tntId
tntId è l'identificatore primario in Target per un utente. È possibile specificare questo ID oppure Target lo genererà automaticamente se la richiesta non ne contiene uno.
thirdPartyId
thirdPartyId è l'identificatore della tua azienda per l'utente che puoi inviare con ogni chiamata. Quando un utente accede al sito di un’azienda, l’azienda in genere crea un ID associato all’account del visitatore, alla carta fedeltà, al numero di iscrizione o ad altri identificatori applicabili per l’azienda.
marketingCloudVisitorId
marketingCloudVisitorId viene utilizzato per unire e condividere dati tra diverse soluzioni Adobe. marketingCloudVisitorId è richiesto per le integrazioni con Adobe Analytics e Adobe Audience Manager.
customerIds
Oltre all'ID visitatore Experience Cloud, è possibile utilizzare altri ID cliente e uno stato di autenticazione per ogni visitatore.

ID Target

L'ID Target o tntId può essere visto come un ID dispositivo. tntId viene generato automaticamente da Target se non viene fornito nella richiesta. In seguito, le richieste successive devono includere tntId per consentire la distribuzione del contenuto corretto a un dispositivo utilizzato dall'utente.

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
      }
    ]
  }
}'

La chiamata di esempio precedente dimostra che non è necessario passare tntId. In questo scenario, Target genera un tntId e lo fornisce nella risposta, come illustrato di seguito:

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

tntId generato è 10abf6304b2714215b1fd39a870f01afc.28_20. Nota: tntId deve essere utilizzato quando si chiama Adobe Target Delivery API per lo stesso utente in più sessioni.

ID visitatore di Marketing Cloud

marketingCloudVisitorId è un ID universale e costante che identifica i visitatori in tutte le soluzioni dell'Experience Cloud. Quando la tua organizzazione implementa il servizio ID, questo ID ti consente di identificare lo stesso visitatore del sito e i relativi dati in diverse soluzioni di Experience Cloud come Adobe Target, Adobe Analytics o Adobe Audience Manager. Tieni presente che marketingCloudVisitorId è richiesto per l'utilizzo e l'integrazione con Analytics e 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
      }
    ]
  }
}'

La chiamata di esempio precedente illustra come un marketingCloudVisitorId recuperato dal servizio ID Experience Cloud viene passato ad Adobe Target. In questo scenario, Target genera un tntId poiché non è stato passato alla chiamata originale che verrà mappato al marketingCloudVisitorId fornito come mostrato nella risposta seguente.

ID di terze parti

Se l'organizzazione utilizza un ID per identificare il visitatore, è possibile utilizzare thirdPartyID per distribuire il contenuto. È tuttavia necessario fornire thirdPartyID per ogni chiamata Adobe Target Delivery API effettuata.

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
      }
    ]
  }
}'

La chiamata di esempio precedente mostra un thirdPartyId, che è un ID persistente utilizzato dalla tua azienda per identificare un utente finale indipendentemente dal fatto che interagisca con la tua azienda dai canali web, mobili o IoT. In altre parole, thirdPartyId farà riferimento ai dati del profilo utente che possono essere utilizzati in tutti i canali. In questo scenario, Target genera un tntId, poiché non è stato passato alla chiamata originale, che verrà mappato al thirdPartyId fornito come mostrato nella risposta seguente.

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

ID cliente

È possibile aggiungere ID cliente e associarli a un ID visitatore Experience Cloud. Ogni volta che invii customerIds devi fornire anche marketingCloudVisitorId. Inoltre, è possibile fornire uno stato di autenticazione insieme a ogni customerId per ogni visitatore. È possibile prendere in considerazione il seguente stato di autenticazione:

Stato di autenticazione
Stato dell'utente
unknown
Utente sconosciuto o mai autenticato. Questo stato può essere utilizzato per scenari come quello di un visitatore che è atterrato sul sito facendo clic su un annuncio pubblicitario.
authenticated
Al momento l'utente è autenticato con una sessione attiva sul sito Web o sull'app.
logged_out
L'utente si è autenticato ma si è disconnesso in modo attivo. L'utente desiderava disconnettersi dallo stato autenticato. L'utente non desidera più essere trattato come utente autenticato.

Tieni presente che solo quando l'ID cliente si trova nello stato authenticated, Target farà riferimento ai dati del profilo utente memorizzati e collegati all'ID cliente. Se l'ID cliente si trova nello stato unknown o logged_out, l'ID cliente verrà ignorato e tutti i dati del profilo utente associati ad esso non verranno utilizzati per il targeting del pubblico.

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
          }
        ]
      }
    }'

La chiamata di esempio precedente illustra come inviare customerId con authenticatedState. Quando si invia un customerId, sono necessari integrationCode, id e authenticatedState e marketingCloudVisitorId. integrationCode è l'alias del file degli attributi del cliente fornito tramite CRS.

Profilo unito

È possibile combinare tntId, thirdPartyID e marketingCloudVisitorId nella stessa richiesta. In questo scenario, Adobe Target manterrà la mappatura di tutti questi ID e la fisserà a un visitatore. Scopri come unire e sincronizzare in tempo reale i profili utilizzando i diversi identificatori.

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
          }
        ]
      }
    }'

La chiamata di esempio precedente illustra come combinare tntId, thirdPartyID e marketingCloudVisitorId nella stessa richiesta. Nella risposta vengono restituiti anche tutti e tre gli ID.

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