Premium
See what's included in Target Premium.

Integración de Recommendations con el correo electrónico

Adobe Target admite la personalización en tiempo de envío de recomendaciones en correos electrónicos.

Están disponibles tres métodos para integrar Target Recommendations con su proveedor de servicios de correo electrónico (ESP). Las capacidades de su ESP determinan qué método utilizar. Su administrador de cuentas o asesor puede ayudarle a elegir la opción más adecuada para usted.

Método
Detalles
Método 1: Adobe Target Delivery API (preferido)
Utilice la variable Adobe Target Delivery API para realizar solicitudes de recomendaciones por cliente/por correo electrónico.
Método 2: Adobe Rawbox API
Utilice la variable Adobe Target Rawbox API para realizar solicitudes de recomendaciones por cliente/por correo electrónico.
Método 3: Recommendations Download API
Utilice la API de descarga de Recommendations para solicitar recomendaciones masivas de una lista de productos o categorías en formato CSV.

El uso del método 1 o el método 2 requiere que su ESP realice llamadas a una API externa por cliente o por correo electrónico y espere a que se devuelva el contenido. Estos métodos no son compatibles con todos los ESP; póngase en contacto con su ESP para determinar si es compatible con este patrón de integración.

El uso del método 3 requiere que su ESP adjunte una lista de recomendaciones por ID de producto o ID de categoría a su lista de correos electrónicos. Este método se puede basar en un atributo como el último producto visualizado del cliente, el último producto comprado o la categoría más visitada. Sin embargo, su ESP debe tener acceso a estos datos en su perfil de cliente para poder realizar la unión. Póngase en contacto con su ESP para determinar si tiene acceso a estos datos y si es compatible con este patrón de integración.

La personalización en tiempo abierto de recomendaciones no es compatible con Adobe Target.

IMPORTANT
Las siguientes directrices de capacidad se aplican a los métodos de la API de entrega y de la plantilla de correo electrónico rawbox que se describen a continuación (métodos 1 y 2):
  • Las solicitudes deben estar limitadas a una tasa menor de 1000 solicitudes por segundo o 25 veces el tráfico diario máximo.
  • Tráfico de rampa en pasos de 200 solicitudes por segundo cada minuto.
Póngase en contacto con su administrador de cuentas si desea usar límites de tasa más altos.

Método 1: usar la API de entrega (preferido) delivery-api

La API de envío es una solicitud POST que funciona con la hora de creación de correo electrónico. Esta opción es el método preferido para la hora de creación de correo electrónico.

La mayoría de los clientes de correo electrónico no aceptan solicitudes POST; por tanto, no se recomienda esta API para los casos de uso de hora de apertura. Algunos clientes de correo electrónico, como Gmail o Outlook, podrían guardar el contenido en caché o bloquear la imagen y exigir al destinatario que permita activamente que se muestre la imagen.

No se puede devolver contenido predeterminado mediante la API de envío.

El siguiente código es un ejemplo de solicitud de envío mediante API:

curl -X POST \
  'https://clientcode.tt.omtrdc.net/rest/v1/mbox/?client=clientcode' \
  -H 'authorization: Bearer 3423614b-4843-4664-83c4-c6c3f6c8869b' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "mbox" : "email-mbox",
  "tntId" : "111499796294071-449025.28_44",
  "requestLocation" : {
    "host" : "prod"
  },
   "profileParameters" : {
   },
  "mboxParameters" : {
    "at_property": "b468a242-64a4-32a0-ca0c-890bddd78789",
    "entity.id": "article-123",
    "entity.event.detailsOnly" : "true"
  }
  "contentAsJson":  true
}'

El elemento clientcode es su código de cliente de Target

NOTE
Asegúrese de proporcionar un valor único para sessionId y uno para tntId o thirdPartyId para cada destinatario de correo electrónico (por ejemplo, para cada llamada de API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.

Consulte la documentación de la API de entrega para obtener más información.

Método 2: usar una plantilla de correo electrónico de rawbox rawbox

Un rawbox es parecido a una solicitud de mbox, pero para entornos que no son de web, como los proveedores de servicios de correo electrónico (ESP). Dado que no tiene Adobe Experience Platform Web SDK o at.js para utilizarlos en las solicitudes rawbox, debe crear las solicitudes manualmente. Los siguientes ejemplos explican cómo trabajar con las solicitudes rawbox en los correos electrónicos.

NOTE
Cuando utilice rawbox y Target, consulte el aviso de seguridad importante que encontrará en Creación de listas de hosts con autorización para enviar llamadas de mbox a Target.

Este método permite rastrear el rendimiento de las recomendaciones en los mensajes de correo electrónico, probarlos de manera normal con una recomendación y continuar el rastreo en el sitio.

Configure una actividad de Recommendations en Target utilizando la opción del compositor de experiencias basado en formularios. Para la ubicación, seleccione el nombre del mbox que quiera utilizar en la solicitud rawbox proveniente del ESP. Seleccione un diseño con el aspecto que desee para su correo electrónico. A la hora de crear un correo electrónico, el ESP hace una llamada a los servidores de Target para cada rawbox de los mensajes de correo electrónicos que se generan. Su ESP debe tener algún modo de incluir el HTML devuelto en el correo electrónico cuando este se envía.

El sistema de correo electrónico que utilice debe ser capaz de gestionar las siguientes situaciones:

Se recibe una respuesta, pero no hay ninguna recomendación

  • En este caso, la respuesta será la que esté establecida como valor del parámetro mboxDefault. Consulte la explicación sobre este parámetro más abajo.
  • El proveedor de correo electrónico debe tener un bloqueo HTML predeterminado de recomendaciones para utilizarlo en este caso.

El servidor de Target agota el tiempo de espera y vuelve sin datos

  • En este caso, el servidor de Target devolverá el siguiente contenido:

    //ERROR: application server timeout

  • La aplicación del correo electrónico debe buscar ese texto y poder gestionar el error. El proveedor de correo electrónico tiene varias opciones para solventar este problema:

    • Intente realizar otra llamada del servidor inmediatamente (recomendado, tal vez con un contador de intentos).
    • Envíe ese correo electrónico en concreto y continúe con el siguiente.
    • Ponga en cola ese correo electrónico en concreto y vuelva ejecutar los correos electrónicos erróneos como un lote al final de la primera ejecución.

URL de solicitud de ejemplo

https://client_code.tt.omtrdc.net/m2/client_code/ubox/raw?mbox=mbox_name&mboxSession=1396032094853-955654&mboxPC=1396032094853-955654&mboxXDomain=disabled&entity.event.detailsOnly=true&mboxDefault=nocontent&mboxNoRedirect=1&entity.id=2A229&entity.categoryId=5674

Parámetros necesarios: reqparams

NOTE
Para utilizar Recommendations en correos electrónicos, la llamada de rawbox debe incluir el entity.id, entity.categoryId o ambos, según el tipo de criterios de recomendación. La llamada de ejemplo anterior incluye ambos.
Parámetro
Valor
Descripción
Información general
client_code
client_code
El código del cliente utilizado en Recommendations. Su asesor de Adobe puede facilitarle este valor.
mbox
mboxName
El nombre de mbox que se utiliza para la segmentación.
Misma validación que la de todas las llamadas de mbox.
Límite de 250 caracteres.
No puede contener ninguno de los siguientes caracteres: ', ", %22, %27, <, >, %3C, %3E
mboxXDomain
disabled
Evita que la respuesta establezca una cookie en entornos que no son de web.
entity.id
(Necesario para determinados tipos de criterio: visualización/visualización, visualización/compra, compra/compra)
entity_id
El productId en el que se basa la recomendación, como un producto que se ha dejado en el carro, o en una compra anterior.
Si el criterio lo requiere, la llamada de rawbox debe incluir el entity.id.
entity.event.detailsOnly
true
Si se pasa el entity.id, se recomienda pasar también este parámetro para evitar que la solicitud incremente el número de visualizaciones escrutadas de la página para un elemento y para no distorsionar los algoritmos de productos basados en visualizaciones.
entity.categoryId
(Necesario para determinados tipos de criterio: más vistos por categoría y más vendidos por categoría)
category_id
La categoría en la que se basa la recomendación, como los más vendidos en una categoría.
Si el criterio lo requiere, la llamada de rawbox debe incluir el entity.categoryId.
mboxDefault
https://www.default.com
Si el parámetro mboxNoRedirect no está presente, mboxDefault debe ser una URL absoluta que devuelva el contenido predeterminado si no hay recomendaciones disponibles. Esta URL puede ser una imagen u otro contenido estático.
Si el parámetro mboxNoRedirect está presente, mboxDefault puede ser cualquier texto que indique que no hay recomendaciones, por ejemplo no_content.
El proveedor de correo electrónico debe procesar el caso en el que se devuelve este valor e insertar el HTML predeterminado en el correo electrónico.
Práctica recomendada de seguridad: Tenga en cuenta que si el dominio que se usa en la URL mboxDefault no está incluido en la lista de permitidos, se expone a una posible vulnerabilidad de redireccionamiento abierto. Para evitar el uso no autorizado de vínculos de redirector o mboxDefault de terceros, Adobe le recomienda utilizar “hosts autorizados” en la lista de permitidos de los dominios de URL de redireccionamiento predeterminados. Target usa hosts para la lista de permitidos de dominios a los que desea permitir redirecciones. Para obtener más información, consulte Creación de listas de permitidos que especifiquen hosts con autorización para enviar llamadas de mbox a Target en Hosts.
mboxHost
mbox_host
Este es el dominio que se añade al entorno predeterminado (grupo de hosts) cuando se activa la llamada.
mboxPC
Vacío
(Necesario para recomendaciones que utilizan el perfil de un visitante).
Si no se proporcionó el valor "thirdPartyId", se genera un nuevo tntId que se devuelve como parte de la respuesta. En caso contrario, permanece vacío.
Nota: Asegúrese de proporcionar un valor exclusivo de mboxSession y mboxPC para cada destinatario del correo electrónico (es decir, para cada llamada a la API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.
1 < Longitud < 128
No puede contener más de un “.” (punto).
El único punto permitido es el del sufijo de ubicación del perfil.

Parámetros opcionales

Parámetro
Valor
Descripción
Información general
mboxPC
(Opcional)
mboxPCId
Id de visitante de Target. Utilice este valor si desea rastrear el recorrido completo de un usuario hasta su sitio en varias visitas o cuando utiliza un parámetro de perfil de usuario.
Este valor debe ser el PCID de Adobe Target real del usuario, que se exportaría desde el sitio web a su CRM. El proveedor de correo electrónico recuperaría este ID desde su CRM o desde el Data Warehouse, y lo usaría para el valor de este parámetro.
El valor mboxPC solo es útil para rastrear el comportamiento de visitantes en el sitio en varias visitas para métricas que rastrean si una recomendación es parte de una actividad A/B.
Nota: Asegúrese de proporcionar un valor exclusivo de mboxSession y mboxPC para cada destinatario del correo electrónico (es decir, para cada llamada a la API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.
1 < Longitud < 128
No puede contener más de un “.” (punto).
El único punto permitido es el del sufijo de ubicación del perfil.
mboxNoRedirect
(Opcional)
1
El llamador se redirige de forma predeterminada cuando no se encuentra contenido disponible. Utilícelo para desactivar el comportamiento predeterminado.
mbox3rdPartyId
xxx
Utilice esta opción si tiene su propio ID de visitante personalizado para el direccionamiento de perfiles.

Posibles respuestas del servidor de Target

Respuesta
Descripción
//ERROR:
Generado por el equilibrador de carga cuando no puede devolver contenido.
Correcto
El parámetro mboxNoRedirect se establece en “true” y el servidor no devuelve ninguna recomendación (es decir, no hay coincidencia con el mbox o el caché del servidor no se ha iniciado).
bad request

Falta el parámetro mbox.

  • No se ha especificado el parámetro mboxDefault o el mboxNoRedirect.
  • Se ha especificado el parámetro de solicitud mboxTrace pero no el parámetro mboxNoRedirect.
  • No se ha especificado el parámetro mboxTarget cuando los nombres de mbox terminan con el sufijo -clicked.
Cannot redirect to default content, please specify mboxDefault parameter
No se ha especificado mboxDefault cuando no existe coincidencia con la solicitud y el parámetro mboxNoRedirect no se ha especificado.
Invalid mbox name:= MBOX_NAME
Indica que el parámetro mbox contiene caracteres no válidos.
Mbox name [MBOX_NAME] is too long
Indica que el parámetro mbox sobrepasa los 250 caracteres.

Método 3: usar la API de descarga de Recommendations download-api

Configure una recomendación como de costumbre pero elija descargar solamente en la sección de presentación en lugar de una combinación de plantilla y mbox. Luego en ESP, indíquele al ESP qué ID de recomendación creó. El ESP accede a los datos de la recomendación a través de la API. Estos datos muestran los artículos que deben recomendarse para un artículo clave o una categoría en particular, como los artículos abandonados en el carro de compras. A continuación, el ESP almacena estos datos, los conecta con su propio aspecto y presentación, muestra la información sobre cada artículo y la envía en los mensajes de correo electrónico.

Con esta opción, el servidor de Recommendations no puede rastrear directamente el rendimiento de una recomendación o dividir el tráfico en múltiples combinaciones de algoritmo y plantilla. Además, las recomendaciones no están asociadas a un perfil del visitante.

Para obtener más información sobre la API de descarga, consulte API heredadas > Descargar.

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654