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 per Region e Endpoint.
Seleziona per visualizzare un esempio della chiave del servizio
code language-json
{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

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:
Immagine che mostra dove creare un riferimento personalizzato nella fatturazione dellabbonamento SAP.

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:

Credenziali
Descrizione
ID client
Il valore di clientId dalla chiave del servizio.
Segreto client
Il valore di clientSecret dalla chiave del servizio.
Endpoint
Il valore di url dalla chiave del servizio è simile a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Area geografica
La posizione del centro dati. L'area è presente in 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à.

Identità di destinazione
Descrizione
Considerazioni
customerNumberSAP
Identificatore del cliente individuale o aziendale già presente nell'account SAP Commerce.
Obbligatorio

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 di pubblico
Supportato
Descrizione
Segmentation Service
Tipi di pubblico generati tramite il servizio di segmentazione Experience Platform.
Caricamenti personalizzati
Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Basato su profilo
  • 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.
Frequenza di esportazione
Streaming
  • 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

IMPORTANT
Per connettersi alla destinazione, è necessario disporre dell'autorizzazione Gestione destinazioni controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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.

Campo
Descrizione
ID client
Il valore di clientId dalla chiave del servizio.
Segreto client
Il valore di clientSecret dalla chiave del servizio.
Endpoint
Il valore di url dalla chiave del servizio è simile a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Area
La posizione del centro dati. L'area è presente in 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.
Immagine dallinterfaccia utente di Platform che mostra come eseguire lautenticazione nella 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.
Immagine dallinterfaccia utente di Platform che mostra i dettagli della destinazione da compilare dopo lautenticazione.

  • 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 come firstName e lastName richieste per un singolo cliente verranno ignorate e company 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

IMPORTANT

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:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dellinterfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. Nella finestra Seleziona campo di origine, scegli Seleziona spazio dei nomi identità e seleziona customerNumberSAP.
    Schermata dellinterfaccia utente di Platform che seleziona e-mail come attributo di origine da mappare come identità.
  3. Nella finestra Seleziona campo di destinazione, scegli Seleziona spazio dei nomi identità e seleziona l'identità customerNumber.
    Schermata dellinterfaccia utente di Platform che seleziona le e-mail come attributo di destinazione da mappare come identità.
Campo origine
Campo di destinazione
Obbligatorio
IdentityMap: customerNumberSAP
Identity: customerNumber

Di seguito è riportato un esempio con la mappatura di identità:
Immagine dallinterfaccia utente di Platform che mostra un esempio di mapping di identità customerNumber.

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:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dellinterfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM.
    Schermata dellinterfaccia utente di Platform che seleziona Cognome come attributo di origine.
  3. 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.
    Schermata dellinterfaccia utente di Platform in cui lastName è definito come attributo di destinazione.
IMPORTANT
I nomi dei campi di destinazione fanno distinzione tra maiuscole e minuscole e devono corrispondere ai nomi degli attributi SAP Subscription Billing. L'unica eccezione è 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:

Cliente singolo
table 0-row-3 1-row-3 2-row-3
Campo origine Campo di destinazione Obbligatorio
xdm: person.lastName Attribute: lastName
xdm: workAddress.countryCode Attribute: countryCode
Cliente aziendale
table 0-row-3 1-row-3 2-row-3
Campo origine Campo di destinazione Obbligatorio
xdm: b2b.companyName Attribute: company
xdm: workAddress.countryCode Attribute: countryCode

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:

Cliente singolo
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:
Immagine dallinterfaccia utente di Platform che mostra un esempio con mapping di attributi obbligatori e facoltativi in cui il cliente è un singolo utente.

Cliente aziendale
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:
Immagine dallinterfaccia utente di Platform che mostra un esempio con mapping di attributi obbligatori e facoltativi in cui il cliente è unazienda.

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:
Immagine da Platform che mostra lesportazione del pubblico di pianificazione con ID di mappatura popolati.

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.

IMPORTANT
Non utilizzare l’etichetta di riferimento personalizzata come valore.
Immagine che indica che non si deve utilizzare il valore dell'etichetta di riferimento personalizzata per la mappatura.

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:
Immagine che mostra dove creare un riferimento personalizzato nella fatturazione dellabbonamento SAP.

Di seguito è riportato un esempio del passaggio Pianifica esportazione pubblico, con un pubblico selezionato e il corrispondente SAP Commerce ID mappatura evidenziato:
Immagine da Platform che mostra lesportazione del pubblico di pianificazione con ID di mappatura popolati.

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.
Immagine della fatturazione dellabbonamento SAP che mostra la pagina di panoramica del cliente con intestazioni di colonna che mostrano il nome del pubblico e le celle dello stato del pubblico

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.

Visualizza changelog
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.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6