Documentación Experience Platform Guía de destinos

(API) Salesforce Marketing Cloud conexión

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Destinations

Creado para:

Admin
User

Información general overview

(API) Salesforce Marketing Cloud (anteriormente conocido como ExactTarget) es un paquete 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 en 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.

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

Esta Adobe Experience Platform destino utiliza el Salesforce Marketing Cloud actualizar contactos API, que le permite añadir contactos y actualizar datos de contacto para sus necesidades empresariales después de activarlas en un nuevo Salesforce Marketing Cloud segmento.

Salesforce Marketing Cloud utiliza OAuth 2 con credenciales de cliente como mecanismo de autenticación para comunicarse con Salesforce Marketing Cloud API. Instrucciones para autenticarse en su Salesforce Marketing Cloud más abajo, en la sección Autenticar en el destino sección.

Casos de uso use-cases

Para ayudarle a comprender mejor cómo y cuándo debe utilizar el (API) Salesforce Marketing Cloud Destino, este es un ejemplo de caso 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 añadir nuevos contactos o actualizar los existentes (y sus direcciones de correo electrónico) mediante Adobe Experience Platform, cree audiencias a partir de sus propios datos sin conexión y envíelas a Salesforce Marketing Cloud, que se puede utilizar 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 los datos en (API) Salesforce Marketing Cloud destino, debe tener un esquema, a conjunto de datos, y segmentos creado 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 Salesforce Marketing Cloud cuenta:

Necesita tener un Salesforce Marketing Cloud account prerequisites-account

A Salesforce Marketing Cloud cuenta con una suscripción a Marketing Cloud Engagement el producto es obligatorio para continuar.

Póngase en contacto con Salesforce Asistencia si no tiene un Salesforce Marketing Cloud falta el nombre de la cuenta o la cuenta. Marketing Cloud Engagement suscripción del producto.

Creación de atributos en Salesforce Marketing Cloud prerequisites-attribute

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

Salesforce requiere este valor para leer e interpretar correctamente las audiencias que llegan desde Experience Platform y actualizar su estado de audiencia en Salesforce Marketing Cloud. Consulte la documentación del Experience Platform para Grupo de campos de esquema Detalles de pertenencia a audiencia si necesita orientación sobre los estados de audiencia.

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

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

Ejemplo de la pantalla del diseñador de datos en Salesforce Marketing Cloud, en el que añadirá el atributo, se muestra a continuación:
Diseñador de datos de IU de Salesforce Marketing Cloud.

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

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

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

IMPORTANT

En Salesforce Marketing Cloud, debe crear atributos con un NOMBRE DE CAMPO que coincide 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, añada salesforce_mc_segment_1 as ID de asignación para rellenar audiencias de audiencia de Experience Platform en este atributo.

Ejemplo de creación de atributos en Salesforce Marketing Cloud, se muestra a continuación:
Captura de pantalla de la IU 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 guion bajo (_) 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 los 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 utilizar el mismo nombre que el segmento de Platform para identificar fácilmente la audiencia en Salesforce Marketing Cloud.

Asignación de funciones 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 funciones asignadas.

Según las funciones que tenga Salesforce Marketing Cloud Cuando se haya asignado un usuario, también deberá asignar permisos al Salesforce Marketing Cloud extensión de datos que están vinculados a los campos que desea actualizar.

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

IU de Marketing Cloud de Salesforce 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 Marketing Cloud de Salesforce que muestra la extensión de datos de correo electrónico con permisos granulares.

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

Reunir Salesforce Marketing Cloud credenciales gather-credentials

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

Credencial

Descripción

Ejemplo

Subdomain

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

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

ID de cliente

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

r23kxxxxxxx0z05xxxxxx

Secreto de cliente

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

ipxxxxxxxxxxT4xxxxxxxxxxx

Mecanismos de protección guardrails

Salesforce impone ciertas límites de velocidad.
- 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 Salesforce Marketing Cloud Precios de participación página a Descargar el gráfico comparativo de la edición completa como un pdf que detalla los límites impuestos por su plan.
- El Resumen de API La página detalla los límites adicionales.
- Consulte aquí para 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 más información.
- Si ha alcanzado el límite definido para campos personalizados permitidos por objeto dentro Salesforce Marketing Cloud deberá hacer lo siguiente
  - Quite los atributos más antiguos antes de agregar nuevos atributos en Salesforce Marketing Cloud.
  - Actualice o elimine cualquier audiencia activada en destinos de Platform que utilicen estos nombres de atributo antiguos como valor proporcionado para ID de asignación durante la programación de audiencia paso.

Identidades admitidas supported-identities

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

Identidad de destino

Descripción

Consideraciones

contactKey

Salesforce Marketing Cloud Clave de contacto. Consulte la Salesforce Marketing Cloud documentación si necesita orientación adicional.

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 mediante el Experience Platform Servicio de segmentación.

Cargas personalizadas

Audiencias importado 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 perfiles

Está exportando 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 campo.
Cada estado del segmento en Salesforce Marketing Cloud se actualiza con el estado de audiencia correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante la programación de audiencia paso.

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 Administrar destinos permiso de control de acceso. Lea el información general de 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 la sección 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, buscar (API) Salesforce Marketing Cloud. También puede encontrarlo en la sección Marketing por email categoría.

Autenticarse en el destino authenticate

Para autenticarse en el destino, rellene los campos obligatorios a continuación y seleccione Conectar con destino. Consulte la Reunir Salesforce Marketing Cloud credenciales para obtener cualquier guía.

(API) Salesforce Marketing Cloud destino

Salesforce Marketing Cloud

Subdominio

Su Salesforce Marketing Cloud prefijo de dominio.
Por ejemplo, si el dominio es
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
debe proporcionar lo siguiente mcq4jrssqdlyc4lph19nnqgzzs84 como el valor.

ID de cliente

Su Salesforce Marketing Cloud Client ID.

Secreto del cliente

Su Salesforce Marketing Cloud Client Secret.

Captura de pantalla de la 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 un Conectado estado con una marca de verificación verde, 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 la IU de Platform que muestra los detalles del destino.

Nombre: Un nombre con el que 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 de suscripción a alertas de destinos mediante la IU.

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

Activar públicos en este destino activate

IMPORTANT

Para activar los datos, necesita el Ver destinos, Activar destinos, Ver perfiles, y Ver segmentos permisos de control de acceso. Lea el información general de control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
Para exportar identidades, necesita el Ver gráfico de identidad permiso de control de acceso.
{width="100" modal="regular"}

Leer Activación de perfiles y audiencias en destinos de exportación de audiencia 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 a (API) Salesforce Marketing Cloud destino, debe ir a través del 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 (API) Salesforce Marketing Cloud campos de destino, siga los pasos a continuación.

IMPORTANT

Aunque los nombres de atributo deben ser los siguientes Salesforce Marketing Cloud cuenta, las asignaciones para ambos contactKey y personalEmail.address son obligatorios.
La integración con Salesforce Marketing Cloud La API de está sujeta a un límite de paginación en cuanto a la cantidad de atributos que el Experience Platform de puede recuperar de Salesforce. Esto significa que durante la Asignación , el esquema de campo de destino puede mostrar un máximo de 2000 atributos de su cuenta de Salesforce.

En el Asignación paso, seleccione Añadir nueva asignación. Verá una nueva fila de asignación en la pantalla.
En el Seleccionar campo de origen , seleccione la Seleccionar atributos y seleccione el atributo XDM o elija el Seleccionar área de nombres de identidad y seleccione una identidad.

En el Seleccionar campo de destino , seleccione la Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos y seleccione un atributo de las extensiones de datos que se muestran según sea necesario. El (API) Salesforce Marketing Cloud El destino utiliza el Salesforce Marketing Cloud Search Attribute-Set Definitions REST API para recuperar dinámicamente las extensiones de datos y sus atributos vinculados definidos en Salesforce Marketing Cloud. Se muestran en la Campo de destino cuando se configura la variable asignación en el activar flujo de trabajo de audiencias.

Repita estos pasos para agregar las siguientes asignaciones entre el 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` desde el Salesforce Marketing Cloud Email Addresses extensión de datos de.	`Mandatory`, al añadir nuevos contactos.
`xdm: person.name.firstName`	`Attribute: First Name` desde el deseado Salesforce Marketing Cloud extensión de datos de.	-

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 la Programar exportación de audiencias , debe asignar manualmente las audiencias de Platform a la variable atributos in Salesforce Marketing Cloud.

Para ello, seleccione cada segmento e introduzca el nombre del atributo en Salesforce Marketing Cloud en el (API) Salesforce Marketing Cloud ID de asignación field. Consulte la 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 su Salesforce Marketing Cloud el atributo es salesforce_mc_segment_1, especifique este valor en (API) Salesforce Marketing Cloud ID de asignación para rellenar audiencias de audiencia de Experience Platform en este atributo.

Un atributo de ejemplo de Salesforce Marketing Cloud se muestra a continuación:
Captura de pantalla de la IU de Salesforce Marketing Cloud que muestra un atributo.

Ejemplo que indica la ubicación del (API) Salesforce Marketing Cloud ID de asignación se muestra a continuación:
Captura de pantalla de la IU de Platform que muestra Programar exportación de audiencias.

Como se muestra en 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.

Validar exportación de datos exported-data

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

Seleccionar Destinos > Examinar para ir a la lista de destinos.
Seleccione el destino y valide que el estado es activado.
Cambie a la 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 Salesforce Marketing Cloud sitio web. A continuación, vaya a Audience Builder > Contact Builder > All contacts > Email y compruebe si se han añadido los perfiles de la audiencia.
Para comprobar si se han actualizado los perfiles, vaya a Correo electrónico y compruebe si se han actualizado los valores de atributo del perfil de la audiencia. Si se ejecuta correctamente, puede ver que cada estado de audiencia en Salesforce Marketing Cloud se ha actualizado con el estado de audiencia correspondiente de Platform, según el ID de asignación valor proporcionado en la variable programación de audiencia paso.

Uso de datos y gobernanza data-usage-governance

Todo Adobe Experience Platform Los destinos de cumplen con las políticas de uso de datos al gestionar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica la gobernanza de datos. Consulte la Resumen de gobernanza 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 encontrar 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 variable ID de asignación que ha proporcionado en el flujo de trabajo de activación a la (API) Salesforce Marketing Cloud El destino coincide exactamente con el nombre del atributo creado en Salesforce Marketing Cloud. Consulte la Crear atributo en Salesforce Marketing Cloud para obtener instrucciones.
Al activar un segmento, puede obtener un mensaje de error: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- Para solucionar este error, póngase en contacto con su Salesforce Marketing Cloud administrador de cuentas que agregar Direcciones IP del Experience Platform a su Salesforce Marketing Cloud rangos de IP de confianza de las cuentas. Consulte la Salesforce Marketing Cloud Direcciones IP para la inclusión en Listas de permitidos en el Marketing Cloud documentación de si necesita instrucciones adicionales.

Recursos adicionales additional-resources

Salesforce Marketing Cloud API
Salesforce Marketing Cloud documentación explicando 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	Hemos actualizado la Requisitos previos en el Marketing Cloud de Salesforce de (API) y, en general, eliminaba referencias innecesarias a grupos de atributos en todo el documento. Documentación actualizada para indicar que los atributos de los estados de audiencias deben crearse en Salesforce Marketing Cloud dentro de Email Demographics solo extensión de datos de. Hemos actualizado la tabla de asignación en el Consideraciones sobre asignación y ejemplo , la asignación para `Email Address` dentro del atributo `Email Addresses` la extensión de los datos 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 una instrucción y un vínculo de referencia en la Requisitos previos en el Marketing Cloud de Salesforce de (API) para llamar a esa sección Salesforce Marketing Cloud Engagement es una suscripción obligatoria para utilizar este destino. La sección anteriormente indicaba erróneamente que los usuarios necesitaban una suscripción al Marketing Cloud Cuenta Compromiso para continuar. Hemos añadido una sección en requisitos previos para funciones y permisos para asignar al Salesforce usuario para que este destino funcione. (PLATIR-26299)
Febrero de 2023	Actualización de documentación	Hemos actualizado la Requisitos previos en el Marketing Cloud de Salesforce de (API) para incluir un vínculo de referencia que lo llame Salesforce Marketing Cloud Engagement es una suscripción obligatoria para utilizar 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 Requisitos previos en Salesforce para indicar que es necesario crear atributos en la sección Salesforce lado. Esta sección ahora incluye instrucciones detalladas sobre cómo hacerlo y prácticas recomendadas para nombrar los atributos en Salesforce. (PLATIR-25602) Hemos añadido instrucciones claras sobre cómo utilizar el ID de asignación para cada audiencia activada en la programación de audiencia paso. (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