Segments AAM
Adobe Audience Manager segments peuvent être utilisés par le biais de Adobe Target SDK. Pour exploiter les segments d’AAM, les champs suivants doivent être fournis :
locationHint
marketingCloudVisitorId
blob
Le SDK renseigne automatiquement ces champs lors d’un appel de méthode getOffers
, mais vous devez vous assurer qu’un cookie visiteur valide est fourni. Pour obtenir ce cookie, vous devez implémenter VisitorAPI.js dans le navigateur.
Guide de mise en œuvre
Utilisation des cookies
Les cookies sont utilisés pour corréler des requêtes Adobe Audience Manager avec des requêtes Adobe Target. Il s’agit des cookies utilisés dans cette implémentation.
AMCVS_XXXXXXXXXXXXXXXXXXXXXXXX%40AdobeOrg
VisitorAPI.js
lorsqu’il est initialisé avec visitorState
à partir de la réponse getOffers
cible.mbox
targetCookie
de la réponse getOffers
cible.Présentation des étapes
Supposons qu’un utilisateur saisisse une URL dans un navigateur qui envoie une demande à votre serveur web. Lorsque vous effectuez cette requête :
-
Le serveur lit le visiteur et cible les cookies de la requête.
-
Le serveur effectue un appel à la méthode
getOffers
du SDK Target, en spécifiant les cookies de visiteur et de cible s’ils sont disponibles. -
Lorsque l’appel
getOffers
est rempli, les valeurs detargetCookie
etvisitorState
de la réponse sont utilisées.- Un cookie est défini sur la réponse avec des valeurs issues de
targetCookie
. Pour ce faire, utilisez l’en-tête de réponseSet-Cookie
, qui indique au navigateur de conserver le cookie cible. - Une réponse HTML est préparée qui initialise
VisitorAPI.js
et transmetvisitorState
à partir de la réponse cible.
- Un cookie est défini sur la réponse avec des valeurs issues de
-
La réponse HTML est chargée dans le navigateur…
VisitorAPI.js
est inclus dans l’en-tête du document.- VisitorAPI est initialisé avec
visitorState
à partir de la réponse du SDKgetOffers
. Le cookie visiteur est alors défini dans le navigateur, de sorte qu’il soit envoyé au serveur lors des demandes ultérieures.
Exemple de code
L’exemple de code suivant met en oeuvre chacune des étapes décrites ci-dessus. Chaque étape apparaît dans le code sous la forme d’un commentaire intégré en regard de son implémentation.
Node.js
Cet exemple repose sur express, un framework web Node.js.
code language-js line-numbers |
---|
|
code language-html line-numbers |
---|
|
Java
Cet exemple utilise printemps, un framework web Java.
code language-java line-numbers |
---|
|
code language-java line-numbers |
---|
|
code language-java line-numbers |
---|
|
code language-java line-numbers |
---|
|
Pour plus d’informations sur TargetRequestUtils.java
, voir Méthodes d’utilitaire (Java)