SAP Commerce conexão

SAP Commerce, anteriormente conhecido como Hybris, é uma solução de plataforma de comércio eletrônico baseada em nuvem para empresas B2B e B2C e está disponível como parte do portfólio SAP Customer Experience. O SAP Cobrança de assinatura é um produto do portfólio e permite o gerenciamento completo do ciclo de vida da assinatura com vendas simplificadas e experiências de pagamento por meio de integrações padronizadas.

Este Adobe Experience Platform destino usa a SAP Subscription Billing API de gerenciamento de clientes para atualizar os detalhes do cliente no SAP Commerce de um público-alvo existente da Experience Platform após a ativação.

As instruções para autenticar na sua instância do SAP Commerce estão mais abaixo, na seção Autenticar no destino.

Casos de uso use-cases

Para ajudá-lo a entender melhor como e quando você deve usar o destino SAP Commerce, veja um exemplo de caso de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.

SAP Commerce clientes armazenam informações sobre indivíduos ou entidades organizacionais que interagem com sua empresa. Sua equipe usa os clientes existentes no SAP Commerce para criar os públicos-alvo da Experience Platform. Depois de enviar esses públicos-alvo para SAP Commerce, suas informações são atualizadas e cada cliente recebe uma propriedade com seu valor como o nome do público-alvo que indica a qual público-alvo o cliente pertence.

Pré-requisitos prerequisites

Consulte as seções abaixo para quaisquer pré-requisitos que você deve configurar no Experience Platform e SAP Commerce e para obter informações que você deve coletar antes de trabalhar com o destino SAP Commerce.

Pré-requisitos do Experience Platform prerequisites-in-experience-platform

Antes de ativar dados para o destino SAP Commerce, você deve ter um esquema, um conjunto de dados e públicos-alvo criados em Experience Platform.

Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.

Pré-requisitos para o destino SAP Commerce prerequisites-destination

Observe os seguintes pré-requisitos para exportar dados do Experience Platform para sua conta do SAP Commerce:

Você deve ter uma conta SAP Subscription Billing prerequisites-account

Para exportar dados do Experience Platform para sua conta SAP Commerce, você precisa ter uma conta SAP Subscription Billing. Se você não tiver uma conta de cobrança válida, contate o gerente de conta do SAP. Consulte o documento SAP Configuração da plataforma para obter detalhes adicionais.

Gerar uma chave de serviço 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"
}

Criar referências personalizadas em SAP Subscription Billing prerequisites-custom-reference

Para atualizar o status do público-alvo do Experience Platform em SAP Subscription Billing, você precisa de um campo de referência personalizado para cada público-alvo selecionado no Experience Platform.

Para criar as referências personalizadas, faça logon na sua conta do SAP Subscription Billing e navegue até a página [Dados e Configuração Principais] > [Referências Personalizadas]. Em seguida, selecione Criar para adicionar uma nova referência para cada público selecionado no Experience Platform. Você precisará desses nomes de campos de referência na próxima etapa Agendar exportação de público-alvo e exemplo.

Um exemplo de como criar um Tipo de Referência personalizado em SAP Subscription Billing é mostrado abaixo:

Para obter orientação adicional, consulte a documentação de SAP Subscription Billing referências personalizadas.

Coletar credenciais necessárias gather-credentials

Para conectar SAP Commerce ao Experience Platform, você deve fornecer valores para as seguintes propriedades de conexão:

Medidas de proteção guardrails

As solicitações de API para SAP Cloud Management service estão sujeitas a Limites de Taxa. Quando o limite de taxa for excedido, você encontrará um código de status de resposta HTTP 429 Too Many Requests.

Identidades suportadas supported-identities

SAP Commerce oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Públicos-alvo compatíveis supported-audiences

Esta seção descreve todos os públicos-alvo que você pode exportar para esse destino.

Este destino dá suporte à ativação de todos os públicos-alvo gerados pelo Serviço de Segmentação da Experience Platform.

Esse destino também suporta a ativação dos públicos-alvo descritos na tabela abaixo.

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Conectar ao destino connect

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Em Destinos > Catálogo, procure por SAP Commerce. Como alternativa, você pode localizá-lo na categoria eCommerce.

Autenticar para o destino authenticate

Preencha os campos obrigatórios abaixo. Consulte a seção Gerar uma chave de serviço para obter qualquer orientação.

Para autenticar no destino, selecione Conectar ao destino.

Se os detalhes fornecidos forem válidos, a interface exibirá um status Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.

Mapear atributos e identidades map

Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino SAP Commerce, passe pela etapa de mapeamento de campos. O mapeamento consiste na criação de um link entre os campos do esquema do Experience Data Model (XDM) na sua conta do Experience Platform e seus equivalentes correspondentes no destino. Para mapear corretamente os campos XDM para os campos de destino SAP Commerce, siga as etapas abaixo:

Mapear a identidade customerNumberSAP

A identidade customerNumberSAP é um mapeamento obrigatório para este destino. Siga as etapas abaixo para mapeá-la:

Um exemplo com o mapeamento de identidade é mostrado abaixo:

Mapeamento de atributos

Para adicionar outros atributos que você deseja atualizar entre o esquema de perfil XDM e a conta SAP Subscription Billing, repita as etapas abaixo:

Mapear mandatory atributos para o tipo de cliente selecionado

Os mapeamentos de atributos obrigatórios dependem do Tipo de Cliente que você selecionou. Para mapear os atributos obrigatórios, selecione uma das opções abaixo:

Mapeamento de atributos adicionais

Em seguida, você pode adicionar mapeamentos adicionais entre o esquema de perfil XDM e os atributos de SAP Subscription Billing esquema para um cliente, conforme mostrado abaixo:

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Avançar.

Agendar exportação de público e exemplo schedule-segment-export-example

Ao executar a etapa Agendar exportação de público-alvo, mapeie manualmente os públicos-alvo do Experience Platform para os atributos em SAP Subscription Billing.

Um exemplo da etapa de exportação Agendar público-alvo, com o local destacado da SAP Commerce ID de Mapeamento, é mostrado abaixo:

Para fazer isso, selecione cada segmento e digite o nome da referência personalizada de SAP Subscription Billing no campo do conector de destino SAP Commerce ID de mapeamento. Para obter orientação sobre como criar referências personalizadas, consulte a seção Criar referências personalizadas em SAP Subscription Billing.

IMPORTANT

Não use o rótulo de referência personalizado como o valor.

Por exemplo, se a audiência selecionada do Experience Platform for sap_audience1 e você quiser que seu status seja atualizado para a SAP Subscription Billing referência personalizada SAP_1, especifique esse valor no campo SAP_Commerce ID de Mapeamento.

Um exemplo Tipo de Referência de SAP Subscription Billing é mostrado abaixo:

Um exemplo da etapa Programar exportação de público-alvo, com um público-alvo selecionado e sua SAP Commerce ID de Mapeamento correspondente destacada, é mostrado abaixo:

Conforme mostrado, o valor no campo ID de Mapeamento deve corresponder exatamente ao valor SAP Subscription Billing Tipo de Referência.

Repita esta seção para cada público-alvo ativado do Experience Platform.

Com base na imagem mostrada acima em que você selecionou dois públicos-alvo, o mapeamento seria o seguinte:

Validar exportação de dados exported-data

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

Faça logon na conta SAP Subscription Billing e navegue até a página Contatos para verificar o status do público-alvo. A lista pode ser configurada para exibir colunas para as referências personalizadas e exibir os status de público correspondentes.

Uso e governança de dados data-usage-governance

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a visão geral da Governança de Dados.

Erros e solução de problemas errors-and-troubleshooting

Consulte a página de documentação SAP Subscription Billing Tipos de erro para obter uma lista de tipos de erro possíveis e seus códigos de resposta.

Recursos adicionais additional-resources

Informações adicionais úteis da documentação do SAP estão abaixo:

Changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.