Puoi visualizzare in anteprima le campagne e le varianti delle tue esperienze di personalizzazione delle app esattamente come vengono visualizzate dagli utenti delle app. 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 la qualità del codice e l'aspetto della variante.
- Anteprima di una campagna: consente di visualizzare la campagna esattamente come la vedrebbe un visitatore nell'app. Vedrai la campagna solo se soddisfi le condizioni di targeting e le impostazioni della frequenza. L'esperienza offerta sarà quella con la priorità più alta (a cui sei destinato) e ti verranno offerte delle varianti in base all'allocazione. Poiché sono incluse le bozze, puoi eseguire il controllo qualità delle esperienze e delle campagne prima di offrirle ai tuoi visitatori.
Anteprima delle varianti e delle campagne
1. Seleziona ciò di cui desideri vedere l'anteprima.
-
Per visualizzare l'anteprima di una variante: durante la creazione o la modifica della variante, fai clic suEsegui anteprima app. Puoi visualizzare l'anteprima delle varianti anche se non sono state salvate.
-
Puoi visualizzare l'anteprima di una campagna: passa con il mouse sulla campagna API di cui desideri visualizzare l'anteprima, quindi fai clic sull'icona Anteprima
.
Viene visualizzata la finestra di dialogo di anteprima.
2. Configura e visualizza l'anteprima:
- Nel campo Anteprima attiva, inserisci il deep link alla tua app, nel punto in cui desideri iniettare il codice della variante. Tieni presente che, ogni volta che il link viene modificato, viene creato un nuovo codice QR.
- Esegui la scansione del codice QR con qualsiasi dispositivo che disponga di fotocamera e su cui è installata la tua app. Il codice QR ti reindirizzerà alla posizione nell'app insieme al token di anteprima della campagna, e verrà visualizzata la variante.
Facoltativamente:
- puoi inviare una e-mail con l'URL di anteprima ad altri revisori.
- Fai clic su Copia URL per salvarlo o visualizzarlo senza il codice QR.
Nota:
- Quando visualizzi l'anteprima di una campagna, vengono considerate tutte le condizioni di targeting prima di proporla.
- Le anteprime delle varianti rappresentano un'istantanea del codice di tali varianti nel momento della generazione dei link di anteprima.
- I link rimangono attivi per 45 giorni.
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 dyApiPreview=[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"]
“preview”: {
"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 previewID non 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 parametro "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.