Documentación Experience Platform Guía de destinos

(API) Salesforce Marketing Cloud conexión

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Destinos

Creado para:

Administrador
Usuario

Información general overview

(API) Salesforce Marketing Cloud (anteriormente conocido como ExactTarget) es un grupo de marketing digital que le permite crear y personalizar recorridos para que los visitantes y clientes personalicen su experiencia.

IMPORTANT

Observe la diferencia entre esta conexión y la otra Salesforce Marketing Cloud conexión que existe dentro de la sección Catálogo de marketing de correo electrónico. La otra conexión de Marketing Cloud de Salesforce le permite exportar archivos a una ubicación de almacenamiento especificada, mientras que esta es una conexión de flujo continuo basada en API.

En comparación con Salesforce Marketing Cloud Account Engagement, que está más orientado al marketing B2B, el destino (API) Salesforce Marketing Cloud es ideal para los casos de uso B2C con ciclos de toma de decisiones transaccionales más cortos. Puede consolidar conjuntos de datos más grandes que representen el comportamiento de su audiencia objetivo para ajustar y mejorar las campañas de marketing priorizando y segmentando contactos, especialmente de conjuntos de datos fuera de Salesforce. Tenga en cuenta que el Experience Platform también tiene una conexión para Salesforce Marketing Cloud Account Engagement.

Este Adobe Experience Platform destino usa la API Salesforce Marketing Cloud actualizar contactos, que te permite agregar contactos y actualizar datos de contacto para tus necesidades comerciales después de activarlos en un nuevo segmento Salesforce Marketing Cloud.

Salesforce Marketing Cloud utiliza OAuth 2 con credenciales de cliente como mecanismo de autenticación para comunicarse con la API Salesforce Marketing Cloud. Las instrucciones para autenticarse en su instancia de Salesforce Marketing Cloud 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 (API) Salesforce Marketing Cloud, aquí tiene un ejemplo de uso que los clientes de Adobe Experience Platform pueden solucionar mediante este destino.

Envío de correos electrónicos a contactos para campañas de marketing use-case-send-emails

El departamento de ventas de una plataforma de alquiler de viviendas desea difundir un correo electrónico de marketing a una audiencia de cliente objetivo. El equipo de marketing de la plataforma puede agregar nuevos contactos o actualizar los contactos existentes (y sus direcciones de correo electrónico) a través de Adobe Experience Platform, crear audiencias a partir de sus propios datos sin conexión y enviar estas audiencias a Salesforce Marketing Cloud, que luego se pueden usar para enviar el correo electrónico de la campaña de marketing.

Requisitos previos prerequisites

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

Antes de activar datos en el destino (API) Salesforce Marketing Cloud, debe tener un esquema, un conjunto de datos y segmentos creados en Experience Platform.

Requisitos previos en (API) Salesforce Marketing Cloud prerequisites-destination

Tenga en cuenta los siguientes requisitos previos para exportar datos de Platform a su cuenta de Salesforce Marketing Cloud:

Necesita tener una cuenta de Salesforce Marketing Cloud prerequisites-account

Es obligatorio abrir una cuenta de Salesforce Marketing Cloud con una suscripción al producto Marketing Cloud Engagement para continuar.

Póngase en contacto con Salesforce Soporte técnico si no tiene una cuenta de Salesforce Marketing Cloud o si a su cuenta le falta la suscripción de producto de Marketing Cloud Engagement.

Crear atributos dentro de Salesforce Marketing Cloud prerequisites-attribute

Al activar audiencias en el destino (API) Salesforce Marketing Cloud, debe introducir un valor en el campo ID de asignación para cada audiencia activada, en el paso Programación de audiencias.

Salesforce requiere este valor para leer e interpretar correctamente las audiencias que llegan del Experience Platform y actualizar su estado de audiencia en Salesforce Marketing Cloud. 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.

Para cada audiencia que active desde Platform a Salesforce, debe tener un atributo de tipo Text vinculado a la extensión de datos Email Demographics en Salesforce Marketing Cloud. Use Salesforce Marketing Cloud Contact Builder para crear atributos. Consulte la documentación de Salesforce Marketing Cloud para crear atributos si necesita ayuda para crear atributos.

Los nombres de los campos de atributo se utilizan para el campo de destino (API) Salesforce Marketing Cloud durante el paso Mapping. Puede definir el carácter de campo con un máximo de 4000 caracteres, según sus necesidades comerciales. Consulte la página de documentación Salesforce Marketing Cloud Tipos de datos de extensiones de datos para obtener información adicional sobre los tipos de atributos.

A continuación se muestra un ejemplo de la pantalla del diseñador de datos en Salesforce Marketing Cloud, en la que agregará el atributo:
Diseñador de datos de la interfaz de usuario de Salesforce Marketing Cloud.

A continuación se muestra una vista de un grupo de atributos Salesforce Marketing Cloud Email Data con atributos correspondientes al estado de audiencia dentro de la extensión de datos Email Demographics:
Grupo de atributos de datos de correo electrónico de la IU de Salesforce Marketing Cloud.

El destino (API) Salesforce Marketing Cloud usa la Salesforce Marketing Cloud Search Attribute-Set Definitions REST API para recuperar dinámicamente las extensiones de datos y sus atributos vinculados' definidos dentro de Salesforce Marketing Cloud.

Se muestran en la ventana de selección de Campo de destino al configurar la asignación en el flujo de trabajo para activar audiencias en el destino.

IMPORTANT

En Salesforce Marketing Cloud, debe crear atributos con un NOMBRE DE CAMPO que coincida exactamente con el valor especificado en ID de asignación para cada segmento de Platform activado. Por ejemplo, la captura de pantalla siguiente muestra un atributo denominado salesforce_mc_segment_1. Al activar una audiencia en este destino, agregue salesforce_mc_segment_1 como ID de asignación para rellenar audiencias de Experience Platform en este atributo.

A continuación se muestra un ejemplo de creación de atributos en Salesforce Marketing Cloud:
Captura de pantalla de la interfaz de usuario de Salesforce Marketing Cloud que muestra un atributo.

TIP

Al crear el atributo, no incluya espacios en blanco en el nombre del campo. En su lugar, utilice el carácter de subrayado (_) como separador.
Para distinguir entre atributos utilizados para audiencias de Platform y otros atributos dentro de Salesforce Marketing Cloud, puede incluir un prefijo o sufijo reconocible para los atributos utilizados para segmentos de Adobe. Por ejemplo, en lugar de test_segment, use Adobe_test_segment o test_segment_Adobe.
Si ya ha creado otros atributos en Salesforce Marketing Cloud, puede usar el mismo nombre que el segmento de Platform para identificar fácilmente la audiencia en Salesforce Marketing Cloud.

Asignar roles y permisos de usuario dentro de Salesforce Marketing Cloud prerequisites-roles-permissions

Como Salesforce Marketing Cloud admite funciones personalizadas según el caso de uso, se debe asignar al usuario las funciones relevantes para actualizar los atributos en Salesforce Marketing Cloud. A continuación, se muestra un ejemplo de las funciones asignadas a un usuario:
Interfaz de usuario de Salesforce Marketing Cloud para un usuario seleccionado que muestra sus roles asignados.

Según las funciones que se hayan asignado al usuario Salesforce Marketing Cloud, también deberá asignar permisos a la extensión de datos Salesforce Marketing Cloud que esté vinculada a los campos que desea actualizar.

Dado que este destino requiere acceso a data extension, debe permitirlo. Por ejemplo, para Email data extension, debe permitirlo como se muestra a continuación:

Interfaz de usuario de Salesforce Marketing Cloud que muestra la extensión de datos de correo electrónico con los permisos permitidos.

Para restringir el nivel de acceso, también puede anular el acceso individual mediante privilegios granulares.
Interfaz de usuario de Salesforce Marketing Cloud que muestra la extensión de datos de correo electrónico con permisos granulares.

Consulte las páginas Marketing Cloud Roles y Marketing Cloud Roles and Permissions para obtener instrucciones detalladas.

Recopilar Salesforce Marketing Cloud credenciales gather-credentials

Observe los elementos siguientes antes de autenticarse en el destino (API) Salesforce Marketing Cloud.

Credencial

Descripción

Ejemplo

Subdomain

Consulte Salesforce Marketing Cloud domain prefix para obtener información sobre cómo obtener este valor de la interfaz Salesforce Marketing Cloud.

Si el dominio Salesforce Marketing Cloud es
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
debe proporcionar mcq4jrssqdlyc4lph19nnqgzzs84 como valor.

ID de cliente

Consulte la Salesforce Marketing Cloud documentación para obtener información sobre cómo obtener este valor de la interfaz Salesforce Marketing Cloud.

r23kxxxxxxx0z05xxxxxx

Secreto del cliente

Consulte la Salesforce Marketing Cloud documentación para obtener información sobre cómo obtener este valor de la interfaz Salesforce Marketing Cloud.

ipxxxxxxxxxxT4xxxxxxxxxxx

Mecanismos de protección guardrails

Salesforce impone ciertos límites de tarifa.
- Consulte la Salesforce Marketing Cloud documentación para resolver cualquier límite probable que pueda encontrar y reducir los errores durante la ejecución.
- Consulte la página Salesforce Marketing Cloud Precios de participación para descargar el gráfico comparativo de edición completa como PDF que detalla los límites impuestos por su plan.
- La página Información general de API detalla límites adicionales.
- Consulta aquí para ver una página que recopila estos detalles.
El recuento de campos personalizados permitidos por objeto varía según la edición de Salesforce.
- Consulte la Salesforce documentación para obtener instrucciones adicionales.
- Si ha alcanzado el límite definido de campos personalizados permitidos por objeto en Salesforce Marketing Cloud, deberá
  - Quite los atributos antiguos antes de agregar nuevos atributos en Salesforce Marketing Cloud.
  - Actualice o elimine cualquier audiencia activada en destinos de Platform que usen estos nombres de atributo antiguos como el valor proporcionado para ID de asignación durante el paso programación de audiencias.

Identidades admitidas supported-identities

(API) Salesforce Marketing Cloud admite la activación de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Identidad de destino

Descripción

Consideraciones

contactKey

Clave de contacto Salesforce Marketing Cloud. Consulte la Salesforce Marketing Cloud documentación si necesita más instrucciones.

Obligatorio

Audiencias compatibles supported-audiences

Esta sección describe qué tipos de audiencias puede exportar a este destino.

Origen de audiencia

Admitido

Descripción

Segmentation Service

✓

Audiencias generadas a través del Experience Platform Servicio de segmentación.

Cargas personalizadas

Las audiencias importadas en el Experience Platform desde archivos CSV.

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.

Elemento

Tipo

Notas

Tipo de exportación

Basado en perfil

Va a exportar todos los miembros de un segmento, 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.
Cada estado de segmento de Salesforce Marketing Cloud se actualiza con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado durante el paso programación de audiencia.

Frecuencia de exportación

Transmisión

Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según 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

IMPORTANT

Para conectarse al destino, necesita el permiso Administrar destinos control de acceso. 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 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 (API) Salesforce Marketing Cloud. También puede ubicarlo en la categoría Marketing por correo electrónico.

Autenticarse en el destino authenticate

Para autenticarte en el destino, rellena los campos obligatorios a continuación y selecciona Conectarse al destino. Consulte la sección Recopilar Salesforce Marketing Cloud credenciales para obtener instrucciones.

(API) Salesforce Marketing Cloud destino

Salesforce Marketing Cloud

Subdominio

Prefijo de dominio Salesforce Marketing Cloud.
Por ejemplo, si su dominio es
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
debe proporcionar mcq4jrssqdlyc4lph19nnqgzzs84 como valor.

ID de cliente

Su Salesforce Marketing Cloud Client ID.

Secreto de cliente

Su Salesforce Marketing Cloud Client Secret.

Captura de pantalla de IU de Platform que muestra cómo autenticarse en el Marketing Cloud de Salesforce.

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

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.
Captura de pantalla de IU de Platform que muestra los detalles del destino.

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.

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

IMPORTANT

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

{width="100" modal="regular"}

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.

Consideraciones sobre asignación y ejemplo mapping-considerations-example

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino (API) Salesforce Marketing Cloud, 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 (API) Salesforce Marketing Cloud, siga los pasos a continuación.

IMPORTANT

Aunque los nombres de atributo estarían de acuerdo con su cuenta de Salesforce Marketing Cloud, las asignaciones para contactKey y personalEmail.address son obligatorias.
La integración con la API Salesforce Marketing Cloud está sujeta a un límite de paginación en cuanto a la cantidad de atributos que el Experience Platform puede recuperar de Salesforce. Esto significa que durante el paso Mapping, el esquema del campo de destino puede mostrar un máximo de 2000 atributos desde tu cuenta de Salesforce.

En el paso Asignación, seleccione Agregar nueva asignación. 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 o elija Seleccionar área de nombres de identidad y seleccione una identidad.

En la ventana Seleccionar campo de destino, elija Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos categoría y seleccione un atributo de las extensiones de datos que se muestran según sea necesario. El destino (API) Salesforce Marketing Cloud usa la Salesforce Marketing Cloud Search Attribute-Set Definitions REST API para recuperar dinámicamente las extensiones de datos y sus atributos vinculados' definidos dentro de Salesforce Marketing Cloud. Se muestran en la ventana emergente Campo de destino al configurar la asignación en el flujo de trabajo de activación de audiencias.

Repita estos pasos para agregar las siguientes asignaciones entre su esquema de perfil XDM y (API) Salesforce Marketing Cloud:

table 0-row-3 1-row-3 2-row-3 3-row-3
Campo de origen	Campo de destino	Obligatorio
`IdentityMap: contactKey`	`Identity: salesforceContactKey`	`Mandatory`
`xdm: personalEmail.address`	`Attribute: Email Address` de la extensión de datos Salesforce Marketing Cloud Email Addresses.	`Mandatory`, al agregar nuevos contactos.
`xdm: person.name.firstName`	`Attribute: First Name` de la extensión de datos Salesforce Marketing Cloud deseada.	-

A continuación se muestra un ejemplo con estas asignaciones:

Cuando haya terminado 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 Salesforce Marketing Cloud.

Para ello, seleccione cada segmento y, a continuación, introduzca el nombre del atributo de Salesforce Marketing Cloud en el campo (API) Salesforce Marketing Cloud ID de asignación. Consulte la sección Crear atributo en Salesforce Marketing Cloud para obtener instrucciones y prácticas recomendadas sobre la creación de atributos en Salesforce Marketing Cloud.

Por ejemplo, si el atributo Salesforce Marketing Cloud es salesforce_mc_segment_1, especifique este valor en (API) Salesforce Marketing Cloud Id. de asignación para rellenar audiencias de audiencia del Experience Platform en este atributo.

A continuación se muestra un atributo de ejemplo de Salesforce Marketing Cloud:
Captura de pantalla de la interfaz de usuario de Salesforce Marketing Cloud que muestra un atributo.

A continuación se muestra un ejemplo que indica la ubicación de (API) Salesforce Marketing Cloud ID de asignación:

Ejemplo de captura de pantalla de la IU de Platform que muestra Programar exportación de audiencias.

Como se muestra, el (API) Salesforce Marketing Cloud ID. de asignación debe coincidir exactamente con el valor especificado en Salesforce Marketing Cloud NOMBRE DE CAMPO.

Repita esta sección para cada segmento de Platform activado.

Un ejemplo típico basado en la imagen mostrada arriba podría ser.

(API) Salesforce Marketing Cloud nombre de segmento

Salesforce Marketing Cloud NOMBRE DE CAMPO

(API) Salesforce Marketing Cloud ID de asignación

salesforce mc audience 1

salesforce_mc_segment_1

salesforce mc audience 2

salesforce_mc_segment_2

Validar exportación de datos exported-data

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

Seleccione Destinos > Examinar para navegar a la lista de destinos.
Seleccione el destino y valide que el estado es enabled.
Cambie a la ficha Activation data y, a continuación, seleccione un nombre de audiencia.
Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento creado dentro del segmento.
Inicie sesión en el sitio web Salesforce Marketing Cloud. A continuación, vaya a la página Audience Builder > Contact Builder > All contacts > Email y compruebe si se han agregado los perfiles de la audiencia.
Para comprobar si se han actualizado los perfiles, vaya a la página Correo electrónico y compruebe si se han actualizado los valores de atributo del perfil de la audiencia. Si lo consigue, verá que cada estado de audiencia de Salesforce Marketing Cloud se actualizó con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado en el paso programación de audiencia.

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

Se detectaron errores desconocidos al insertar eventos en el Marketing Cloud de Salesforce unknown-errors

Al comprobar la ejecución de un flujo de datos, puede que aparezca el siguiente mensaje de error: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- Para corregir este error, compruebe que la ID. de asignación proporcionada en el flujo de trabajo de activación para el destino (API) Salesforce Marketing Cloud coincide exactamente con el nombre del atributo que creó en Salesforce Marketing Cloud. Consulte la sección Crear atributo en Salesforce Marketing Cloud para obtener instrucciones.
Al activar un segmento, podría obtener un mensaje de error: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- Para corregir este error, póngase en contacto con el administrador de su cuenta de Salesforce Marketing Cloud para agregar direcciones IP de Experience Platform a los intervalos de IP de confianza de sus cuentas de Salesforce Marketing Cloud. Consulte la documentación de Salesforce Marketing Cloud Direcciones IP para su inclusión en Listas de permitidos del Marketing Cloud si necesita instrucciones adicionales.

Recursos adicionales additional-resources

Salesforce Marketing Cloud API
Salesforce Marketing Cloud documentación que explica cómo se actualizan los contactos con la información especificada.

Changelog changelog

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

Ver registro de cambios

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Mes de lanzamiento	Tipo de actualización	Descripción
Octubre de 2023	Actualización de documentación	Actualizamos la sección Requisitos previos en el Marketing Cloud de Salesforce de (API) y, en general, eliminamos las referencias innecesarias a los grupos de atributos en todo el documento. Se ha actualizado la documentación para indicar que los atributos de los estados de audiencias deben crearse en Salesforce Marketing Cloud dentro de la extensión de datos Email Demographics solamente. Actualizamos la tabla de asignación en la sección Consideraciones sobre la asignación y ejemplo; la asignación del atributo `Email Address` dentro de la extensión de datos `Email Addresses` está marcada como obligatoria; este requisito se mencionó en la llamada marcada como IMPORTANTE pero se omitió de la tabla.
Abril de 2023	Actualización de documentación	Hemos corregido un enunciado y un vínculo de referencia en la sección Requisitos previos en el Marketing Cloud de Salesforce de (API) para llamar a Salesforce Marketing Cloud Engagement, que es una suscripción obligatoria para usar este destino. La sección anteriormente indicaba erróneamente que los usuarios necesitaban una suscripción al acuerdo de Account de Marketing Cloud para continuar. Hemos agregado una sección en requisitos previos para que roles y permisos se asignen al usuario Salesforce para que este destino funcione. (PLATIR-26299)
Febrero de 2023	Actualización de documentación	Actualizamos la sección Requisitos previos en el Marketing Cloud de Salesforce (API) para incluir un vínculo de referencia que indique que Salesforce Marketing Cloud Engagement es una suscripción obligatoria para usar este destino.
Febrero de 2023	Actualización de funcionalidad	Se ha corregido un problema por el cual una configuración incorrecta en el destino provocaba que se enviara un JSON con formato incorrecto a Salesforce. Esto provocaba que algunos usuarios vieran un alto número de identidades con errores en la activación. (PLATIR-26299)
Enero de 2023	Actualización de documentación	Hemos actualizado la sección Requisitos previos en Salesforce para indicar que se deben crear atributos en el lado Salesforce. Esta sección ahora incluye instrucciones detalladas sobre cómo hacerlo y prácticas recomendadas para nombrar los atributos en Salesforce. (PLATIR-25602) Hemos agregado instrucciones claras sobre cómo usar el ID de asignación para cada audiencia activada en el paso programación de audiencias. (PLATIR-25602)
Octubre de 2022	Versión inicial	Versión de destino inicial y publicación de documentación.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6