Connessione SAP Commerce
SAP Commerce, precedentemente noto come Hybris, è una soluzione di piattaforma di e-commerce basata su cloud per le aziende B2B e B2C e disponibile come parte del portafoglio SAP Customer Experience. SAP La fatturazione dell'abbonamento è un prodotto incluso nel portfolio e consente la gestione completa del ciclo di vita dell'abbonamento con esperienze di vendita e pagamento semplificate tramite integrazioni standardizzate.
Questa Adobe Experience Platform destinazione utilizza la SAP Subscription Billing API di gestione clienti, per aggiornare i dettagli del cliente entro SAP Commerce da un pubblico Experience Platform esistente dopo l'attivazione.
Le istruzioni per l'autenticazione nell'istanza SAP Commerce sono riportate di seguito, nella sezione Autentica nella destinazione.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione SAP Commerce, ecco un esempio di caso d'uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa destinazione.
I clienti SAP Commerce memorizzano informazioni su singoli utenti o entità organizzative che interagiscono con la tua azienda. Il tuo team utilizza i clienti esistenti in SAP Commerce per creare i tipi di pubblico di Experience Platform. Dopo aver inviato questi tipi di pubblico a SAP Commerce, le informazioni vengono aggiornate e a ciascun cliente viene assegnata una proprietà con il relativo valore come nome del pubblico che indica a quale pubblico appartiene il cliente.
Prerequisiti prerequisites
Consultare le sezioni seguenti per eventuali prerequisiti da impostare in Experience Platform e SAP Commerce e per informazioni da raccogliere prima di utilizzare la destinazione SAP Commerce.
Experience Platform prerequisiti prerequisites-in-experience-platform
Prima di attivare i dati nella destinazione SAP Commerce, è necessario disporre di uno schema, un set di dati e tipi di pubblico creati in Experience Platform.
Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione di Experience Platform per il gruppo di campi dello schema Dettagli appartenenza pubblico.
Prerequisiti per la destinazione SAP Commerce prerequisites-destination
Per esportare i dati da Platform al tuo account SAP Commerce, tieni presente i seguenti prerequisiti:
Devi avere un account SAP Subscription Billing prerequisites-account
Per esportare i dati da Platform all'account SAP Commerce, è necessario disporre di un account SAP Subscription Billing. Se non disponi di un account di fatturazione valido, contatta il tuo account manager SAP. Per ulteriori informazioni, consultare il documento SAP Configurazione piattaforma.
Generare una chiave di servizio prerequisites-service-key
-
La chiave del servizio SAP Commerce ti consente di accedere all'API SAP Subscription Billing tramite Experience Platform. Per creare una chiave di servizio, consultare SAP Commerce creare una chiave di servizio con ID client e segreto client. SAP Commerce richiede quanto segue:
- ID client
- Segreto client
- URL. Schema URL:
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
. Questo valore verrà utilizzato successivamente per ottenere i valori perRegion
eEndpoint
.
code language-json |
---|
|
Crea riferimenti personalizzati in SAP Subscription Billing prerequisites-custom-reference
Per aggiornare lo stato del pubblico di Experience Platform in SAP Subscription Billing, è necessario un campo di riferimento personalizzato per ogni pubblico selezionato in Platform.
Per creare i riferimenti personalizzati, accedere all'account SAP Subscription Billing e passare alla pagina [Dati e configurazione principali] > [Riferimenti personalizzati]. Quindi, seleziona Crea per aggiungere un nuovo riferimento per ogni pubblico selezionato in Platform. Questi nomi dei campi di riferimento saranno necessari nel passaggio successivo di Pianifica esportazione pubblico ed esempio.
Di seguito è riportato un esempio di come creare un tipo di riferimento personalizzato in SAP Subscription Billing:
Per ulteriori informazioni, consulta la documentazione SAP Subscription Billing riferimenti personalizzati.
Raccogli le credenziali richieste gather-credentials
Per connettere SAP Commerce a Experience Platform, è necessario fornire i valori per le proprietà di connessione seguenti:
clientId
dalla chiave del servizio.clientSecret
dalla chiave del servizio.url
dalla chiave del servizio è 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
, è necessario eu10
.Guardrail guardrails
Le richieste API a SAP Cloud Management service sono soggette a Limiti di frequenza. Quando il limite di frequenza viene superato, verrà rilevato un codice di stato di risposta HTTP 429 Too Many Requests
.
Identità supportate supported-identities
SAP Commerce supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
customerNumberSAP
Tipi di pubblico supportati supported-audiences
Questa sezione descrive tutti i tipi di pubblico che puoi esportare in questa destinazione.
Questa destinazione supporta l'attivazione di tutti i tipi di pubblico generati tramite l'Experience Platform Servizio di segmentazione.
Questa destinazione supporta anche l’attivazione dei tipi di pubblico descritti nella tabella seguente.
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
- Stai esportando tutti i membri di un pubblico, insieme ai campi di schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
- Per ogni pubblico selezionato in Platform, l'attributo aggiuntivo SAP Commerce corrispondente viene aggiornato con il relativo stato da Platform.
- Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Quando un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
In Destinazioni > Catalogo, cerca SAP Commerce. In alternativa, è possibile individuarlo nella categoria eCommerce.
Autenticarsi nella destinazione authenticate
Compila i campi obbligatori di seguito. Per ulteriori informazioni, consultare la sezione Generare una chiave di servizio.
clientId
dalla chiave del servizio.clientSecret
dalla chiave del servizio.url
dalla chiave del servizio è 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
, è necessario eu10
.Per eseguire l'autenticazione nella destinazione, selezionare Connetti alla destinazione.
Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
- Nome: un nome con cui riconoscerai questa destinazione in futuro.
- Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
- Tipo di cliente: seleziona Individuale o Aziendale a seconda delle entità del pubblico. Lo SAP Subscription Billing schema cambia i campi obbligatori in base a questa selezione mappata all'attributo
customerType
. Se la selezione è Aziendale, le mappature obbligatorie comefirstName
elastName
richieste per un singolo cliente verranno ignorate ecompany
diventerà obbligatorio e viceversa.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
- Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Mappare attributi e identità map
Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione SAP Commerce, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione. Per mappare correttamente i campi XDM ai campi di destinazione SAP Commerce, effettua le seguenti operazioni:
Mappa l'identità customerNumberSAP
L'identità customerNumberSAP
è una mappatura obbligatoria per questa destinazione. Segui i passaggi seguenti per mapparla:
- Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
- Nella finestra Seleziona campo di origine, scegli Seleziona spazio dei nomi identità e seleziona
customerNumberSAP
.
- Nella finestra Seleziona campo di destinazione, scegli Seleziona spazio dei nomi identità e seleziona l'identità
customerNumber
.
IdentityMap: customerNumberSAP
Identity: customerNumber
Di seguito è riportato un esempio con la mappatura di identità:
Mappatura degli attributi
Per aggiungere altri attributi da aggiornare tra lo schema del profilo XDM e l'account SAP Subscription Billing, ripeti i passaggi seguenti:
- Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
- Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM.
- Nella finestra Seleziona campo di destinazione, scegli la categoria Seleziona attributi personalizzati e digita il nome dell'attributo SAP Subscription Billing dall'elenco degli attributi schema del cliente.
country
, dove è necessario utilizzare countryCode
. SAP Subscription Billing supporta i codici paese alpha-2 (ISO 3166). Il valore fa distinzione tra maiuscole e minuscole e deve essere compreso tra 0 e 3 caratteri. Assicurarsi quindi di fornire esattamente come definito in caso di errori: The country code {} does not exist
o size must be between 0 and 3
.Mappa gli attributi mandatory
per il tipo di cliente selezionato
I mapping di attributi obbligatori dipendono dal Tipo di cliente selezionato. Per mappare gli attributi obbligatori, seleziona una delle opzioni seguenti:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo origine | Campo di destinazione | Obbligatorio |
xdm: person.lastName |
Attribute: lastName |
Sì |
xdm: workAddress.countryCode |
Attribute: countryCode |
Sì |
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo origine | Campo di destinazione | Obbligatorio |
xdm: b2b.companyName |
Attribute: company |
Sì |
xdm: workAddress.countryCode |
Attribute: countryCode |
Sì |
Mappatura di attributi aggiuntivi
Puoi quindi aggiungere altre mappature tra lo schema del profilo XDM e gli attributi SAP Subscription Billing schema per un cliente, come illustrato di seguito:
table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
---|---|---|
Campo origine | Campo di destinazione | Obbligatorio |
xdm: person.name.firstName |
Attribute: firstName |
No |
xdm: workAddress.street1 |
Attribute: street |
No |
xdm: workAddress.city |
Attribute: city |
No |
Di seguito è riportato un esempio con mappature di attributi obbligatorie e facoltative in cui il cliente è un singolo utente:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo origine | Campo di destinazione | Obbligatorio |
xdm: workAddress.street1 |
Attribute: street |
No |
xdm: workAddress.city |
Attribute: city |
No |
Di seguito è riportato un esempio con mappature di attributi obbligatorie e facoltative in cui il cliente è un’azienda:
Al termine della fornitura dei mapping per la connessione di destinazione, selezionare Avanti.
Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example
Quando esegui il passaggio Pianifica esportazione pubblico, devi mappare manualmente i tipi di pubblico di Platform agli attributi in SAP Subscription Billing.
Di seguito è riportato un esempio del passaggio di esportazione Pianifica pubblico, con la posizione dell'SAP Commerce ID mappatura evidenziato:
A questo scopo, seleziona ogni segmento, quindi immetti il nome del riferimento personalizzato da SAP Subscription Billing nel campo del connettore di destinazione SAP Commerce ID mappatura. Per istruzioni sulla creazione di riferimenti personalizzati, consulta la sezione Creare riferimenti personalizzati in SAP Subscription Billing.
![Immagine che indica che non si deve utilizzare il valore dell'etichetta di riferimento personalizzata per la mappatura.](./media_1e8ab7aa5d6d02ba2078cebf94a546a4da1b68d4b.png?width=750&format=png&optimize=medium)
Se ad esempio il pubblico Experience Platform selezionato è sap_audience1
e si desidera che il relativo stato venga aggiornato nel riferimento personalizzato SAP_1
di SAP Subscription Billing, specificare questo valore nel campo SAP_Commerce ID mappatura.
Di seguito è riportato un esempio di tipo di riferimento da SAP Subscription Billing:
Di seguito è riportato un esempio del passaggio Pianifica esportazione pubblico, con un pubblico selezionato e il corrispondente SAP Commerce ID mappatura evidenziato:
Come mostrato, il valore all'interno del campo ID mappatura deve corrispondere esattamente al valore SAP Subscription Billing Tipo riferimento.
Ripeti questa sezione per ogni pubblico di Platform attivato.
In base all’immagine mostrata sopra in cui hai selezionato due tipi di pubblico, la mappatura sarà la seguente:
| Nome pubblico SAP Commerce | SAP Subscription Billing Tipo di riferimento | SAP Commerce Valore di mappatura ID |
| — | — | — |
| sap_audience1 | SAP_1
| SAP_1
|
| Pubblico SAP2 | SAP_2
| SAP_2
|
Convalidare l’esportazione dei dati exported-data
Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:
Accedi all'account SAP Subscription Billing, quindi passa alla pagina Contatti per verificare gli stati del pubblico. L’elenco può essere configurato in modo da visualizzare le colonne per i riferimenti personalizzati e gli stati del pubblico corrispondenti.
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.
Errori e risoluzione problemi errors-and-troubleshooting
Per un elenco dei possibili tipi di errore e dei relativi codici di risposta, fare riferimento alla pagina della documentazione SAP Subscription Billing Tipi di errore.
Risorse aggiuntive additional-resources
Di seguito sono riportate ulteriori informazioni utili dalla documentazione di SAP:
Changelog
Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Mese di rilascio | Tipo di aggiornamento | Descrizione |
Gennaio 2024 | Versione iniziale | Versione di destinazione iniziale e pubblicazione della documentazione. |