Salesforce CRM conexión

Información general overview

Salesforce CRM es una popular plataforma de administración de la relación con los clientes (CRM) y admite los tipos de perfiles que se describen a continuación:

  • Posibles clientes - Un posible cliente es el nombre de una persona o compañía que puede (o no) estar interesada en los productos o servicios que vende.
  • Contactos: un contacto es una persona con la que uno de sus representantes ha establecido una relación y ha sido calificado como cliente potencial.

Este Adobe Experience Platform destino aprovecha Salesforce composite API, que admite ambos tipos de perfiles descritos anteriormente.

Al activar segmentos, puede seleccionar entre posibles clientes o contactos y actualizar atributos y datos de audiencia en Salesforce CRM.

Salesforce CRM utiliza OAuth 2 con concesión de contraseña como mecanismo de autenticación para comunicarse con la API de REST de Salesforce. Las instrucciones para autenticarse en su instancia de Salesforce CRM se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

Como experto en marketing, puede ofrecer experiencias personalizadas a los usuarios en función de los atributos de sus perfiles de Adobe Experience Platform. Puede crear audiencias a partir de los datos sin conexión y enviarlas a Salesforce CRM para actualizar la pertenencia a CRM en cuanto se actualicen las audiencias y los perfiles en Adobe Experience Platform.

Requisitos previos prerequisites

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

Antes de activar datos en el destino de Salesforce CRM, debe tener schema, dataset y segments creados en Experience Platform.

Requisitos previos en Salesforce CRM prerequisites-destination

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

Necesita tener una cuenta de Salesforce prerequisites-account

Vaya a la página Salesforce prueba para registrarse y crear una cuenta de Salesforce, si todavía no la tiene.

Configurar una aplicación conectada en Salesforce prerequisites-connected-app

Primero, debe configurar una Salesforce aplicación conectada dentro de su cuenta de Salesforce, si todavía no la tiene. Salesforce CRM aprovechará la aplicación conectada para conectarse a Salesforce.

A continuación, habilite OAuth Settings for API Integration para Salesforce connected app. Consulte la documentación de Salesforce para obtener instrucciones.

Además, asegúrese de que los ámbitos mencionados a continuación estén seleccionados para Salesforce connected app.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Por último, asegúrese de que la concesión password esté habilitada en su cuenta de Salesforce. Consulte la documentación de Salesforce Flujo de nombre de usuario y contraseña de OAuth 2.0 para escenarios especiales si necesita ayuda.

IMPORTANT
Si el administrador de su cuenta de Salesforce ha restringido el acceso a rangos de IP de confianza, deberá ponerse en contacto con ellos para obtener IP del Experience Platform incluidas en la lista de permitidos. Consulte la documentación de Salesforce Restringir el acceso a rangos de IP fiables para una aplicación conectada si necesita instrucciones adicionales.

Crear campos personalizados en Salesforce prerequisites-custom-field

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

Salesforce CRM requiere este valor para leer e interpretar correctamente las audiencias que llegan del Experience Platform y actualizar su estado de audiencia en Salesforce. 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 CRM, debe crear un campo personalizado del tipo Text Area (Long) en Salesforce. Puede definir la longitud de caracteres de campo de cualquier tamaño entre 256 y 131 072 caracteres según sus necesidades comerciales. Consulte la página de documentación de Salesforce Tipos de campos personalizados para obtener información adicional sobre los tipos de campos personalizados. Consulte también la documentación de Salesforce para crear campos personalizados si necesita ayuda para crear campos.

IMPORTANT
No incluya espacios en blanco en el nombre del campo. En su lugar, utilice el carácter de subrayado (_) como separador.
En Salesforce debe crear campos personalizados 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 campo personalizado denominado crm_2_seg. Al activar una audiencia en este destino, agregue crm_2_seg como ID de asignación para rellenar audiencias de Experience Platform en este campo personalizado.

A continuación se muestra un ejemplo de creación de campo personalizado en Salesforce, Paso 1 - Seleccionar el tipo de datos:
Captura de pantalla de la interfaz de usuario de Salesforce que muestra la creación de campos personalizados, paso 1: seleccione el tipo de datos.

A continuación se muestra un ejemplo de creación de campo personalizado en Salesforce, Paso 2 - Escriba los detalles del campo personalizado:
Captura de pantalla de la interfaz de usuario de Salesforce que muestra la creación de campos personalizados, paso 2: escriba los detalles del campo personalizado.

TIP
  • Para distinguir entre los campos personalizados utilizados para audiencias de Platform y otros campos personalizados dentro de Salesforce, puede incluir un prefijo o sufijo reconocible al crear el campo personalizado. Por ejemplo, en lugar de test_segment, use Adobe_test_segment o test_segment_Adobe
  • Si ya tiene otros campos personalizados creados en Salesforce, puede usar el mismo nombre que el segmento de Platform para identificar fácilmente la audiencia en Salesforce.
NOTE
  • Los objetos de Salesforce están restringidos a 25 campos externos; consulte Atributos de campo personalizados.
  • Esta restricción implica que solo puede tener un máximo de 25 suscripciones a la audiencia de Experience Platform activas en cualquier momento.
  • Si ha alcanzado este límite en Salesforce, debe eliminar los atributos personalizados de Salesforce que se usaron para almacenar el estado de audiencia con audiencias antiguas en Experience Platform antes de poder usar un nuevo ID de asignación.

Recopilar Salesforce CRM credenciales gather-credentials

Observe los elementos siguientes antes de autenticarse en el destino Salesforce CRM:

Credencial
Descripción
Ejemplo
Username
Su nombre de usuario de la cuenta Salesforce.
Password
Contraseña de su cuenta de Salesforce.
Security Token
El token de seguridad Salesforce que adjuntará más adelante al final de su contraseña de Salesforce para crear una cadena concatenada que se utilizará como la contraseña al autenticarse en el destino.
Consulte la documentación de Salesforce para restablecer el token de seguridad para obtener información sobre cómo regenerarlo desde la interfaz de Salesforce si no dispone del token de seguridad.
Custom Domain
Prefijo de dominio Salesforce.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de la interfaz Salesforce.
Si el dominio Salesforce es
d5i000000isb4eak-dev-ed.my.salesforce.com,
necesitará d5i000000isb4eak-dev-ed como valor.
Client ID
Su Salesforce Consumer Key.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de la interfaz Salesforce.
Client Secret
Su Salesforce Consumer Secret.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de la interfaz Salesforce.

Mecanismos de protección guardrails

Salesforce equilibra las cargas de transacción mediante la imposición de límites de solicitud, tasa y tiempo de espera. Consulte Límites y asignaciones de solicitudes de API para obtener detalles.

Si el administrador de cuentas de Salesforce ha impuesto restricciones de IP, tendrá que agregar direcciones IP de Experience Platform a los intervalos de IP de confianza de sus cuentas de Salesforce. Consulte la documentación de Salesforce Restringir el acceso a rangos de IP fiables para una aplicación conectada si necesita instrucciones adicionales.

IMPORTANT
Al activar segmentos, debe seleccionar entre los tipos Contacto o Posible cliente. Debe asegurarse de que las audiencias tengan la asignación de datos adecuada según el tipo seleccionado.

Identidades admitidas supported-identities

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

Identidad de destino
Descripción
Consideraciones
SalesforceId
El identificador Salesforce CRM de las identidades de contacto o posible cliente que exporta o actualiza a través del segmento.
Obligatorio

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 audiencia de Salesforce CRM 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 los permisos de control de acceso de Ver destinos] y Administrar destinos[5}. 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 Salesforce CRM. También puede ubicarlo en la categoría CRM.

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 CRM credenciales para obtener instrucciones.

Credencial
Descripción
Nombre de usuario
Su nombre de usuario de la cuenta Salesforce.
Contraseña
Cadena concatenada compuesta por la contraseña de su cuenta Salesforce anexada al token de seguridad Salesforce.
El valor concatenado adopta la forma de {PASSWORD}{TOKEN}.
Tenga en cuenta que no utilice llaves ni espacios.
Por ejemplo, si la contraseña de Salesforce es MyPa$$w0rd123 y el token de seguridad de Salesforce es TOKEN12345....0000, el valor concatenado que usará en el campo Contraseña es MyPa$$w0rd123TOKEN12345....0000.
Dominio personalizado
Prefijo de dominio Salesforce.
Por ejemplo, si su dominio es d5i000000isb4eak-dev-ed.my.salesforce.com, debe proporcionar d5i000000isb4eak-dev-ed como valor.
ID de cliente
Su Salesforce conectó la aplicación Consumer Key.
Secreto de cliente
Su Salesforce conectó la aplicación Consumer Secret.

Captura de pantalla de IU de Platform que muestra cómo autenticarse.

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.

  • 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 ID de Salesforce:

    • Seleccione Contacto si las identidades que desea exportar o actualizar son del tipo Contacto.
    • Seleccione posible cliente si las identidades que desea exportar o actualizar son del tipo posible cliente.

Captura de pantalla de IU de Platform que muestra los detalles del destino.

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 segmentospara. 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[.
    Seleccione el área de nombres de identidad resaltada en el flujo de trabajo para activar audiencias en los destinos. {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 Salesforce CRM, 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.

Los atributos especificados en el campo de destino deben tener exactamente el nombre descrito en la tabla de asignaciones de atributos, ya que estos atributos formarán el cuerpo de la solicitud.

Los atributos especificados en el campo Source no siguen ninguna restricción de este tipo. Puede asignarlo según sus necesidades; sin embargo, asegúrese de que el formato de los datos de entrada sea válido según la Salesforce documentación. Si los datos de entrada no son válidos, se producirá un error en la llamada de actualización a Salesforce y no se actualizarán los contactos ni los posibles clientes.

Para asignar correctamente los campos XDM a los campos de destino (API) Salesforce CRM, siga estos pasos:

  1. En el paso Asignación, seleccione Agregar nueva asignación, verá una nueva fila de asignación en la pantalla.
    Ejemplo de captura de pantalla de IU de Platform para agregar nueva asignación.

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

  3. En la ventana Seleccionar campo de destino, elija Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos personalizados categoría y seleccione un atributo o defina uno con el campo Nombre de atributo según sea necesario. Consulte la Salesforce CRM documentación para obtener instrucciones sobre los atributos admitidos.

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

    Trabajando con contactos

    • Si está trabajando con Contactos dentro de su segmento, consulte la Referencia de objeto en Salesforce para Contacto para definir asignaciones para los campos que se van a actualizar.

    • Puede identificar los campos obligatorios si busca la palabra Requerido, que se menciona en las descripciones de los campos del vínculo anterior.

    • Según los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Campo de origen Campo de destino Notas
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Apellidos del contacto de hasta 80 caracteres.
      xdm: person.name.firstName Attribute: FirstName Nombre del contacto de hasta 40 caracteres.
      xdm: personalEmail.address Attribute: Email La dirección de correo electrónico del contacto.
    • A continuación se muestra un ejemplo con estas asignaciones:

      Ejemplo de captura de pantalla de IU de Platform que muestra asignaciones de Target.

    Trabajando con posibles clientes

    • Si está trabajando con posibles clientes dentro del segmento, consulte la Referencia de objeto en Salesforce para Posible cliente para definir asignaciones para los campos que se van a actualizar.

    • Puede identificar los campos obligatorios si busca la palabra Requerido, que se menciona en las descripciones de los campos del vínculo anterior.

    • Según los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Campo de origen Campo de destino Notas
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Apellidos del posible cliente de hasta 80 caracteres.
      xdm: b2b.companyName Attribute: Company Mandatory. La compañía del líder.
      xdm: personalEmail.address Attribute: Email La dirección de correo electrónico del posible cliente.
    • A continuación se muestra un ejemplo con estas asignaciones:

      Ejemplo de captura de pantalla de IU de Platform que muestra asignaciones de Target.

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 activadas desde Platform a su campo personalizado correspondiente en Salesforce.

Para ello, seleccione cada segmento y luego introduzca el nombre de campo personalizado de Salesforce en el campo Salesforce CRM ID de asignación. Consulte la sección Crear campos personalizados en Salesforce para obtener instrucciones y prácticas recomendadas sobre la creación de campos personalizados en Salesforce.

Por ejemplo, si el campo personalizado Salesforce es crm_2_seg, especifique este valor en Salesforce CRM Id. de asignación para rellenar audiencias de Experience Platform en este campo personalizado.

A continuación se muestra un ejemplo de campo personalizado de Salesforce:
Salesforce captura de pantalla de la interfaz de usuario que muestra el campo personalizado.

A continuación se muestra un ejemplo que indica la ubicación de Salesforce CRM ID de asignación:
Ejemplo de captura de pantalla de la IU de Platform que muestra Programar exportación de audiencias.

Como se muestra arriba del Salesforce Nombre de campo coincide exactamente con el valor especificado en Salesforce CRM Id. de asignación.

Según el caso de uso, todas las audiencias activadas se pueden asignar al mismo campo personalizado de Salesforce o a diferentes nombres de campo en Salesforce CRM. Un ejemplo típico basado en la imagen mostrada arriba podría ser.

Salesforce CRM nombre de segmento
Salesforce Nombre de campo
Salesforce CRM ID de asignación
crm_1_seg
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

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:

  1. Seleccione Destinos > Examinar para navegar a la lista de destinos.
    Captura de pantalla de IU que muestra destinos de exploración.

  2. Seleccione el destino y valide que el estado es enabled.
    Captura de pantalla de IU de Platform que muestra la ejecución del flujo de datos de destinos.

  3. Cambie a la ficha Datos de activación y, a continuación, seleccione un nombre de audiencia.
    Ejemplo de captura de pantalla de IU de Platform que muestra datos de activación de destinos.

  4. Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento creado dentro del segmento.
    Ejemplo de captura de pantalla de IU de Platform que muestra el segmento.

  5. Finalmente, inicie sesión en el sitio web de Salesforce y valide si los perfiles de la audiencia se han agregado o actualizado.

    Trabajando con contactos

    • Si ha seleccionado Contactos dentro del segmento de Platform, vaya a la página Apps > Contacts.

      Captura de pantalla de Salesforce CRM que muestra la página Contactos con los perfiles del segmento.

    • Seleccione un contacto y compruebe si los campos están actualizados. Puede ver que cada estado de audiencia en Salesforce CRM se actualizó con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado durante la programación de audiencias.

      Captura de pantalla de Salesforce CRM que muestra la página Detalles de contacto con estados de audiencia actualizados.

    Trabajando con posibles clientes

    • Si ha seleccionado posibles clientes dentro del segmento de Platform, vaya a la página Apps > Leads.

      Captura de pantalla de Salesforce CRM que muestra la página de posibles clientes con los perfiles del segmento.

    • Seleccione un posible cliente y compruebe si los campos están actualizados. Puede ver que cada estado de audiencia en Salesforce CRM se actualizó con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado durante la programación de audiencias.

      Captura de pantalla de Salesforce CRM que muestra la página Detalles del posible cliente con estados de audiencia actualizados.

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

    • Para corregir este error, compruebe que la ID. de asignación proporcionada en el flujo de trabajo de activación para el destino Salesforce CRM coincide exactamente con el valor del tipo de campo personalizado que creó en Salesforce. Consulte la sección Crear campos personalizados dentro de Salesforce 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...

Recursos adicionales additional-resources

A continuación encontrará información útil adicional del Portal para desarrolladores de Salesforce:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6