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.

Prerequisiti di Experience Platform 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 sull'iscrizione al pubblico.

Prerequisiti per la destinazione SAP Commerce prerequisites-destination

Per esportare i dati da Experience Platform al tuo account SAP Commerce, tieni presente i seguenti prerequisiti:

Devi avere un account SAP Subscription Billing prerequisites-account

Per esportare dati da Experience 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

{
    "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 Experience Platform.

Per creare i riferimenti personalizzati, accedere all'account SAP Subscription Billing e passare alla pagina [Dati e configurazione principali] > [Riferimenti personalizzati]. Quindi, seleziona Create per aggiungere un nuovo riferimento per ogni pubblico selezionato in Experience 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 Reference Type personalizzato all'interno di SAP Subscription Billing:

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

Raccogli le credenziali richieste gather-credentials

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

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à.

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 Experience Platform Segmentation Service.

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.

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.

Entro Destinations > Catalog, 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.

Per eseguire l'autenticazione nella destinazione, selezionare Connect to destination.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connected 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.

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 della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

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 Experience 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:

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:

Mappa gli attributi mandatory per il tipo di cliente selezionato

I mapping di attributi obbligatori dipendono dai Type of Customer selezionati. Per mappare gli attributi obbligatori, seleziona una delle opzioni seguenti:

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:

Al termine della fornitura delle mappature per la connessione di destinazione, selezionare Next.

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 Experience Platform agli attributi in SAP Subscription Billing.

Di seguito è riportato un esempio del passaggio Pianifica esportazione pubblico, con la posizione di SAP Commerce Mapping ID evidenziata:

A tale scopo, selezionare ogni segmento, quindi immettere il nome del riferimento personalizzato da SAP Subscription Billing nel campo del connettore di destinazione SAP Commerce Mapping ID. 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.
​>

Se ad esempio il pubblico Experience Platform selezionato è sap_audience1 e si desidera che il relativo stato venga aggiornato nel riferimento personalizzato SAP Subscription Billing SAP_1, specificare questo valore nel campo SAP_Commerce Mapping ID.

Di seguito è riportato un esempio di Reference Type da SAP Subscription Billing:

Di seguito è riportato un esempio del passaggio di esportazione Pianifica pubblico, con un pubblico selezionato e i corrispondenti SAP Commerce Mapping ID evidenziati:

Come mostrato, il valore all'interno del campo Mapping ID deve corrispondere esattamente al valore SAP Subscription Billing Reference Type.

Ripeti questa sezione per ogni pubblico Experience Platform attivato.

In base all’immagine mostrata sopra in cui hai selezionato due tipi di pubblico, la mappatura sarà la seguente:

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 Contacts 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.