Questo articolo spiega come visualizzare in anteprima le campagne API lato server. Per visualizzare l'anteprima delle campagne di personalizzazione del sito (come Sovrapposizione o Contenuto dinamico), consulta la sezione Anteprima delle campagne di personalizzazione basate su script.
Puoi visualizzare in anteprima le campagne e le varianti delle esperienze di personalizzazione del tuo sito come se fossero pubblicati sul tuo sito. Esistono due modi per visualizzare l'anteprima che ti aiutano a testare e visualizzare tutti gli aspetti delle tue campagne:
- Anteprima di una variante: consente di visualizzare una variante, indipendentemente dal fatto di rispettare eventuali condizioni di targeting. In questa modalità, il codice della variante viene semplicemente iniettato nella pagina. Ciò è utile per controllare il codice e l'aspetto della variante.
- Anteprima di una campagna: consente di visualizzare la campagna esattamente come la vedrebbe un visitatore sul tuo sito. Ciò significa che vedrai la campagna solo se soddisfi le condizioni di targeting e le impostazioni della frequenza. Vedrai l'esperienza con la priorità più alta (a cui sei destinato) e ti verranno offerte delle varianti in base all'allocazione. Poiché sono incluee le bozze, puoi eseguire il controllo qualità delle esperienze e delle campagne prima di offrirle ai tuoi visitatori.
Anteprima delle varianti
Puoi visualizzare l'anteprima delle varianti anche se non sono state salvate.
- Durante la modifica o la creazione di una variante, fai clic su Anteprima sul sito.
- Inserisci l'URL del sito su cui desideri visualizzare l'anteprima della variante.
Si apre una nuova scheda che mostra l'anteprima.
Tieni presente che la variante viene visualizzata indipendentemente dal fatto che tu corrisponda o meno alle condizioni di targeting dell'esperienza. Tuttavia, le condizioni che attivano la campagna devono essere soddisfatte (ad esempio, una sovrapposizione che viene attivata dopo 30 secondi). Se la condizione di attivazione non viene soddisfatta, viene visualizzato un messaggio che spiega perché la variazione non è stata pubblicata.
Anteprima delle campagne
- Passa il mouse sulla campagna API di cui desideri visualizzare l'anteprima, quindi fai clic sull'icona Anteprima
.
- Effettua una delle seguenti operazioni:
- inserisci l'URL dell'anteprima (se non è già presente) e fai clic su Anteprima. La pagina si apre in modalità anteprima.
- Invia tramite e-mail l'URL dell'anteprima ai tuoi colleghi in modo che possano visualizzare l'anteprima della campagna senza accedere alla console Experience OS.
Nota: le anteprime delle varianti rappresentano un'istantanea del codice della variante nel momento in cui viene generato il link di anteprima. I link rimangono attivi per 45 giorni.
Tieni presente che quando visualizzi l'anteprima di una campagna, tutti i targeting, i trigger e la frequenza vengono presi in considerazione prima di proporla.
La modalità di anteprima rimane attiva fino alla chiusura della scheda.
Attivazione della modalità di anteprima
Per visualizzare l'anteprima delle campagne API, l'applicazione deve richiedere la modalità di anteprima. Questa modifica viene apportata una sola volta dallo sviluppatore. Successivamente, l'anteprima delle varianti e delle campagne non richiede più alcun impegno di sviluppo.
Quando fai clic su Anteprima per una campagna o una variante nella console di Experience OS, si apre il sito Web con il parametro URL Anteprima DYAPI =[token]. Ad esempio:
http://acme.com/dyApiPreview=5f30be92-dbd3-4053-904b-f83cd885574b
Come sviluppatore, aggiungi la logica: se il parametro URL dyApiPreview esiste nell'URL corrente, includi il token di anteprima nella richiesta API sotto i preview.ids[].
{
"user": {"dyid": "1679843083476146043",
“dyid_server”: "1679843083476146043" },
"session":{"dy": "a2719b4d6c4709128bf5f57a3bf3"},
"selector": {
"names": [["PDP Top Banner", "PDP Recs"]
Anteprima.
"ids": [“PREVIEW TOKEN”] //Qui è dove devi inserire il token di anteprima dal parametro 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": "Homepage Banner Main",
"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”] // Qui è dove devi inserire il token di anteprima dal parametro URL
}
},
"context": {
// Il classico contesto...
}
}{
"choices": [
{
"id": 551993,
"name": "HP Top Banner",
"type": "DECISION",
"variations": [
{
"id": 25863143,
"payload": {
"type": "CUSTOM_JSON",
"data": { "image": "http://lorempixel.com/400/200/",
"title": "Stay Sharp",
"subtitle": "Set the tone of elegance",
"cta": "Buy Now",
"link": ""
}
}
}
], "decisionId": "l7QtNTg5MTkwODkyNDA4MTM1NDM3Oc4AEHLBpzk5MzA1ODQBkJHOAYqj56UzNjQzOQ=="
}
], "isPreviewMode": true
}}Note
- L'ambito del token di anteprima è per l'intera richiesta. Il che significa che "abiliterà" tutte le bozze di esperienze nelle campagne. Se desideri visualizzare l'anteprima delle bozze di una singola campagna, separa le richieste.
- I token di anteprima scadono dopo 2 settimane.
- Un nuovo token di anteprima viene generato ogni volta che fai clic su Anteprima .
- Se richiedi la modalità di anteprima per più campagne, otterrai l'opzione migliore (in base al targeting da te abbinato) tra tutte le campagne live e in bozza.
- Se invii un token di anteprima non valido, riceverai il seguente avviso: La richiesta contiene un previewIDnon valido
- Se invii una richiesta senza token di anteprima (ovvero una chiamata in produzione dal vivo) ), vengono prese in considerazione solo le esperienze con stato attivo. Le campagne che includono solo esperienze in bozza o in pausa restituiranno selezioni vuote.
- Puoi includere più token di anteprima in una singola chiamata separando i token con una virgola. Ciò è utile se desideri visualizzare l'anteprima di più varianti di diverse campagne contemporaneamente. Se includi token multipli, i token per l'anteprima di una variante hanno la precedenza sui token per l'anteprima di una campagna.
-
C'è una differenza tra i token di anteprima a livello di campagna e i token a livello di variante: un token di anteprima a livello di campagna restituisce il parametrU "isPreviewMode": true alla fine della risposta, il che fa sì che tutte le campagne restituite vengano visualizzate in modalità di anteprima.Un token di anteprima a livello di variante restituisce il parametro "isPreview": true all'interno del parametro "choices" di ciascuna variante separatamente, se il token corrisponde a una variante.