Prévisualisation des Campagnes API pour la personnalisation d'application

Prévisualisation des variations

1. Sélectionnez ce que vous souhaitez prévisualiser.

• Pour prévisualiser une variation : lors de la création ou de la modification. variation, cliquez sur Preview in app (Prévisualer sur l'application). Vous pouvez prévisualiser les variations même si elles n'ont pas été enregistrées. 
  
• Pour prévisualiser une campagne : survolez la campagne API que vous souhaitez prévisualiser, puis cliquez sur l'icône de  prévisualisation. 
  

La boîte de dialogue de la prévisualisation apparaît.

2. Paramétrer et afficher un aperçu : 

1. Dans le champPreview on (Prévisualisation activée)entrez le lien direct vers votre application, où vous souhaitez injecter le code de la variation. Notez que chaque fois le lien est modifié, un nouveau code QR est généré.
2. Scannez le QR avec n'importe quel appareil équipé d'une camera et de votre application installée. Le code QR vous dirige vers l'emplacement dans votre application avec le token de prévisualisation de la campagne et la variante est affichée.

Optionnellement :

1. Envoie un e-mail contenant l'URL de prévisualisation aux autres évaluateurs.
2. Cliquez sur Copy URL (Copier l'URL) pour pour l'enregistrer ou pour l'afficher sans le code QR.

Remarques :

• Lorsque vous affichez l'aperçu d'une campagne, toutes les conditions de ciblage sont prises en compte avant de la diffuser.
• La prévisualisation de la variation représente un instantané du code de la variation au moment de la génération des liens de la Prévisualisation.
• Les liens restent actifs pendant 45 jours.

Activation du mode de prévisualisation

Pour prévisualiser les campagnes d'API, votre application doit demander le mode de prévisualisation. Il s'agit d'une modification ponctuelle apportée par votre développeur. Ensuite, la prévisualisation des variations et des campagnes ne nécessite plus aucun effort de développement.

Lorsque vous cliquez sur Preview (Prévisualisation) pour une campagne ou une variation de la console Experience OS, le site Web s'ouvre avec le paramètre d'URL dyApiPreview=[token]. Par exemple : 
http://acme.com/dyApiPreview=5f30be92-dbd3-4053-904b-f83cd885574b

En tant que développeur, ajoutez la logique suivante : si le paramètre d'URL dyAPIPreview existe dans l'URL actuelle, incluez le token de prévisualisation dans la demande d'API sous le preview.ids[].

{ 
"user": {"dyid": "1679843083476146043", 
“dyid_server”: "1679843083476146043" }, 
"session":{"dy": "a2719b4d6c4709128bf5f57a3bf3"}, 
"selector": { 
  "names": ["PDP Top Banner", "PDP Recs"],
  “preview”: {
  "ids": [“PREVIEW TOKEN”] // C'est ici que vous injectez le token d'aperçu à partir du paramètre d'URL
  }
  },
"context": { 
  "page": { "type":"HOMEPAGE", "location":"https://shop.biz/", "locale":"en_US" 
  }, 
  "device": { "userAgent":"Mozilla/5.0 (X11; Linux x86_64) Chrome/56.0.29", "ip":"54.100.200.255"} 
}, 
} 

{
"cookies": [ 
  {"name": "_dyid_server", "value": "16798430146043", "maxAge": "63072000"},
      {"name": "_dyjsession", "value": "a2719b4d6c470383f1bf3", "maxAge": "63072000"}
  ],
  "choices": [
  "id": 5,
  "name": "Bannière principale de la page d'accueil",
  "type": "DECISION",
  "decisionId": "aGVsbG8K",
  "isPreview": true,
  "variations": [
  {
  "id": 52,
  "payload": {
... 
"type": "CUSTOM_JSON",
"data": {
  "key1": "value1",
  "key2": "value2"
}

{
  "user": { "id": "yaexono4ohphania" },
  "session": { "custom": "iquahngaishe2koh" },
  "selector": { 
     "names": ["PDP Top Banner", "PDP Recs"],
     “preview”: {
        "ids": [“PREVIEW TOKEN”] // C'est ici que vous injectez le token de prévisualisation depuis le paramètre d'URL
     }
   },
   "context": { 
     // Le contexte habituel...
   }
}

{
  "choices": [
  {
  "id": 551993,
  "name": "Bannière supérieure HP",
  "type": "DECISION",
  "variations": [
  {
  "id": 25863143,
  
"payload": {  "type": "CUSTOM_JSON",
  "data": {
  "image": "http://lorempixel.com/400/200/",
  "title": "Restez au top",
  "subtitle": "Donnez le ton de l'élégance",
  "cta": "Acheter maintenant",
  "link": ""
  }
  }
  }
  ],
  "decisionId": "l7QtNTg5MTkwODkyNDA4MTM1NDM3Oc4AEHLBpzk5MzA1ODQBkJHOAYqj56UzNjQzOQ=="
  }
  ],
  "isPreviewMode": true
}}

Remarques

• La portée du token de prévisualisation s'applique à l'ensemble de la demande. Cela signifie qu'il « activera » tous les projets d'expériences des campagnes. Si vous souhaitez prévisualiser les projets à partir d'une seule campagne, séparez les demandes.
• Les tokens de prévisualisation expirent au bout de deux semaines.
• Un nouveau token de prévisualisation est généré à chaque fois que Preview (Prévisualisation) est cliqué.
• Lorsque vous demandez le mode de prévisualisation pour plusieurs campagnes, vous obtiendrez la meilleure option (en fonction du ciblage auquel vous correspondez) de toutes les campagnes en cours d'exécution et à l'état de projet.
• Si vous envoyez un token de prévisualisation non valide, vous recevrez un avertissement : La demande contient un PreviewID non valide
• Si vous envoyez une demande sans token de prévisualisation (c'est-à-dire un appel de production en direct), seules les expériences en statut actif sont prises en compte. Les campagnes qui incluent uniquement des expériences à l'état de projet ou mises en pause renverront des choix vides.
• Vous pouvez inclure plusieurs tokens d'aperçu dans un seul appel en les séparant avec une virgule. Ceci est utile si vous souhaitez prévisualiser plusieurs variations provenant de différentes campagnes en même temps. Si vous incluez plusieurs tokens, les tokens permettant de prévisualiser une variation ont la priorité sur ceux permettant de prévisualiser une campagne. 
• Notez la différence entre les tokens de prévisualisation au niveau des campagnes et ceux au niveau des variations : Un token de prévisualisation au niveau des campagnes renvoie le paramètre "isPreviewMode": true à la fin de la réponse, ce qui a pour effet que toutes les campagnes renvoyées sont affichées en mode prévisualisation.
  Un token de prévisualisation au niveau des variations renvoie le paramètre "isPreview": true dans le paramètre "choices" de chaque variation séparément, si le token correspond à une variation.