DocumentazioneJourney OptimizerGuida di Journey Optimizer

[Disponibilità limitata]{class="badge informative"}

Utilizzare i dati di Adobe Experience Platform aep-data

Ultimo aggiornamento: 14 settembre 2026

Creato per:

  • Intermedio
  • Sviluppatore

In questa pagina: abilita i set di dati Adobe Experience Platform basati su record per la ricerca in modo da arricchire la personalizzazione, il decisioning e l’orchestrazione del percorso con i dati di riferimento e transazionali recuperati in fase di esecuzione in Journey Optimizer.

style
shade-box

Journey Optimizer consente di sfruttare i dati di Adobe Experience Platform con funzionalità di personalizzazione, decisioning e orchestrazione di percorso. A questo scopo, i set di dati basati su record necessari per la personalizzazione della ricerca devono prima essere abilitati per il servizio di ricerca come descritto di seguito.

NOTE
La funzionalità di ricerca dati è disponibile in Disponibilità limitata ed è disponibile per tutti i clienti Journey Optimizer.

Per ulteriori informazioni su come accedere e utilizzare i set di dati, consulta questa sezione: Introduzione ai set di dati

Da leggere

Guardrail e linee guida guidelines

Prima di iniziare, rivedi le seguenti restrizioni e linee guida:

  • Nessun PII nei set di dati - I set di dati abilitati per la ricerca non devono contenere informazioni personali (PII, Personally Identifiable Information).

  • Rischio di eliminazione - I set di dati utilizzati nella personalizzazione non sono protetti dall’eliminazione. È necessario tenere traccia dei set di dati utilizzati per assicurarsi che non vengano rimossi.

  • Tipo di schema - I set di dati devono essere associati a uno schema di tipo NOT Profilo o Evento.

  • Mantieni attiva la ricerca - Evita di attivare e disattivare ripetutamente i set di dati. Procedendo in questo modo si potrebbe verificare un comportamento di indicizzazione imprevisto. La best practice prevede di lasciare abilitato il set di dati per tutto il tempo in cui intendi utilizzarlo per le ricerche.

  • Area di attivazione di Edge - I set di dati abilitati per la ricerca sono disponibili per l’attivazione in entrata basata su Edge solo nell’area in cui risiede la sandbox del set di dati (ad esempio, NLD2 o VA7). Puoi visualizzare l’area sandbox nell’interfaccia utente accanto al nome della sandbox.

  • Batch di eliminazione dati - La rimozione di un batch di dati dal set di dati comporta la rimozione completa di tutte le chiavi corrispondenti dal servizio di ricerca. Ad esempio:

    Batch 1: Sku1, Sku2, Sku3
    Batch 2: Sku1, Sku2, Sku3, Sku4, Sku5, Sku6
    Batch 3: Sku7, Sku8, Sku9, Sku10

    Se si elimina Batch 1, Sku1, Sku2 e Sku3 verranno rimossi dall’archivio di ricerca. I dati di ricerca risultanti conterranno quindi: Sku4, Sku5, Sku6, Sku7, Sku8, Sku9, Sku10.

Diritto per il servizio di ricerca

Componente funzione
Limiti
Note
Set di dati di ricerca abilitati
Massimo 10 per organizzazione
Numero massimo di set di dati che possono essere configurati per la ricerca in un dato momento. Questo limite si applica al numero totale combinato di set di dati di ricerca nelle sandbox di produzione e di sviluppo all’interno dell’istanza del cliente.
Conteggio record set di dati
Fino a 2 milioni di record per set di dati
Numero massimo di record consentiti in un singolo set di dati, calcolato come conteggio totale in tutti i batch all’interno di tale set di dati.
Dimensione record
Fino a 2 KB per record
Dimensione massima del record predefinita supportata.
Dimensione set di dati
Fino a 4 GB
Dimensione massima di un singolo set di dati, non la dimensione combinata in tutti i set di dati in una sandbox. I limiti di conteggio dei record e dimensione del set di dati sono guardrail indipendenti, entrambi devono essere soddisfatti.
Aggiornamenti della frequenza del set di dati
Fino a 5 aggiornamenti al giorno per set di dati
Frequenza massima consentita per le operazioni di aggiornamento per un singolo set di dati al giorno.
NOTE
Se sono necessari volumi aggiuntivi oltre ai guardrail elencati sopra, contatta il tuo rappresentante Adobe.

Abilitare un set di dati per la ricerca di dati enable

Per sfruttare i dati del set di dati per la personalizzazione, devi abilitare il set di dati per la ricerca.

Prerequisiti prerequisites-enable

Lo schema associato al set di dati che desideri abilitare per la ricerca deve essere di tipo record. Lo schema NON deve essere di profilo o classe di evento.

Esempio

Lo schema deve avere un’identità primaria definita.

Esempio

Se non è ancora stato definito uno spazio dei nomi personalizzato, assicurati che l’identità sia un identificatore non di persona.

Esempio

Abilitare il set di dati per la ricerca nell’interfaccia di gestione del set di dati

Nell’interfaccia utente per la gestione dei set di dati, utilizza l’interruttore per abilitare il set di dati per la ricerca.

Metodo API

Segui le istruzioni descritte in questa documentazione per configurare l’ambiente per l’invio di comandi API.

Prerequisiti

  • Il progetto dello sviluppatore deve includere le API Adobe Journey Optimizer e Adobe Experience Platform aggiunte al progetto.

  • Come parte del tuo ruolo, devi disporre dell’autorizzazione Gestione set di dati.

  • Lo schema su cui si basa il set di dati deve contenere un’identità primaria che possa fungere da chiave di ricerca.

Struttura delle chiamate API

curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"

Dove:

  • URL: https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
  • L’ID del set di dati è il set di dati per il quale desideri abilitare.
  • L’azione è enable OR disable.
  • Il token di accesso può essere recuperato dalla console per sviluppatori.
  • La chiave API può essere recuperata dalla console per sviluppatori.
  • L’ID dell’organizzazione IMS è l’organizzazione Adobe.
  • Nome sandbox: il nome della sandbox in cui si trova il set di dati (ad esempio, produzione, sviluppo, ecc.).
NOTE
Se si verifica l’errore seguente durante il tentativo di una chiamata API per abilitare i set di dati, prova a rimuovere le API Adobe Journey Optimizer dal progetto della console per sviluppatori e quindi a aggiungerle di nuovo:
"error_code": "403003",
"message": "Api Key is invalid"

Monitoraggio dei set di dati

Dopo aver abilitato un set di dati per la ricerca, puoi controllare lo stato di acquisizione nel servizio di ricerca dal menu Monitoraggio e selezionando la scheda Journey Optimizer.

Questo indicatore di processo aiuta a capire quando sono disponibili nuovi batch di dati nel servizio di ricerca.

Passaggi successivi

Dopo aver abilitato un set di dati per la ricerca tramite una chiamata API, puoi utilizzare i dati con le funzionalità di personalizzazione e decisioning di Journey Optimizer. Per ulteriori informazioni, consulta queste sezioni:

AI Knowledge Reference

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 to enable record-based Adobe Experience Platform datasets for the lookup service so their data can enrich personalization, Decisioning, and journey orchestration at runtime, including the entitlement guardrails.

Intents:

  • Enable a record-based dataset for lookup using the dataset management toggle or the API.
  • Meet the prerequisites (record-type schema, primary identity, non-person namespace).
  • Review the lookup entitlement limits before designing a lookup strategy.
  • Monitor lookup ingestion status.
  • Use enabled data with personalization, Decisioning, and journey orchestration.

Glossary:

  • Lookup service: the service that retrieves record-based dataset data at runtime for personalization, Decisioning, and journey orchestration (product-specific)
  • Lookup dataset: a record-based dataset enabled for lookup (product-specific)
  • Primary identity (lookup key): the identity, required on the schema, that acts as the lookup key (product-specific)
  • Record-type schema: the required schema type for lookup — a schema that is NOT of Profile or Event class
  • Edge activation region: the region (for example, NLD2 or VA7) where the dataset’s sandbox resides, for inbound edge-based activation (product-specific)

Guardrails:

  • Enabled Lookup Datasets: maximum 10 per organization, combined across production and development sandboxes (default; if additional volumes are needed, contact your Adobe representative).
  • Dataset Record Count: up to 2 million records per dataset, counted as the total across all batches (default; raisable by contacting your Adobe representative).
  • Record Size: up to 2 KB per record (default maximum record size supported).
  • Dataset Size: up to 4 GB per individual dataset; the record count and dataset size limits are independent guardrails and both must be satisfied (default; raisable by contacting your Adobe representative).
  • Dataset Frequency Updates: up to 5 updates per day per dataset (default; raisable by contacting your Adobe representative).
  • Datasets enabled for lookup should not contain any Personally Identifiable Information (PII).
  • Datasets used in personalization are not protected from deletion; keep track of which datasets are in use.
  • The schema must be record-type (NOT of Profile or Event class) and must have a primary identity defined; if a custom namespace is not defined, the identity must be a non-person identifier.
  • Keep the lookup toggle on; repeatedly turning datasets on and off can lead to unexpected indexing behavior.
  • Datasets enabled for lookup are available for inbound edge-based activation only in the region where the dataset’s sandbox resides.
  • Removing a batch of data completely removes all matching keys from the lookup service.
  • The data lookup capability is in Limited Availability.

Terminology:

  • Canonical name: lookup service — variants: data lookup, enable for lookup
  • API ACTION values: enable OR disable
  • Do not confuse: a “lookup dataset” (record-type, NOT Profile or Event, not stored on the profile) ≠ a profile or event dataset (Profile or Event class)
  • Do not confuse: enabling a dataset for “lookup” ≠ enabling a dataset for “Profile”

FAQ:

  • Q: What schema type is required for a lookup dataset? — A record-type schema that is NOT of Profile or Event class, with a primary identity defined that can act as the lookup key.
  • Q: How many datasets can I enable for lookup? — Up to 10 per organization, combined across production and development sandboxes; contact your Adobe representative for more.
  • Q: What are the record and size limits? — Up to 2 million records and 4 GB per dataset, up to 2 KB per record, and up to 5 updates per day per dataset; the record count and dataset size are independent guardrails that must both be satisfied.
  • Q: Can lookup datasets contain PII? — No; datasets enabled for lookup should not contain any Personally Identifiable Information.
  • Q: What happens if I delete a batch of data? — All matching keys in that batch are completely removed from the lookup service.
  • Q: Should I toggle lookup on and off frequently? — No; repeatedly turning datasets on and off can lead to unexpected indexing behavior, so keep the toggle on while the dataset is in use.
recommendation-more-help
journey-optimizer-help