DocumentationGuide du développeur de Target

Identification des visiteurs

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Il existe plusieurs façons d’identifier un visiteur dans Adobe Target.

Target utilise trois identifiants :

Nom du champ
Description
tntId
tntId est l’identifiant principal d’un utilisateur dans Target. Vous pouvez fournir cet identifiant ou Target le génèrera automatiquement si la requête ne en contient pas.
thirdPartyId
thirdPartyId est l’identifiant de votre société pour l’utilisateur que vous pouvez envoyer avec chaque appel . Lorsqu’un utilisateur se connecte au site d’une entreprise, celle-ci crée généralement un identifiant lié au compte du visiteur, à sa carte de fidélité, à son numéro de membre ou à tout autre identifiant applicable de l’entreprise.
marketingCloudVisitorId
marketingCloudVisitorId est utilisé pour fusionner et partager des données entre différentes solutions d’Adobe. marketingCloudVisitorId est requis pour les intégrations avec Adobe Analytics et Adobe Audience Manager.
customerIds
Outre l’identifiant visiteur Experience Cloud, d’autres identifiants de client et un état authentifié pour chaque visiteur peuvent être utilisés.

Target ID

L’ Target ID ou tntId peut être considéré comme un ID d’appareil. Cet tntId est généré automatiquement par Target s’il n’est pas fourni dans la requête. Par la suite, les demandes suivantes doivent inclure cet tntId pour que le contenu approprié soit diffusé sur un appareil utilisé par l’utilisateur.

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

L’exemple d’appel ci-dessus montre qu’un tntId n’a pas besoin d’être transmis. Dans ce scénario, Target génère un tntId et le fournit dans la réponse, comme illustré ici :

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

Le tntId généré est 10abf6304b2714215b1fd39a870f01afc.28_20. Veuillez noter que cet tntId doit être utilisé lors de l’appel de Adobe Target Delivery API pour le même utilisateur entre les sessions.

Identifiant visiteur Marketing Cloud

marketingCloudVisitorId est un identifiant universel et permanent qui identifie vos visiteurs dans toutes les solutions de l’Experience Cloud. Lorsque votre organisation met en oeuvre le service d’ID, cet ID vous permet d’identifier un même visiteur du site et ses données dans différentes solutions Experience Cloud telles qu’Adobe Target, Adobe Analytics ou Adobe Audience Manager. Veuillez noter que le marketingCloudVisitorId est requis lors de l’utilisation et de l’intégration avec Analytics et 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
      }
    ]
  }
}'

L’exemple d’appel ci-dessus montre comment un marketingCloudVisitorId récupéré du service d’ID Experience Cloud est transmis à Adobe Target. Dans ce scénario, Target génère un tntId puisqu’il n’a pas été transmis à l’appel d’origine qui sera mappé au marketingCloudVisitorId fourni, comme illustré dans la réponse ci-dessous.

ID tiers

Si votre organisation utilise un identifiant pour identifier votre visiteur, vous pouvez utiliser thirdPartyID pour diffuser du contenu. Cependant, vous devez fournir le thirdPartyID pour chaque appel Adobe Target Delivery API que vous effectuez.

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

L’exemple d’appel ci-dessus montre un thirdPartyId, qui est un identifiant persistant utilisé par votre entreprise pour identifier un utilisateur final, qu’il interagisse avec votre entreprise à partir de canaux web, mobiles ou IoT. En d’autres termes, le thirdPartyId référencera les données de profil utilisateur qui peuvent être utilisées sur plusieurs canaux. Dans ce scénario, Target génère un tntId, puisqu’il n’a pas été transmis à l’appel d’origine, qui sera mappé au thirdPartyId fourni, comme illustré dans la réponse ci-dessous.

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

Customer ID

Les ID de client peuvent être ajoutés et associés à un ID de visiteur Experience Cloud. Chaque fois que vous envoyez customerIds, le marketingCloudVisitorId doit également être fourni. De plus, un état d’authentification peut être fourni avec chaque customerId pour chaque visiteur. L’état d’authentification suivant peut être pris en compte :

État d’authentification
État d’utilisateur
unknown
Inconnu ou jamais authentifié. Cet état peut être utilisé pour des scénarios tels qu’un visiteur qui a accédé à votre site en cliquant sur une annonce publicitaire.
authenticated
L’utilisateur est actuellement authentifié dans une session active sur votre site web ou votre application.
logged_out
L’utilisateur était authentifié, mais actuellement déconnecté. Celui-ci a eu l’intention de se déconnecter de l’état d’authentification. Il ne souhaite plus être considéré comme authentifié.

Notez que seule la présence de l’ID de client dans l’état authenticated permettra à Target de référencer les données de profil utilisateur stockées et liées à l’ID de client. Si l’ID de client est à l’état unknown ou logged_out, il sera ignoré et les données de profil utilisateur qui peuvent y être associées ne seront pas utilisées pour le ciblage des audiences.

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

L’exemple d’appel ci-dessus montre comment envoyer un customerId avec un authenticatedState. Lors de l'envoi d'un customerId, les integrationCode, id et authenticatedState ainsi que les marketingCloudVisitorId sont requis. integrationCode est l’alias du fichier d’attributs du client que vous avez fourni via CRS.

Profil fusionné

Vous pouvez combiner tntId, thirdPartyID et marketingCloudVisitorId dans la même requête. Dans ce scénario, Adobe Target conserve le mappage de tous ces identifiants et les épingle à un visiteur. Découvrez comment les profils sont fusionnés et synchronisés en temps réel à l’aide des différents identifiants.

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

L’exemple d’appel ci-dessus montre comment combiner tntId, thirdPartyID et marketingCloudVisitorId dans la même requête. Les trois identifiants sont également renvoyés dans la réponse.

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