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
-
La clave de servicio SAP Commerce le permite acceder a la API SAP Subscription Billing a través del Experience Platform. Consulte SAP Commerce crear una clave de servicio con el identificador de cliente y el secreto de cliente para crear una clave de servicio. SAP Commerce requiere lo siguiente:
- ID de cliente
- Secreto del cliente
- URL. El patrón de la dirección URL es el siguiente:
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
. Este valor se utilizará más adelante para obtener los valores deRegion
yEndpoint
.
code language-json |
---|
|
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:
clientId
de la clave de servicio.clientSecret
de la clave de servicio.url
de la clave de servicio, es similar a https://subscriptionbilling.authentication.eu10.hana.ondemand.com
.url
y tiene un valor similar a eu10
o us10
. Por ejemplo, si url
es https://eu10.revenue.cloud.sap/api
, necesita eu10
.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.
customerNumberSAP
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.
- Va a exportar todos los miembros de una audiencia, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campos.
- Para cada audiencia seleccionada en Platform, el atributo adicional correspondiente SAP Commerce se actualiza con su estado de audiencia de Platform.
- Los destinos de streaming son conexiones basadas en API "siempre activadas". Cuando se actualiza un perfil en Experience Platform en función de la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.
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.
clientId
de la clave de servicio.clientSecret
de la clave de servicio.url
de la clave de servicio, es similar a https://subscriptionbilling.authentication.eu10.hana.ondemand.com
.url
y tiene un valor similar a eu10
o us10
. Por ejemplo, si url
es https://eu10.revenue.cloud.sap/api
, necesita eu10
.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.
- Nombre: Un nombre por el cual reconocerá este destino en el futuro.
- Descripción: Una descripción que le ayudará a identificar este destino en el futuro.
- Tipo de cliente: seleccione Persona o Empresa según las entidades de la audiencia. El SAP Subscription Billing esquema cambia los campos obligatorios según esta selección asignada al atributo
customerType
. Si la selección es Corporativa, las asignaciones obligatorias comofirstName
ylastName
requeridas para un cliente individual se ignorarán ycompany
se volverá obligatorio y viceversa.
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
- Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
- Para exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
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:
- En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
- En la ventana Seleccionar campo de origen, elija Seleccionar área de nombres de identidad y seleccione
customerNumberSAP
.
- En la ventana Seleccionar campo de destino, elija Seleccionar área de nombres de identidad y seleccione la identidad
customerNumber
.
IdentityMap: customerNumberSAP
Identity: customerNumber
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:
- En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
- En la ventana Seleccionar campo de origen, elija la categoría Seleccionar atributos y seleccione el atributo XDM.
- En la ventana Seleccionar campo de destino, elija la categoría Seleccionar atributos personalizados y escriba el nombre del atributo SAP Subscription Billing de la lista de atributos del cliente schema.
country
, donde debería usar countryCode
en su lugar. SAP Subscription Billing admite códigos de país alfa-2 (ISO 3166). El valor distingue entre mayúsculas y minúsculas y debe tener entre 0 y 3 caracteres, por lo que asegúrese de proporcionar exactamente como se definió si no encuentra errores: The country code {} does not exist
o size must be between 0 and 3
.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:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo de origen | Campo de destino | Obligatorio |
xdm: person.lastName |
Attribute: lastName |
Sí |
xdm: workAddress.countryCode |
Attribute: countryCode |
Sí |
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo de origen | Campo de destino | Obligatorio |
xdm: b2b.companyName |
Attribute: company |
Sí |
xdm: workAddress.countryCode |
Attribute: countryCode |
Sí |
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:
table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
---|---|---|
Campo de origen | Campo de destino | Obligatorio |
xdm: person.name.firstName |
Attribute: firstName |
No |
xdm: workAddress.street1 |
Attribute: street |
No |
xdm: workAddress.city |
Attribute: city |
No |
A continuación se muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en las que el cliente es un individuo:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Campo de origen | Campo de destino | Obligatorio |
xdm: workAddress.street1 |
Attribute: street |
No |
xdm: workAddress.city |
Attribute: city |
No |
A continuación se muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en las que el cliente es una empresa:
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.
![Imagen que indica que no debe usar el valor de etiqueta de referencia personalizada para la asignación.](./media_1e8ab7aa5d6d02ba2078cebf94a546a4da1b68d4b.png?width=750&format=png&optimize=medium)
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.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Mes de lanzamiento | Tipo de actualización | Descripción |
Enero de 2024 | Versión inicial | Versión de destino inicial y publicación de documentación. |