[Beta]{class="badge informative"}
Crea una connessione sorgente SAP Commerce nell'interfaccia utente
Il seguente tutorial illustra i passaggi necessari per creare una connessione di origine SAP Commerce per portare i contatti di SAP Subscription Billing e i dati dei clienti tramite l'interfaccia utente di Adobe Experience Platform.
Introduzione getting-started
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri i blocchi predefiniti di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Se disponi già di un account SAP Commerce valido, puoi saltare il resto di questo documento e passare all'esercitazione configurazione di un flusso di dati.
Raccogli le credenziali richieste gather-credentials
Per connettere SAP Commerce a Experience Platform, è necessario fornire i valori per le seguenti proprietà di connessione:
clientId
dalla chiave del servizio.clientSecret
dalla chiave del servizio.url
dalla chiave del servizio sarà simile a https://subscriptionbilling.authentication.eu10.hana.ondemand.com
.url
e ha un valore simile a eu10
o us10
. Ad esempio, se url
è https://eu10.revenue.cloud.sap/api
, sarà necessario eu10
.Per ulteriori informazioni, consulta la SAP Commerce documentazione.
Creare uno schema di Platform create-platform-schema
Prima di creare una connessione di origine SAP Commerce, è inoltre necessario assicurarsi di creare uno schema di Experience Platform da utilizzare per l'origine. Consulta il tutorial su creazione di uno schema di Platform per i passaggi completi sulla creazione di uno schema.
Espandi la sezione seguente per visualizzare un esempio di schema.
code language-none |
---|
|
Connetti il tuo account SAP Commerce connect-account
Nell'interfaccia utente di Platform, seleziona Origini dalla barra di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini con cui è possibile creare un account.
Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria eCommerce, selezionare SAP Commerce, quindi Add data.
Viene visualizzata la pagina Connetti account SAP Commerce. In questa pagina è possibile utilizzare nuove credenziali o credenziali esistenti.
Account esistente existing-account
Per utilizzare un account esistente, seleziona l'account SAP Commerce con cui vuoi creare un nuovo flusso di dati, quindi seleziona Successivo per continuare.
Nuovo account new-account
Se stai creando un nuovo account, seleziona Nuovo account, quindi fornisci un nome, una descrizione facoltativa e le tue credenziali. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Selezionare i dati select-data
Infine, seleziona il tipo di oggetto da acquisire in Platform.
Customers
Contacts
Per acquisire i dati del cliente, seleziona Clienti come tipo di oggetto, quindi seleziona Successivo.
Per acquisire i dati di contatto, seleziona Contatti come tipo di oggetto, quindi seleziona Successivo.
Passaggi successivi next-steps
Seguendo questa esercitazione, hai stabilito una connessione al tuo account SAP Commerce. Ora puoi continuare con l'esercitazione successiva e configurare un flusso di dati per inserire dati in Platform.
Risorse aggiuntive additional-resources
Le sezioni seguenti forniscono ulteriori risorse a cui fare riferimento quando si utilizza l'origine SAP Commerce.
Mappatura mapping
Platform fornisce consigli intelligenti per campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi d’uso. In base alle tue esigenze, puoi scegliere di mappare i campi direttamente o utilizzare le funzioni di preparazione dati per trasformare i dati sorgente in modo da derivare valori calcolati o calcolati. Per i passaggi completi sull'utilizzo dell'interfaccia mapper e dei campi calcolati, consulta la guida dell'interfaccia utente della preparazione dati.
Le configurazioni di mappatura per il flusso di dati variano a seconda dello schema e del tipo di oggetto selezionato per l’acquisizione.
Per i dati del cliente, SAP Commerce utilizza gli endpoint clienti e relazioni cliente-contatti dell'API SAP Business Partners per recuperare i dati
Di seguito è riportato un esempio di configurazioni di mappatura per il flusso di dati SAP Commerce per i dati dei clienti:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 | |
---|---|
Campo di destinazione | Descrizione |
customerNumber |
Il numero del cliente. |
corporateInfo |
Il numero del cliente. |
customerType |
Il tipo di cliente. |
createdAt |
Un timestamp che indica quando è stato creato il cliente. |
changedAt |
Un timestamp che indica quando il cliente è stato aggiornato l’ultima volta. |
markets[*].country |
I mercati dei clienti, recuperati come oggetto array. |
addresses[*].email |
Le e-mail associate ai diversi indirizzi del cliente, recuperate come oggetto array. |
addresses[*].city |
Città associate ai diversi indirizzi del cliente, recuperate come oggetto array. |
addresses[*].addressUUID |
L’ID è associato ai diversi indirizzi del cliente, recuperati come oggetto array. |
externalObjectReferences[*].externalSystemId |
Dati aggiuntivi, recuperati come oggetto array. |
externalObjectReferences[*].externalId |
Dati aggiuntivi, recuperati come oggetto array. |
customReferences[*].id |
Dati aggiuntivi, recuperati come oggetto array. |
customReferences[*].typeCode |
Dati aggiuntivi, recuperati come oggetto array. |
Per i dati di contatto, SAP Commerce utilizza l'endpoint contacts dell'API SAP Business Partners per recuperare i dati.
Di seguito è riportato un esempio di configurazioni di mappatura per il flusso di dati SAP Commerce per i dati di contatto:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
---|---|
Campo di destinazione | Descrizione |
contactNumber |
Il numero del contatto. |
createdAt |
Timestamp che indica quando è stato creato il contatto. |
changedAt |
Timestamp che indica quando è stato eseguito l’ultimo aggiornamento del contatto. |
personalInfo.lastName |
Cognome del contatto. |
personalInfo.firstName |
Nome del contatto. |
externalObjectReferences[*].externalSystemId |
Dati aggiuntivi, recuperati come oggetto array. |
externalObjectReferences[*].externalId |
Dati aggiuntivi, recuperati come oggetto array. |
externalObjectReferences[*].externalIdTypeCode |
Dati aggiuntivi, recuperati come oggetto array. |