SendGrid conexión
Información general overview
SendGrid es una plataforma de comunicación popular entre los clientes para correos electrónicos transaccionales y de marketing.
Este Adobe Experience Platform destino aprovecha SendGrid Marketing Contacts API, lo que le permite exportar los perfiles de correo electrónico de origen y activarlos dentro de una nueva audiencia de SendGrid para sus necesidades comerciales.
SendGrid utiliza tokens de portador de API como mecanismo de autenticación para comunicarse con la API SendGrid.
Requisitos previos prerequisites
Se requieren los siguientes elementos antes de comenzar a configurar el destino.
-
Necesita tener una cuenta de SendGrid.
- Vaya a la página SendGrid signup para registrarse y crear una cuenta de SendGrid, si todavía no la tiene.
-
Después de iniciar sesión en el portal SendGrid, también debe generar un token de API.
-
Vaya al sitio web de SendGrid y acceda a la página Settings > API Keys. También puede consultar la documentación de SendGrid para acceder a la sección apropiada en la aplicación SendGrid.
-
Finalmente, seleccione el botón Create API Key.
- Consulte la documentación de SendGrid si necesita instrucciones sobre qué acciones realizar.
- Si desea generar su clave de API mediante programación, consulte la documentación de SendGrid.
Antes de activar datos en el destino SendGrid, debe tener un esquema, un conjunto de datos y segmentos creados en Experience Platform. Consulte también la sección límites más abajo en esta página.
-
La API SendGrid utilizada para crear la lista de correo a partir de perfiles de correo electrónico requiere que se proporcionen direcciones de correo electrónico únicas dentro de cada perfil. Esto es independiente de si se usa como valor para correo electrónico o correo electrónico alternativo. Dado que la conexión SendGrid admite asignaciones para valores de correo electrónico y de correo electrónico alternativo, asegúrese de que todas las direcciones de correo electrónico utilizadas deban ser únicas dentro de cada perfil del conjunto de datos. De lo contrario, cuando los perfiles de correo electrónico se envíen a SendGrid, el resultado será un error y el perfil de correo electrónico no estará presente en la exportación de datos.
-
Actualmente, no hay ninguna funcionalidad para quitar perfiles de SendGrid cuando se eliminan de audiencias en Experience Platform.
Identidades admitidas supported-identities
SendGrid admite la activación de identidades descritas en la tabla siguiente. Más información sobre identidades.
Tenga en cuenta que SendGrid no admite direcciones de correo electrónico con hash, de modo que solo se envían al destino datos de texto sin transformar.
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.
Casos de uso use-cases
Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino SendGrid, aquí hay ejemplos de casos de uso que los clientes de Experience Platform pueden resolver mediante este destino.
Creación de una lista de marketing para varias actividades de marketing
Los equipos de marketing que utilizan SendGrid pueden crear una lista de correo dentro de SendGrid y rellenarla con direcciones de correo electrónico. La lista de correo ahora creada en SendGrid se puede utilizar posteriormente para varias actividades de marketing.
Conectar con destino connect
Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.
Autenticarse en el destino authenticate
-
En la consola Adobe Experience Platform, vaya a Destinos.
-
Seleccione la ficha Catálogo y busque SendGrid. Luego selecciona Configurar. Después de establecer una conexión con el destino, la etiqueta de la interfaz de usuario cambia a Activar segmentos.
-
Se le mostrará un asistente que le ayudará a configurar el destino de SendGrid. Cree el nuevo destino seleccionando Configurar nuevo destino.
-
Seleccione la opción Nueva cuenta y rellene el valor Token de portador. Este valor es la clave de API de SendGrid mencionada anteriormente en la sección de requisitos previos.
-
Seleccione Conectar con destino. Si la clave de API SendGrid que ha proporcionado es válida, la interfaz de usuario muestra el estado Conectado con una marca de verificación verde, puede continuar con el siguiente paso para rellenar campos de información adicional.
Rellenar detalles de destino destination-details
Mientras configura este destino, debe proporcionar la siguiente información:
- Nombre: Nombre con el que reconocerá este destino en el futuro.
- Descripción: una descripción opcional 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
-
Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
-
Para exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.
Consulte las siguientes imágenes para obtener detalles específicos sobre este destino.
-
Seleccione una o varias audiencias para exportarlas a SendGrid.
-
En el paso Mapping, después de seleccionar Add new mapping, se muestra la página de asignación para asignar los campos XDM de origen a los campos de destino de la API SendGrid. Las siguientes imágenes muestran cómo asignar áreas de nombres de identidad entre Experience Platform y SendGrid. Asegúrese de que el campo de Source Correo electrónico se asigne al campo de destino id_externo, tal y como se muestra a continuación.
-
Del mismo modo, asigne los atributos Adobe Experience Platform deseados que desee exportar al destino SendGrid.
-
Después de completar las asignaciones, seleccione Siguiente para avanzar a la pantalla de revisión.
-
Seleccione Finalizar para completar la instalación.
A continuación se muestra una lista completa de las asignaciones de atributos compatibles que se pueden configurar para la API Agregar o actualizar contacto > Contactos de marketing de SendGrid.
homeAddress.street1
address_line_1
100 caracteres
homeAddress.street2
address_line_2
100 caracteres
_extconndev.alternate_emails
alternate_emails
- Máx.: 5 elementos
- Mín.: 0 elementos
homeAddress.city
city
60 caracteres
homeAddress.country
país
50 caracteres
correo electrónico
external_id
254 caracteres
person.name.firstName
first_name
50 caracteres
person.name.lastName
last_name
50 caracteres
homeAddress.postalCode
postal_code
homeAddress.stateProvince
state_Province_region
50 caracteres
Validar la exportación de datos en SendGrid validate
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 compruebe que el recuento de perfiles corresponde al recuento creado dentro del conjunto de datos.
-
La API SendGrid Marketing Lists > Create List se usa para crear listas de contactos únicas dentro de SendGrid uniendo el valor del atributo list_name y la marca de tiempo de la exportación de datos. Vaya al sitio SendGrid y compruebe si se ha creado la nueva lista de contactos que se ajusta al patrón de nombre.
-
Seleccione la lista de contactos recién creada y compruebe si el nuevo registro de correo electrónico del conjunto de datos que ha creado se está rellenando dentro de la nueva lista de contactos.
-
Además, compruebe también un par de correos electrónicos para validar si la asignación de campos es correcta.
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.
Recursos adicionales additional-resources
Este destino de SendGrid aprovecha las siguientes API:
Límites limits
- La API EnviarCuadrícula Contactos de marketing > Agregar o actualizar contacto puede aceptar 30.000 contactos o 6 MB de datos, el valor que sea menor.