SAP Commerce conexión

SAP Commerce, anteriormente conocido como Hybris, es una solución de plataforma de comercio electrónico basada en la nube para empresas B2B y B2C y está disponible como parte del portafolio de experiencia del cliente de SAP. SAP Facturación de suscripción es un producto del portafolio y permite administrar por completo el ciclo de vida de la suscripción con experiencias de pago y venta simplificadas mediante integraciones estandarizadas.

Este Adobe Experience Platform destino usa la SAP Subscription Billing API de administración de clientes para actualizar los detalles del cliente en SAP Commerce desde una audiencia de Experience Platform existente después de la activación.

Las instrucciones para autenticarse en su instancia de SAP Commerce se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino SAP Commerce, aquí tiene un ejemplo de uso que los clientes de Adobe Experience Platform pueden solucionar mediante este destino.

SAP Commerce clientes almacenan información sobre personas o entidades organizativas que interactúan con su negocio. Su equipo usa los clientes existentes en SAP Commerce para generar las audiencias de Experience Platform. Después de enviar estas audiencias a SAP Commerce, su información se actualiza y a cada cliente se le asigna una propiedad con su valor como nombre de audiencia que indica a qué audiencia pertenece el cliente.

Requisitos previos prerequisites

Consulte las secciones siguientes para conocer los requisitos previos que debe configurar en Experience Platform y SAP Commerce y para obtener información que debe recopilar antes de trabajar con el destino SAP Commerce.

Requisitos previos del Experience Platform prerequisites-in-experience-platform

Antes de activar datos en el destino SAP Commerce, debe tener un esquema, un conjunto de datos y audiencias creados en Experience Platform.

Consulte la documentación del Experience Platform para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Requisitos previos para el destino SAP Commerce prerequisites-destination

Tenga en cuenta los siguientes requisitos previos para exportar datos de Platform a su cuenta de SAP Commerce:

Debe tener una cuenta de SAP Subscription Billing prerequisites-account

Para exportar datos de Platform a su cuenta de SAP Commerce, necesita tener una cuenta de SAP Subscription Billing. Si no tiene una cuenta de facturación válida, comuníquese con el administrador de cuentas de SAP. Consulte el documento SAP Configuración de la plataforma para obtener más información.

Generación de una clave de servicio 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"
}

Crear referencias personalizadas en SAP Subscription Billing prerequisites-custom-reference

Para actualizar el estado de audiencia del Experience Platform en SAP Subscription Billing, necesita un campo de referencia personalizado para cada audiencia seleccionada en Platform.

Para crear las referencias personalizadas, inicia sesión en tu cuenta de SAP Subscription Billing y navega a la página [Datos maestros y configuración] > [Referencias personalizadas]. A continuación, seleccione Crear para agregar una nueva referencia a cada audiencia seleccionada en Platform. Necesitará estos nombres de campo de referencia en el siguiente paso Programar exportación de audiencias y ejemplo.

A continuación se muestra un ejemplo de cómo crear un Tipo de referencia personalizado en SAP Subscription Billing:

Para obtener instrucciones adicionales, consulte la documentación de SAP Subscription Billing referencias personalizadas.

Recopilar credenciales necesarias gather-credentials

Para conectar SAP Commerce al Experience Platform, debe proporcionar valores para las siguientes propiedades de conexión:

Mecanismos de protección guardrails

Las solicitudes de API para SAP Cloud Management service están sujetas a límites de tarifa. Cuando se sobrepase el límite de tasa, se encontrará con un código de estado de respuesta HTTP 429 Too Many Requests

Identidades admitidas supported-identities

SAP Commerce admite la actualización de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Audiencias compatibles supported-audiences

Esta sección describe todas las audiencias que puede exportar a este destino.

Este destino admite la activación de todas las audiencias generadas a través del Experience Platform Servicio de segmentación.

Este destino también admite la activación de las audiencias que se describen en la tabla siguiente.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Conexión al destino connect

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

En destinos > catálogo, busque SAP Commerce. También puede ubicarlo en la categoría comercio electrónico.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la sección Generar una clave de servicio para obtener instrucciones.

Para autenticarse en el destino, seleccione Conectarse al destino.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino activate

Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.

Asignar atributos e identidades map

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino SAP Commerce, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Platform y sus equivalentes correspondientes desde el destino de destino. Para asignar correctamente los campos XDM a los campos de destino SAP Commerce, siga los pasos a continuación:

Asignar la identidad customerNumberSAP

La identidad customerNumberSAP es una asignación obligatoria para este destino. Siga los pasos a continuación para asignarlo:

A continuación, se muestra un ejemplo con la asignación de identidad:

Atributos de asignación

Para agregar cualquier otro atributo que desee actualizar entre el esquema de perfil XDM y la cuenta SAP Subscription Billing, repita los pasos a continuación:

Asignar atributos de mandatory para el tipo de cliente seleccionado

Las asignaciones de atributos obligatorias dependen del tipo de cliente que haya seleccionado. Para asignar los atributos obligatorios, seleccione una de las siguientes opciones:

Asignación de atributos adicionales

A continuación, puede agregar cualquier asignación adicional entre su esquema de perfil XDM y los atributos SAP Subscription Billing schema para un cliente, como se muestra a continuación:

Cuando termine de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.

Programar exportación de audiencias y ejemplo schedule-segment-export-example

Al realizar el paso Programar exportación de audiencias, debe asignar manualmente las audiencias de Platform a los atributos en SAP Subscription Billing.

A continuación se muestra un ejemplo del paso de exportación Programar audiencia con la ubicación de SAP Commerce ID de asignación resaltada:

Para ello, seleccione cada segmento y, a continuación, introduzca el nombre de la referencia personalizada de SAP Subscription Billing en el campo SAP Commerce ID de asignación del conector de destino. Para obtener instrucciones sobre cómo crear referencias personalizadas, consulte la sección Crear referencias personalizadas en SAP Subscription Billing.

IMPORTANT

No utilice la etiqueta de referencia personalizada como valor.

Por ejemplo, si la audiencia de Experience Platform seleccionada es sap_audience1 y desea que su estado se actualice a la referencia personalizada SAP_1 de SAP Subscription Billing, especifique este valor en el campo SAP_Commerce Id. de asignación.

A continuación se muestra un ejemplo Tipo de referencia de SAP Subscription Billing:

A continuación se muestra un ejemplo del paso Programar exportación de audiencias, con una audiencia seleccionada y su correspondiente SAP Commerce ID. de asignación resaltado:

Como se muestra, el valor dentro del campo ID de asignación debe coincidir exactamente con el valor SAP Subscription Billing Tipo de referencia

Repita esta sección para cada audiencia de Platform activada.

En función de la imagen que se muestra arriba, donde ha seleccionado dos audiencias, la asignación sería la siguiente:
| SAP Commerce nombre de audiencia | SAP Subscription Billing Tipo de referencia | Valor de SAP Commerce ID de asignación |
| — | — | — |
| sap_audience1 | SAP_1 | SAP_1 |
| Audiencia SAP2 | SAP_2 | SAP_2 |

Validar exportación de datos exported-data

Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:

Inicie sesión en la cuenta de SAP Subscription Billing y luego vaya a la página Contactos para comprobar los estados de audiencia. La lista se puede configurar para mostrar columnas para las referencias personalizadas y mostrar los estados de audiencia correspondientes.

Uso de datos y gobernanza data-usage-governance

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control de datos.

Errores y solución de problemas errors-and-troubleshooting

Consulte la página de documentación de SAP Subscription Billing Tipos de error para obtener una lista de posibles tipos de error y sus códigos de respuesta.

Recursos adicionales additional-resources

A continuación encontrará información útil adicional de la documentación de SAP:

Changelog

Esta sección recoge la funcionalidad y las actualizaciones significativas de la documentación realizadas en este conector de destino.