Usted está aquí:
Conector de API de Salesforce Marketing Cloud para correo electrónico y dispositivos móviles
Salesforce Marketing Cloud es una plataforma para entregar trayectorias relevantes y personalizadas entre canales y dispositivos, permitiendo a los comercializadores la entrega del mensaje correcto en el momento adecuado a lo largo de todas las fases de la relación. Este conector de API puede utilizarse para recuperar datos de correo electrónico desde Email Studio, incluyendo desgloses de dispositivos, navegadores, sistemas operativos, geoubicación y dominios, así como detalles de campañas.
Para obtener más información sobre Marketing Cloud, haga clic aquí.
La API de SFMC extrae datos desde su instancia de Marketing Cloud a través de una extracción de S3. Si esta es la primera vez que Marketing Cloud Intelligence está solicitando esta extracción de datos para su instancia de Marketing Cloud, puede extraer datos de hasta 180 días atrás.
- Canal: Marketing por correo electrónico
- Tipo de transmisión de datos: Mensajería
- Latencia de datos: 1 día
Requisitos
- Para conectar con la API de Salesforce Marketing Cloud, necesita un nombre de usuario y contraseña con acceso de Email Studio y API válidos.
- El usuario debe tener acceso a nivel de empresa.
- El usuario también debe ser un administrador y un administrador de Marketing Cloud.
- Este conector de API admite el siguiente tipo de cuenta:
- Enterprise 1.0
- Enterprise 2.0
- Core o Connect
El usuario debe tener acceso al miembro principal o fallará la autenticación.
- Si desea acceder a datos de Journey Builder, MobileConnect y MobilePush, asegúrese de que tiene acceso de API también a las funciones pertinentes. Si no tiene la información de acceso requerida o encuentra cualquier problema, póngase en contacto con su representante de Marketing Cloud.
Cuando configure sus permisos para Marketing Cloud, bajo Marketing Cloud Intelligence (Datorama), seleccione la casilla de verificación Activar integración de Intelligence (Datorama).
Configuración general
Después de introducir sus credenciales, seleccione la empresa y los miembros (también conocido como Unidades comerciales en Marketing Cloud) para los que desee recuperar datos. Para recuperar los datos para todos los miembros, deje este campo en blanco.
Propiedades extendidas
- Zona horaria - Desde la lista desplegable, seleccione la zona horaria sobre la que desea reportar datos diarios. Se recomienda encarecidamente que establezca la misma zona horaria que se utiliza para Marketing Cloud Enterprise para evitar discrepancias de datos.
- Obtener correos electrónicos de prueba - Seleccione esta casilla de verificación para recuperar mensajes de correo electrónico de prueba además de los datos existentes. Para ver las dimensiones y mediciones recuperadas, consulte Correo electrónico a continuación.
- Obtener datos de trayectoria: Seleccione esta casilla de verificación para recuperar dimensiones enriquecidas de datos de correo electrónico y distribución móvil además de los datos recuperados por la API de forma predeterminada. Para ver las dimensiones y mediciones recuperadas, consulte Trayectoria a continuación.
- Obtener datos de MobileConnect - Seleccione esta casilla de verificación para recuperar datos de SMS procedentes de MobileConnect además de los datos de Correo electrónico recuperados por la API de forma predeterminada. Para ver las dimensiones y mediciones recuperadas, consulte MobileConnect a continuación.
- Obtener datos de MobilePush - Seleccione esta casilla de verificación para recuperar datos de distribución distribuidos procedentes de MobilePush además de los datos de Correo electrónico recuperados por la API de forma predeterminada. Para ver las dimensiones y mediciones recuperadas, consulte MobilePush a continuación.
Mediciones y dimensiones de Marketing Cloud Intelligence disponibles
Las siguientes tablas muestran las mediciones y dimensiones disponibles que se asignarán dependiendo de las casillas de verificación que seleccione en Propiedades extendidas. Marketing Cloud Intelligence extrae automáticamente datos de correo electrónico de forma predeterminada; si desea también extraer datos de Journey Builder, MobileConnect o MobilePush, debe asegurarse de que selecciona la casilla de verificación apropiada en Propiedades extendidas (como se describe anteriormente).
Nota Para campos no asignados, compruebe la relación del campo con el mapa según corresponda. Por ejemplo, si
email namemessage send keyCorreo electrónico
| Origen | Tipo | Asignación |
|---|---|---|
| Fecha de fin de campaña (Fórmula) | Dimensión | Fecha de fin de campaña |
| Clave de campaña | Dimensión | Clave de campaña |
| Nombre de la campaña | Dimensión | Nombre de la campaña |
| Fecha de inicio de campaña (Fórmula) | Dimensión | Fecha de inicio de campaña |
| Estado de campaña | Dimensión | Estado de campaña |
| País | Dimensión | País |
| Fecha de evento | Dimensión | Día |
| Hora de entrega de correo electrónico | Dimensión | Fecha de envío de mensaje |
| Dominio de correo electrónico | Dimensión | Dominio destinatario |
| Correo electrónico desde correo electrónico | Dimensión | Correo electrónico de remitente de envío de correo electrónico |
| Nombre De de correo electrónico | Dimensión | Remitente de envío de mensaje |
| Id. de trabajo de correo electrónico | Dimensión | Clave de envío de mensaje |
| Estado trabajo de correo electrónico | Dimensión | Estado de envío de mensaje |
| Tipo de trabajo de correo electrónico | Dimensión | Tipo de envío de mensaje |
| Nombre del correo electrónico | Dimensión | Nombre de envío de mensaje |
| Preencabezado de correo electrónico | Dimensión | Preencabezado de envío de mensaje |
| Asunto de correo electrónico | Dimensión | Asunto de envío de mensaje |
| Id. de empresa | Dimensión | Id. de empresa de envío de mensaje |
| Nombre de empresa | Dimensión | Empresa de envío de mensaje |
| Id. de miembro | Dimensión | Id. de anunciante de envío de mensaje |
| Nombre de miembro | Dimensión | Anunciante de envío de mensaje |
| Tipo de mensaje | Dimensión | Subtipo de envío de mensaje |
| Región | Dimensión | Región |
| Ciudad | Dimensión | Sin asignar |
| Cliente de correo electrónico | Dimensión | Sin asignar |
| Dispositivo de correo electrónico | Dimensión | Sin asignar |
| Navegador de dispositivo de correo electrónico | Dimensión | Sin asignar |
| Sistema operativo de correo electrónico | Dimensión | Sin asignar |
| Nombre de correo electrónico | Dimensión | Sin asignar |
| Código metropolitano | Dimensión | Sin asignar |
| Devoluciones de correo electrónico | Medición | Devoluciones de mensajes |
| Clics de correo electrónico exclusivos | Medición | Total de clics de mensaje |
| Entregas de correo electrónico (Fórmula) | Medición | Entregas de mensajes |
| Aperturas de correo electrónico exclusivas | Medición | Total de aperturas de mensaje |
| Envíos de correo electrónico | Medición | Envíos de mensajes |
| Anulaciones de suscripción de correo electrónico exclusivas | Medición | Total de anulaciones de suscripción de mensaje |
Nota Mientras que Clics exclusivos, Aperturas exclusivas y Anulaciones de suscripción exclusivas están asignadas a Total de clics de mensaje, Total de aperturas de mensaje y Total de anulaciones de suscripción de mensaje son valores de Mediciones exclusivas.
Mobile Connect
Las siguientes mediciones y dimensiones se recuperan al conectar con su cuenta de Marketing Cloud.
Las siguientes dimensiones y mediciones también se recuperan al seleccionar la casilla de verificación Obtener datos de MobileConnect en Propiedades extendidas.
| Origen | Tipo | Asignación |
|---|---|---|
| Fecha de fin de campaña | Dimensión | Fecha de fin de campaña |
| Clave de campaña | Dimensión | Clave de campaña |
| Nombre de la campaña | Dimensión | Nombre de la campaña |
| Fecha de inicio de campaña | Dimensión | Fecha de inicio de campaña |
| Estado de campaña | Dimensión | Estado de campaña |
| País | Dimensión | País |
| Fecha | Dimensión | Día |
| Id. de empresa | Dimensión | Id. de empresa de envío de mensaje |
| Nombre de empresa | Dimensión | Empresa de envío de mensaje |
| Id. de miembro | Dimensión | Id. de anunciante de envío de mensaje |
| Nombre de miembro | Dimensión | Anunciante de envío de mensaje |
| Tipo de miembro | Dimensión | Subtipo de envío de mensaje |
| Id. de mensaje SMS | Dimensión | Clave de envío de mensaje |
| Nombre de mensaje SMS | Dimensión | Nombre de envío de mensaje |
| Estado de mensaje SMS | Dimensión | Estado de envío de mensaje |
| Texto de mensaje SMS | Dimensión | Contenido de envío de mensaje |
| Tipo de mensaje SMS | Dimensión | Tipo de envío de mensaje |
| Palabra clave de SMS | Dimensión | Sin asignar |
| Origen de SMS | Dimensión | Sin asignar |
| Código corto de SMS | Dimensión | Sin asignar |
| Entregas de SMS (Fórmula) | Medición | Entregas de mensajes |
| SMS sin entregar | Medición | Devoluciones de mensajes |
| Entrantes | Medición | Sin asignar |
| Respuestas salientes de SMS | Medición | Sin asignar |
Trayectoria
Las siguientes dimensiones también se recuperan al seleccionar la casilla de verificación Obtener datos de trayectoria en Propiedades extendidas.
| Origen | Tipo | Asignación |
|---|---|---|
| Nombre de actividad de trayectoria | Dimensión | Nombre de actividad de trayectoria |
| Tipo de actividad de trayectoria | Dimensión | Tipo de actividad de trayectoria |
| Id. de trayectoria + Versión de trayectoria | Dimensión | Clave de trayectoria |
| Nombre de trayectoria | Dimensión | Nombre de trayectoria |
| Estado de trayectoria | Dimensión | Estado de trayectoria |
| Versión de trayectoria | Dimensión | Versión de trayectoria |
| Modo de entrada de contacto | Dimensión | Sin asignar |
| Fecha de creación de trayectoria | Dimensión | Sin asignar |
| Descripción de trayectoria | Dimensión | Sin asignar |
| Fecha de última publicación de trayectoria | Dimensión | Sin asignar |
| Fecha de última modificación de trayectoria | Dimensión | Sin asignar |
MobilePush
Las siguientes dimensiones y mediciones también se recuperan al seleccionar la casilla de verificación Obtener datos de MobilePush en Propiedades extendidas:
| Origen | Tipo | Asignación |
|---|---|---|
| Fecha de fin de campaña | Dimensión | Fecha de fin de campaña |
| Clave de campaña | Dimensión | Clave de campaña |
| Nombre de la campaña | Dimensión | Nombre de la campaña |
| Fecha de inicio de campaña | Dimensión | Fecha de inicio de campaña |
| Estado de campaña | Dimensión | Estado de campaña |
| Fecha | Dimensión | Día |
| Id. de miembro | Dimensión | Id. de anunciante de envío de mensaje |
| Nombre de miembro | Dimensión | Anunciante de envío de mensaje |
| Contenido de mensaje distribuido | Contenido de mensaje distribuido | |
| Tipo de contenido de mensaje distribuido | Dimensión | Tipo de contenido de mensaje distribuido |
| Id. de empresa | Dimensión | Id. de empresa de envío de mensaje |
| Nombre de empresa | Dimensión | Empresa de envío de mensaje |
| Id. de mensaje distribuido | Dimensión | Clave de envío de mensaje |
| Nombre de mensaje distribuido | Dimensión | Nombre de envío de mensaje |
| Estado de mensaje distribuido | Dimensión | Estado de envío de mensaje |
| Tipo de mensaje | Dimensión | Subtipo de envío de mensaje |
| Tipo de mensaje distribuido | Dimensión | Tipo de envío de mensaje |
| Id. de aplicación distribuida | Dimensión | Clave de aplicación de destinatario |
| Id. de dispositivo distribuido | Dimensión | Sin asignar |
| Nombre de dispositivo distribuido | Dimensión | Sin asignar |
| Versión de sistema operativo de dispositivo distribuido | Dimensión | Sin asignar |
| Tipo de dispositivo distribuido | Dimensión | Sin asignar |
| Nombre de geovalla distribuida | Dimensión | Sin asignar |
| Subtítulo de mensaje distribuido | Dimensión | Sin asignar |
| Título de mensaje distribuido | Dimensión | Sin asignar |
| Sistema operativo distribuido | Dimensión | Sin asignar |
| URL de página distribuida | Dimensión | Sin asignar |
| Fallos de mensaje distribuido | Medición | Fallos de mensaje |
| Envíos distribuidos | Medición | Envíos de mensajes |
| Aperturas distribuidas | Medición | Total de aperturas de mensaje |
| Suscripciones distribuidas | Medición | Suscripción |
| Anulaciones de suscripción distribuidas | Medición | Anular suscripción |
| Tiempo de distribución en aplicación | Medición | Tiempo en aplicación |
| Tiempo de distribución en apertura de aplicación | Medición | Sin asignar |
Problemas y limitaciones conocidos
Los metadatos y datos de implicación de correo electrónico, almacenados en la base de datos de Marketing Cloud son solo accesibles para aplicaciones externas, como Marketing Cloud Intelligence a través de extracciones diarias. Marketing Cloud exporta los datos a un depósito de Amazon S3 de manera diaria. La API de Marketing Cloud Intelligence lee entonces los datos desde el depósito de S3, los agrega y los almacena en el modelo de datos de Marketing Cloud Intelligence.
Los datos en el depósito de S3 se eliminan después de 90 días (para cumplir con la normativa RGPD); la eliminación provoca algunas de las limitaciones que se enumeran a continuación:
- Primera vez que se crea una transmisión de datos - La primera vez que crea una transmisión de datos con su cuenta de empresa, se realiza un proceso de aprovisionamiento en segundo plano que permite que su cuenta de Salesforce Marketing Cloud acceda a estos datos. Este proceso podría tardar un par de horas en completarse y puede provocar que la transmisión de datos falle durante la recuperación inicial de los datos con un error específico: Tiempo de espera de recuperación inicial agotado. Puede volver a procesar su transmisión de datos manualmente después de algunas horas o se reprocesará y se arreglará automáticamente al día siguiente.
- Dimensión de fecha de envío - La dimensión de fecha de envío para mensajes de correo electrónico desencadenados (por trayectoria o API) no estará disponible si han transcurrido más de 90 días desde la fecha de envío original. Por ejemplo, si envía un mensaje de correo electrónico para una campaña específica el 1 de enero de 2021 y se abrió o se hizo clic en el 1 de abril de 2021, la dimensión de fecha de envío no estará disponible, de modo que cualquier dato de implicación de esa campaña de correo electrónico no tendrá una fecha de envío ya que han transcurrido 90 días desde la fecha de envío original (1 de enero de 2021). Nota: Esta limitación no afecta a los mensajes de correo electrónico estándar.
- Dimensión de campañas - Existen varias limitaciones a la dimensión de campaña como sigue:
- Los dados de implicación para campañas creadas hace más de 90 días no tienen la información de la campaña.
- En Marketing Cloud puede asignar varias campañas, mientras que en Marketing Cloud Intelligence el modelo de datos solo permite una campaña; si asignó varias campañas, Marketing Cloud Intelligence selecciona la primera.
- Si el código de campaña cambia después de que se establezca la primera vez, Marketing Cloud Intelligence no reflejará ese cambio.
- Los datos de campaña no se rellenan si la campaña se asigna al correo electrónico después de enviarse.
- Definición de mensaje de MobileConnect - Los mensajes pueden crearse más de 90 días antes de enviarse; en un caso como este, la información del mensaje adjunta a las mediciones no estará disponible. Por ejemplo, la información del mensaje adjunta a la medición, como Nombre de mensaje no estará disponible.
- MobileConnect y Trayectoria: Los datos de trayectoria no se extraen para datos de MobileConnect. Todas las trayectorias aparece como "Trayectoria predeterminada" o "N/A".
- Geoubicación - La geoubicación está derivada de la dirección IP. Los derechos de consumidores (RGPD) pueden bloquear la creación de informes de la dirección IP, haciendo que los datos que tiene sobre geoubicación estén incompletos. Otro problema común con la precisión de las geoubicaciones es el uso de VPN y servidores proxy que pueden provocar que la dirección IP no sea fiable e imprecisa al determinar la geoubicación.
Nota La geoubicación solo está disponible para mediciones de implicación.
- Contenido con caracteres especiales - Cuando los archivos contienen caracteres especiales (no ASCII) como por ejemplo del español o el japonés, cualquier dato que contenga múltiples líneas podría fallar durante el análisis. Cuando utilice caracteres no ingleses, se recomienda que marque la casilla de verificación Desactivar análisis múltiples y Activar análisis no ASCII. Esta casilla de verificación analiza caracteres no ingleses, pero no puede analizar varias líneas, de modo que solo extrae la primera línea de cada campo.
Cómo realizar controles de calidad de sus datos
Para Informes de Intelligence para Engagement, complete los siguientes pasos:
- Vaya a Marketing Cloud Report Builder.
- Navegue a: Analytics Builder > Informes de Marketing Cloud Intelligence > Tablas dinámicas
- Compare los totales de mensajes de correo electrónico específicos entre Marketing Cloud Intelligence e Informes de Intelligence para Engagement.
Prácticas recomendadas de configuración de Marketing Cloud
Para una vista óptima de sus datos de Marketing Cloud Intelligence, tenga en cuenta estas mejores prácticas:
- Evite los caracteres especiales. Los caracteres especiales y los emojis no se admiten en Marketing Cloud. Se sustituyen por el carácter de sustitución
- Cree un código de campaña exclusivo. El código de campaña desde Marketing Cloud se asignará a Clave de campaña en Marketing Cloud Intelligence y la clave deberá ser exclusiva para garantizar una agregación de datos adecuada.
- Después de establecer un Código de campaña, no lo cambie. El Código de campaña en MC es un campo de formato libre que puede cambiarse manualmente después de introducirse. Si el Código de campaña cambia después de que se establezca por primera vez, el cambio no se reflejará.
- Asigne la Clave de campaña y el Nombre antes de enviar el correo electrónico. Los datos de campaña no se rellenan si la campaña se asigna al correo electrónico después de enviarse.
- Asigne solo una campaña por mensaje. El modelo de datos de Marketing Cloud Intelligence solo puede vincular un mensaje a una Clave de campaña.
- Debido a los matices de Nombre de campaña, lo mejor es aprovechar el Nombre de envío de mensaje para cualquier convención de nomenclatura.
¿Resolvió este artículo su problema?
¡Háganos saber cómo podemos mejorar!
