SAP Commerce connessione

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 Fatturazione abbonamento è un prodotto incluso nel portfolio e consente la gestione completa del ciclo di vita degli abbonamenti con esperienze di vendita e pagamento semplificate tramite integrazioni standardizzate.

Questo Adobe Experience Platform destinazione utilizza SAP Subscription Billing API di gestione clienti, per aggiornare i dettagli del cliente in SAP Commerce da un pubblico Experience Platform esistente dopo l’attivazione.

Istruzioni per l’autenticazione SAP Commerce sono riportati di seguito, nella Autentica nella destinazione sezione.

Casi d’uso use-cases

Per aiutarti a capire meglio come e quando utilizzare il SAP Commerce destinazione: ecco un caso d’uso di esempio che i clienti di Adobe Experience Platform possono risolvere utilizzando questa destinazione.

SAP Commerce I clienti memorizzano informazioni su individui o entità organizzative che interagiscono con la tua azienda. Il tuo team utilizza i clienti esistenti in SAP Commerce per generare il pubblico Experienci Platform. Dopo aver inviato questi tipi di pubblico a SAP Commerce, le loro informazioni vengono aggiornate e a ciascun cliente viene assegnata una proprietà il cui valore è il nome del pubblico che indica a quale pubblico appartiene il cliente.

Prerequisiti prerequisites

Consulta le sezioni seguenti per eventuali prerequisiti da impostare in Experienci Platform e SAP Commerce e per le informazioni che è necessario raccogliere prima di lavorare con SAP Commerce destinazione.

Experience Platform prerequisiti prerequisites-in-experience-platform

Prima di attivare i dati in SAP Commerce destinazione, è necessario disporre di un schema, a set di dati, e audience creato in Experience Platform.

Consulta la documentazione di Experienci Platform per Gruppo di campi schema Dettagli appartenenza pubblico per informazioni sugli stati del pubblico.

Prerequisiti per SAP Commerce destinazione prerequisites-destination

Prendi nota dei seguenti prerequisiti per esportare i dati da Platform al tuo SAP Commerce account:

Devi avere un SAP Subscription Billing account prerequisites-account

Per esportare i dati da Platform al tuo SAP Commerce account, è necessario disporre di un SAP Subscription Billing account. Se non disponi di un account di fatturazione valido, contatta SAP responsabile dell’account. Consulta la sezione SAP Configurazione piattaforma per ulteriori dettagli.

Generare una chiave di servizio prerequisites-service-key

  • Il SAP Commerce service key consente di accedere al SAP Subscription Billing API tramite Experienci Platform. Consulta la sezione SAP Commerce creare una chiave di servizio con ID client e segreto client per creare una chiave di servizio. SAP Commerce richiede quanto segue:

    • ID client
    • Segreto client
    • URL. Il pattern dell’URL è il seguente: https://subscriptionbilling.authentication.eu10.hana.ondemand.com. Questo valore verrà utilizzato in seguito 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"
}

Creare riferimenti personalizzati in SAP Subscription Billing prerequisites-custom-reference

Per aggiornare lo stato del pubblico di Experienci Platform in SAP Subscription Billing, è necessario un campo di riferimento personalizzato per ogni pubblico selezionato in Platform.

Per creare i riferimenti personalizzati, accedi al tuo SAP Subscription Billing account e passare al [Dati principali e configurazione] > [Riferimenti personalizzati] pagina. Quindi, seleziona Crea per aggiungere un nuovo riferimento per ogni pubblico selezionato in Platform. Questi nomi di campo di riferimento saranno necessari nei successivi Esempio di esportazione e pianificazione di un pubblico passaggio.

Un esempio di come creare un personalizzato Tipo di riferimento entro SAP Subscription Billing è mostrato di seguito:
Immagine che mostra dove creare un riferimento personalizzato nella fatturazione dellabbonamento SAP.

Per ulteriori informazioni, consulta SAP Subscription Billing riferimenti personalizzati documentazione.

Raccogli le credenziali richieste gather-credentials

Per connettersi SAP Commerce ad Experience Platform, è necessario fornire valori per le seguenti proprietà di connessione:

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. La regione è presente nel url e ha un valore simile a eu10 o us10. Ad esempio, se url è https://eu10.revenue.cloud.sap/api di cui hai bisogno eu10.

Guardrail guardrails

Richieste API a SAP Cloud Management service sono soggetti a Limiti di velocità. Quando il limite di velocità viene superato, si verifica un HTTP 429 Too Many Requests codice di stato della risposta .

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
Un identificatore del cliente individuale o aziendale già presente nel SAP Commerce account.
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
Descrizione
Segmentation Service
Caricamenti personalizzati

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 alla mappatura del campo.
  • Per ogni pubblico selezionato in Platform, la SAP Commerce l’attributo aggiuntivo viene aggiornato con il relativo stato di pubblico da Platform.
Frequenza di esportazione
Streaming
  • Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Quando un profilo viene aggiornato in Experienci Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni su destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, è necessario Gestire le destinazioni autorizzazione per il controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti in esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.

Entro Destinazioni > Catalogo, cerca SAP Commerce. In alternativa, è possibile posizionarlo sotto il eCommerce categoria.

Autenticarsi nella destinazione authenticate

Compila i campi obbligatori di seguito. Consulta la sezione Generare una chiave di servizio sezione per eventuali indicazioni.

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.
Regione
La posizione del centro dati. La regione è presente nel url e ha un valore simile a eu10 o us10. Ad esempio, se url è https://eu10.revenue.cloud.sap/api di cui hai bisogno eu10.

Per eseguire l’autenticazione nella destinazione, seleziona Connetti alla destinazione.
Immagine dall’interfaccia utente di Platform che mostra come eseguire l’autenticazione nella destinazione.

Se i dettagli forniti sono validi, nell’interfaccia utente viene visualizzato un 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 dall’interfaccia utente di Platform che mostra i dettagli della destinazione da compilare dopo l’autenticazione.

  • Nome: nome con cui riconoscerai questa destinazione in futuro.
  • Descrizione: descrizione che ti aiuterà a identificare questa destinazione in futuro.
  • Tipo di cliente: seleziona una Individuale o Aziendale a seconda delle entità all’interno del pubblico. Il SAP Subscription Billing schema cambia i campi obbligatori in base a questa selezione mappata al customerType attributo. Se la selezione è Aziendale, quindi le mappature obbligatorie come firstName e lastName necessario per un singolo cliente verrà ignorato e company diventa 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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Letto Attiva profili e tipi di pubblico nelle destinazioni di esportazione del pubblico in streaming per 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 a SAP Commerce destinazione, devi passare attraverso il passaggio di mappatura campo. 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 su SAP Commerce campi di destinazione, segui i passaggi seguenti:

Mappa il customerNumberSAP identità

Il customerNumberSAP identity è una mappatura obbligatoria per questa destinazione. Segui i passaggi seguenti per mapparla:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dell’interfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. In Seleziona campo di origine finestra, scegli la Seleziona lo spazio dei nomi dell’identità e seleziona customerNumberSAP.
    Schermata dell’interfaccia utente di Platform che seleziona l’e-mail come attributo sorgente da mappare come identità.
  3. In Seleziona campo di destinazione finestra, scegli la Seleziona lo spazio dei nomi dell’identità e seleziona la customerNumber identità.
    Schermata dell’interfaccia utente di Platform che seleziona le e-mail come attributo di destinazione da mappare come identità.
Campo di origine
Campo di destinazione
Obbligatorio
IdentityMap: customerNumberSAP
Identity: customerNumber

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

Mappatura degli attributi

Per aggiungere altri attributi che desideri aggiornare tra lo schema del profilo XDM e il SAP Subscription Billing account, ripeti i passaggi seguenti:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dell’interfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. In Seleziona campo di origine finestra, scegli la Seleziona attributi e selezionare l'attributo XDM.
    Schermata dell’interfaccia utente di Platform che seleziona Cognome come attributo sorgente.
  3. In Seleziona campo di destinazione finestra, scegli Seleziona attributi personalizzati categoria e digitare il nome del SAP Subscription Billing dall'elenco dei clienti schema attributi.
    Schermata dell’interfaccia utente di Platform in cui cognome è definito come attributo target.
IMPORTANT
I nomi dei campi di destinazione fanno distinzione tra maiuscole e minuscole e devono corrispondere al SAP Subscription Billing nomi di attributi. L’unica eccezione è country dove usare countryCode invece. 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, pertanto assicurati di fornire esattamente come definito in caso di errori: The country code {} does not exist o size must be between 0 and 3.

Mappa mandatory attributi per il tipo di cliente selezionato

Le mappature di attributi obbligatorie dipendono dal Tipo di cliente che avevi selezionato. Per mappare gli attributi obbligatori, seleziona una delle opzioni seguenti:

Cliente singolo
table 0-row-3 1-row-3 2-row-3
Campo di 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 di 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 di profilo XDM e il SAP Subscription Billing schema attributi di un cliente come mostrato di seguito:

Cliente singolo
table 0-row-3 1-row-3 2-row-3 3-row-3
Campo di 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 dall’interfaccia utente di Platform che mostra un esempio con mappature di attributi obbligatorie e facoltative in cui il cliente è un singolo utente.

Cliente aziendale
table 0-row-3 1-row-3 2-row-3
Campo di 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 dall’interfaccia utente di Platform che mostra un esempio con mappature di attributi obbligatorie e facoltative in cui il cliente è un’azienda.

Una volta completate le mappature per la connessione di destinazione, seleziona Successivo.

Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example

Durante l'esecuzione di Pianificare l’esportazione del pubblico , devi mappare manualmente i tipi di pubblico di Platform su attributi in SAP Subscription Billing.

Un esempio del passaggio di esportazione Pianifica pubblico, con la posizione del SAP Commerce ID mappatura evidenziato, è mostrato di seguito:
Immagine da Platform che mostra l’esportazione del pubblico di pianificazione con ID di mappatura compilati.

A questo scopo, seleziona ogni segmento, quindi inserisci il nome del riferimento personalizzato da SAP Subscription Billing nel SAP Commerce ID mappatura campo del connettore di destinazione. Per istruzioni sulla creazione di riferimenti personalizzati, consulta Creare riferimenti personalizzati in SAP Subscription Billing sezione.

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

Ad esempio, se il pubblico Experience Platform selezionato è sap_audience1 e desideri che il relativo stato venga aggiornato in SAP Subscription Billing riferimento personalizzato SAP_1, specifica questo valore in SAP_Commerce ID mappatura campo.

Un esempio Tipo di riferimento da SAP Subscription Billing è mostrato di seguito:
Immagine che mostra dove creare un riferimento personalizzato nella fatturazione dellabbonamento SAP.

Un esempio del passaggio Pianifica esportazione pubblico, con un pubblico selezionato e i corrispondenti SAP Commerce ID mappatura evidenziato, è mostrato di seguito:
Immagine da Platform che mostra l’esportazione del pubblico di pianificazione con ID di mappatura compilati.

Come mostrato dal valore all'interno del ID mappatura deve corrispondere esattamente al SAP Subscription Billing Tipo di riferimento valore .

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: | SAP Commerce nome del pubblico | SAP Subscription Billing Tipo di riferimento | SAP Commerce ID mappatura valore | | — | — | — | | 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 a SAP Subscription Billing account, quindi passare al 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 le intestazioni di colonna che mostrano il nome del pubblico e le celle relative allo stato del pubblico

Utilizzo dei dati e governance data-usage-governance

Tutti Adobe Experience Platform le destinazioni 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, consulta la sezione Panoramica sulla governance dei dati.

Errori e risoluzione problemi errors-and-troubleshooting

Consulta la sezione SAP Subscription Billing Tipi di errore nella pagina della documentazione di per un elenco dei possibili tipi di errore e dei relativi codici di risposta.

Risorse aggiuntive additional-resources

Ulteriori informazioni utili da SAP la documentazione è riportata di seguito:

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