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

{
    "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:

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:

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

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.

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.

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

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:

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 dal Tipo di cliente selezionato. 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 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.

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