[Disponibilità limitata]{class="badge informative"}
Utilizzare i dati di Adobe Experience Platform aep-data
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.
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, Sku10Se 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
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.
Lo schema deve avere un’identità primaria definita.
Se non è ancora stato definito uno spazio dei nomi personalizzato, assicurati che l’identità sia un identificatore non di persona.
Enable the dataset for lookup in the dataset management interface
In the dataset management user interface, use the toggle to enable the dataset for lookup.
API Method
Follow the directions detailed in this documentation to configure your environment to send API commands.
Prerequisiti
-
The developer project must have the Adobe Journey Optimizer and Adobe Experience Platform APIs added to their project.
-
You must have manage datasets permission as part of your role.
-
The schema for which the dataset is based on must contain a primary identity that can act as the lookup key.
API call structure
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 is
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION} - Dataset ID is the dataset for which you wish to enable.
- Action is enable OR disable.
- Access token can be retrieved from the developer console.
- API key can be retrieved from the developer console.
- IMS Org ID is your Adobe organization.
- Sandbox Name is the sandbox name the dataset is in (i.e. prod, dev etc.).
"error_code": "403003","message": "Api Key is invalid"Dataset monitoring
Once a dataset has been enabled for lookup, you can review the status of ingestion into the lookup service by going to the Monitoring menu and selecting the Journey Optimizer tab.
This process indicator helps in understanding when new batches of data are available in the lookup service.
Passaggi successivi
After a dataset has been enabled for lookup using an API call, you can use the data with Journey Optimizer personalization and Decisioning capabilities. Per ulteriori informazioni, consulta queste sezioni: