In questa pagina: scopri come gli amministratori configurano le sfide della fedeltà, incluse le impostazioni globali, le impostazioni delle prestazioni, i provider di premi, le mappature degli eventi, l’inventario dei prodotti e le esclusioni.
Panoramica access-loyalty-admin
La configurazione delle sfide di fidelizzazione collega Journey Optimizer ai sistemi di fidelizzazione esterni impostando l’evasione dei premi, la mappatura degli eventi, l’inventario dei prodotti e le esclusioni prima che gli addetti al marketing creino le sfide.
Per aprire l’interfaccia di configurazione, seleziona il menu Configurazioni fedeltà dal menu di navigazione a sinistra. L’interfaccia è organizzata in schede:
- Impostazioni globali - Selezionare lo spazio dei nomi dell’identità Experience Platform per il programma. Scopri come configurare le impostazioni globali
- Impostazioni prestazioni - Seleziona il profilo fedeltà e i set di dati evento e il KPI di priorità per informazioni sulla fedeltà. Scopri come configurare le impostazioni delle prestazioni
- Provider di premi: collega le API che soddisfano i premi quando i clienti avanzano o completano le sfide. Scopri come configurare i provider di premi.
- Mappatura eventi — Mappa gli eventi esperienza in arrivo alle attività utilizzate nelle attività evento personalizzato. Scopri come configurare i mapping degli eventi.
- Inventario prodotti: carica i mapping da elemento a gruppo da utilizzare nelle regole di idoneità dell’attività. Scopri come configurare l’inventario dei prodotti
- Esclusioni: consente di caricare esclusioni di gruppi e elementi a livello di organizzazione per la configurazione dell’attività. Scopri come configurare le esclusioni
Impostazioni globali global-settings
Apri la scheda Impostazioni globali per configurare le impostazioni globali per le sfide di fedeltà.
-
Nella sezione Configurazione organizzazione, seleziona lo spazio dei nomi delle identità Adobe Experience Platform per le sfide di fidelizzazione. Questo spazio dei nomi deve corrispondere al modo in cui i profili dei membri vengono identificati nei dati.
Impostazioni delle prestazioni performance-settings
Apri la scheda Impostazioni prestazioni per selezionare i set di dati e la metrica di priorità utilizzati per approfondimenti sulle prestazioni fedeltà.
-
Nella sezione Configurazione delle prestazioni, seleziona il set di dati del profilo fedeltà contenente i dati del profilo del membro fedeltà. Lo schema del set di dati selezionato deve includere il gruppo di campi Dettagli fedeltà.
-
Seleziona il set di dati evento fedeltà contenente i dati dell’evento fedeltà. Lo schema del set di dati selezionato deve includere il gruppo di campi Dettagli evento fedeltà.
Lo schema del set di dati del profilo deve includere i gruppi di campi Dettagli fedeltà e IdentityMap, con le identità fornite in IdentityMap. Lo schema del set di dati dell’evento deve includere i gruppi di campi Dettagli evento fedeltà e Dettagli Commerce. È possibile includere altri gruppi di campi. Per informazioni generali sui dati e sui set di dati fedeltà, consulta Dati e set di dati fedeltà.
-
In Indicatore prestazioni chiave, seleziona la metrica di priorità della tua organizzazione per il dashboard Approfondimenti fedeltà. Questa impostazione determina quali informazioni ricevono enfasi nel feed, consentendoti di concentrarsi sulla metrica più importante per la tua attività.
Selezionare una delle opzioni KPI riportate di seguito.
- Ricavi - Assegna priorità agli approfondimenti relativi alle transazioni monetarie e alle prestazioni di vendita
- Coinvolgimento: assegna priorità agli approfondimenti relativi all’attività e alla partecipazione dei membri
- Rimborsi — Assegna priorità alle informazioni relative ai tassi di rimborso dei premi e all’attività
- Conversioni — Assegna priorità agli approfondimenti relativi alle metriche di conversione e al completamento dell’obiettivo
Per ulteriori informazioni sugli approfondimenti sulla fedeltà e sul monitoraggio delle prestazioni, consulta Esplorare le prestazioni relative alla fedeltà.
Provider di premi reward-providers
Un provider di premi indica a Journey Optimizer dove inviare le chiamate di evasione quando viene registrato l’avanzamento della richiesta di verifica o viene completata una richiesta di verifica. Ad esempio, un’API che attribuisce punti fedeltà o stelle a un account membro.
Utilizzare questa sezione per la configurazione del provider end-to-end (connessione, proxy, generatore di token di autenticazione e risorse di definizione dei premi). Per informazioni dettagliate sulla progettazione della definizione dei premi e sulla strategia di payload, vedere Guida alla definizione dei premi.
Per creare un provider di premi, eseguire la procedura seguente:
-
Apri la scheda Provider di premi e seleziona Crea provider di premi.
-
Immetti un Nome e una Descrizione.
-
Nel campo URL, immetti l’endpoint API che riceve le richieste di evasione.
-
Aggiungi Intestazioni in base alle esigenze della tua API (ad esempio, chiavi API o tipi di contenuto).
-
Configura le risorse associate al tuo provider di premi. Espandi ciascuna sezione seguente per i dettagli del campo:
accordion Definizioni dei premi Aggiungi una voce per tipo di premio supportato dal provider (ad esempio punti programma, stelle o credito monetario). Per ogni definizione:
- Immetti un Nome e una Descrizione.
- Specificare se la definizione è Abilitata.
- Attiva Predefinito per contrassegnare una definizione come predefinita per questo provider.
- Definisci come il payload dei premi verrà trasformato nella richiesta di payload di evasione, utilizzando l’espressione JSONata.
Per ulteriori informazioni, vedere Guida alla definizione del premio.
accordion Proxy per i premi Indirizza le chiamate di evasione tramite un server intermedio invece di inviarle direttamente all’endpoint. Nelle schermate del provider di premi e Crea proxy, utilizza il campo Credenziali per l’autenticazione proxy.
-
Immetti un Nome e una Descrizione.
-
Immettere Host e Porta.
-
Specificare se il proxy è abilitato.
-
In Credenziali, immettere il nome utente e la password proxy come JSON. Il valore delle credenziali è in genere simile al seguente:
code language-json { "userName": "test", "password": "xxxx" }
accordion Generatore di token di autenticazione Da utilizzare quando l’API richiede un token Bearer o un’autenticazione simile.
- Immetti un Nome e una Descrizione.
- In Tipo di autenticazione immettere il tipo di autenticazione, ad esempio Bearer.
- Seleziona il metodo HTTP (ad esempio, POST).
- Immetti l’URL dell’endpoint del token e la chiave token nella risposta (ad esempio,
access_token). - Specificare se il generatore di token di autenticazione è Abilitato.
- Aggiungi le intestazioni richieste dall’endpoint token.
Journey Optimizer utilizza questa configurazione per ottenere un nuovo token prima di ogni chiamata all’API di ricompensa.
-
Selezionare Crea provider di premi. Il provider e tutte le risorse configurate vengono salvati insieme.
Dopo il salvataggio, il provider viene visualizzato nell’elenco dei provider di premi. Gli addetti al marketing possono selezionarlo durante la configurazione dei premi per la sfida. Scopri come configurare i premi per le sfide
Per modificare un provider di premi, aprire la scheda Provider di premi, selezionare il provider e aggiornare i campi in uso. Le modifiche alle definizioni dei premi, ai proxy e ai generatori di token di autenticazione vengono salvate automaticamente quando vengono aggiornate.
Mappature di eventi event-mappings
Mapping eventi indica a Journey Optimizer come elaborare un evento esperienza Adobe Experience Platform in ingresso. Ad esempio, un acquisto o il check-in in un hotel. Gli addetti al marketing fanno riferimento a queste mappature quando creano attività evento personalizzato nel generatore di attività. Gli eventi che non corrispondono ad alcuna mappatura vengono ignorati.
Utilizzare questa sezione per configurare la mappatura degli eventi end-to-end. Per informazioni dettagliate sull’authoring dei trasformatori, consulta Guida del trasformatore di eventi.
Per creare una mappatura di evento, effettua le seguenti operazioni:
-
Apri la scheda Mapping evento e seleziona Crea mapping evento.
-
In Dettagli evento, immettere il Nome evento richiesto e selezionare lo Schema evento esperienza desiderato.
-
Nella sezione Mapping, fai clic sul pulsante Seleziona campi. Cerca o filtra la struttura dei campi dello schema, quindi seleziona i campi in ingresso da mappare.
-
Nella tabella di mappatura, utilizza i menu a discesa in Campi dati in arrivo per connettere ogni campo ai Campi evento fedeltà corrispondenti.
-
In JSONata e anteprima output, controlla l’espressione JSONata generata nell’editor di codice.
Per utilizzare un’espressione personalizzata, modifica direttamente i dati JSON. A tale scopo, selezionare il pulsante Reimposta su generato per tornare alla mappatura basata su tabella. Scopri come scrivere espressioni JSONata.
-
Salva la mappatura. Il mapping degli eventi viene visualizzato nell’elenco Mappature eventi ed è disponibile quando gli addetti al marketing creano attività evento personalizzate. Scopri come creare le attività
Inventario dei prodotti product-inventory
La scheda Inventario prodotti raggruppa gli elementi del catalogo in modo che gli addetti al marketing possano eseguirne il targeting nelle attività senza immettere ogni ID elemento. Carica un file CSV che associa ogni identificatore di elemento a uno o più gruppi di prodotti (lo stesso elemento può appartenere a più gruppi). I gruppi importati sono disponibili durante la configurazione dell’idoneità delle attività. Scopri come creare le attività
Per caricare un file di inventario dei prodotti, effettua le seguenti operazioni:
-
Prepara un file CSV che associa ogni identificatore di elemento a uno o più gruppi di prodotti. Espandi la sezione seguente per visualizzare un esempio.
accordion Esempio di CSV dell’inventario dei prodotti 
-
Apri la scheda Inventario prodotti.
-
Seleziona Carica e scegli il tuo file CSV.
-
Esaminare i dati importati nell’elenco di inventario. L’elenco mostra una riga per elemento. La colonna Gruppi inclusi in mostra ogni gruppo di prodotti per l’elemento come pillola o più pillole quando l’elemento appartiene a più gruppi.
-
Per visualizzare tutti gli elementi di un gruppo di prodotti, selezionare la pillola del gruppo nella colonna Gruppi inclusi in su qualsiasi riga. Nella vista Dettagli gruppo sono elencati tutti gli elementi del gruppo.
-
Apri Cronologia caricamento per visualizzare i caricamenti CSV precedenti.
Esclusioni exclusions
La scheda Esclusioni definisce gli elementi e i gruppi di catalogo esclusi a livello di programma, pertanto gli addetti al marketing non devono elencare le stesse esclusioni per ogni attività. Carica un file CSV che associa ogni identificatore di elemento a uno o più gruppi di esclusione (lo stesso elemento può appartenere a più gruppi).
Dopo l’importazione, gli elementi e i gruppi esclusi vengono visualizzati nel generatore di attività quando gli addetti al marketing configurano Elementi ed esclusioni idonei. Scopri come definire elementi ed esclusioni idonei per le attività
Per caricare le esclusioni, effettua le seguenti operazioni:
-
Prepara un file CSV che associa ogni identificatore di elemento a uno o più gruppi di esclusione. Espandi la sezione seguente per visualizzare un esempio.
accordion Esempio di CSV delle esclusioni 
-
Apri la scheda Esclusioni.
-
Seleziona Carica e scegli il tuo file CSV.
-
Esamina i dati importati nell’elenco delle esclusioni. L’elenco mostra una riga per elemento. I Gruppi inclusi nella colonna contengono ogni gruppo di esclusione per quell’elemento come pillola, oppure più pillole quando l’elemento appartiene a più gruppi.
- Per visualizzare tutti gli elementi di un gruppo di esclusione, seleziona la pillola del gruppo nella colonna Gruppi inclusi in su qualsiasi riga. Nella vista Dettagli gruppo sono elencati tutti gli elementi del gruppo.
- Apri Cronologia caricamento per visualizzare i caricamenti CSV precedenti.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how administrators configure Loyalty Challenges through global settings, performance settings, reward providers, event mappings, product inventory, and exclusions before marketers author challenges.
Intents:
- Select the Experience Platform identity namespace used to identify loyalty members
- Select the loyalty profile and event datasets and the priority KPI for loyalty insights
- Create and edit a reward provider, including reward definitions, a reward proxy, and an auth token generator
- Create an event mapping so incoming experience events are interpreted for Custom event tasks
- Upload a product inventory CSV that groups catalog items for use in task eligibility rules
- Upload a CSV of organization-wide item and group exclusions for task configuration
Glossary:
- Reward provider: the external system that Journey Optimizer calls to fulfill rewards when customers make progress or complete challenges (product-specific)
- Reward definition: a reward type a provider can issue (for example, points or stars) and the payload Journey Optimizer sends when rewards are fulfilled (product-specific)
- Reward proxy: an optional intermediate server that fulfillment calls are routed through instead of sending them directly to the reward API endpoint (product-specific)
- Auth token generator: configuration used to obtain a fresh bearer token (or similar) before each call to the reward API (product-specific)
- Event mapping: configuration that tells Journey Optimizer how to identify and interpret an incoming Experience Platform experience event, such as a purchase or check-in (product-specific)
- Product inventory: a CSV-based mapping of item identifiers to product groups, used to target items in tasks without entering every item ID (product-specific)
- Exclusions: a CSV-based mapping of item identifiers to exclusion groups that are excluded program-wide from task eligibility (product-specific)
- Key performance indicator (KPI): the organization’s priority metric for the Loyalty Insights dashboard, determining which insights receive emphasis (product-specific)
Guardrails:
- Events that do not match any event mapping are ignored.
- Bring your own data challenges fulfill rewards through the organization’s own data integration; reward providers configured in this section do not apply to those challenges.
- The profile dataset schema must include the Loyalty details and identityMap field groups, with identities supplied in identityMap; additional field groups can be included.
- The event dataset schema must include the Loyalty event details and Commerce details field groups; additional field groups can be included.
Prerequisites and permissions:
- Loyalty Challenges configuration requires administrator access to the Journey Optimizer instance, in addition to the permissions needed for Loyalty Challenges.
Terminology:
- Canonical name: event mapping — variants: event mappings
- Do not confuse: “product inventory” (item-to-group mappings used for task eligibility, uploaded via CSV) ≠ “exclusions” (item-to-group mappings used to exclude items program-wide, also uploaded via CSV)
- Do not confuse: “reward provider” (the external fulfillment system and its connection details) ≠ “reward definition” (one reward type and payload configuration belonging to a reward provider)
FAQ:
- Q: What does global settings configure? — The Experience Platform identity namespace used for Loyalty Challenges, matching how member profiles are identified in your data.
- Q: What does performance settings configure? — The loyalty profile dataset, loyalty event dataset, and the priority KPI for the Loyalty Insights dashboard.
- Q: What field groups must the loyalty datasets include? — The profile dataset schema must include Loyalty details and identityMap; the event dataset schema must include Loyalty event details and Commerce details.
- Q: What happens to events that do not match any event mapping? — They are ignored.
- Q: Do reward providers apply to Bring your own data challenges? — No, those challenges fulfill rewards through your own data integration, not through reward providers configured here.
- Q: What is a reward proxy used for? — To route fulfillment calls through an intermediate server instead of sending them directly to the reward API endpoint.
Related pages:
- For focused guidance on reward definition design and payload strategy: Reward Definition guide (loyalty-challenges/reward-definition-guide.md)
- For configuring challenge rewards after a reward provider is created: Learn how to configure challenge rewards (loyalty-challenges/create-challenges.md)
- For creating Bring your own data challenges: Learn how to create Bring your own data challenges (loyalty-challenges/create-challenges.md)
- For focused guidance on transformer authoring: Event Transformer guide (loyalty-challenges/event-transformer-guide.md)
- For writing custom JSONata mapping expressions: Learn how to write JSONata expressions (loyalty-challenges/event-transformer-guide.md)
- For creating Custom event tasks that reference event mappings: Learn how to create tasks (loyalty-challenges/create-tasks.md)
- For configuring eligible items using product inventory groups: Learn how to create tasks (loyalty-challenges/create-tasks.md)
- For defining eligible items and exclusions on tasks: Learn how to define eligible items and exclusions on tasks (loyalty-challenges/create-tasks.md)
- For background on loyalty data and datasets: Loyalty data and datasets (loyalty-challenges/loyalty-data-and-datasets.md)
- For more information about loyalty insights and performance monitoring: Explore loyalty performance (loyalty-challenges/loyalty-performance.md)
Personas:
- admin: Can select the identity namespace, loyalty profile and event datasets, and priority KPI in global and performance settings. Can create reward providers with reward definitions, proxies, and auth token generators, create event mappings, and upload product inventory and exclusions CSV files. The page states that Loyalty Challenges configuration requires administrator access to the Journey Optimizer instance, in addition to the permissions needed for Loyalty Challenges. Where: “Overview”.
Onboarding:
- Level: Intermediate
- First minimal step: Select the Loyalty configurations menu from the left navigation to open the configuration interface.
- Success check: The interface is organized into tabs: Global settings, Performance settings, Reward providers, Event mapping, Product inventory, and Exclusions.
- Previous: For background on loyalty data and datasets before configuring performance settings: Loyalty data and datasets (loyalty-challenges/loyalty-data-and-datasets.md)
- Next: After creating a reward provider, configure challenge rewards: Create loyalty challenges (loyalty-challenges/create-challenges.md); After uploading product inventory, reference groups when creating tasks: Create tasks for loyalty challenges (loyalty-challenges/create-tasks.md)