Show Menu
TEMAS×

Integrar Recommendations con el correo electrónico

Información acerca del modo de integrar el correo electrónico con Recommendations.
Las funcionalidades del proveedor de servicios de correo electrónico determinan el método que se debe utilizar. Su administrador de cuenta o asesor puede ayudarle a elegir la opción más adecuada para usted.

Opción 1: usar la API de envío

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.
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 exclusivos en estos campos, la respuesta de la API podría ralentizarse o fallar debido al gran número de eventos generados dentro de un solo perfil.
Consulte la documentación de la API de envío para obtener más información.

Opción 2: usar una plantilla de correo electrónico de 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 mbox.js 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 correos electrónicos.
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 Adobe 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 Adobe 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 poder solventar los siguientes problemas:
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 de 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 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:
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. Este 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 necesitará controlar el caso en el que este valor vuelva e inserte el HTML predeterminado en el correo electrónico.
mboxHost
mbox_host
Este es el dominio que se añade al entorno predeterminado (grupo de host) al activar la llamada.
mboxPC
Empty
(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 exclusivos en estos campos, la respuesta de la API podría ralentizarse o fallar 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 necesita ser el PCID de Adobe Target real del usuario, que se exportaría desde el sitio web a su administración de la relación con los clientes. El proveedor de correo electrónico recuperaría este ID desde su administración de relación con los clientes 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 exclusivos en estos campos, la respuesta de la API podría ralentizarse o fallar 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
Utilícelo si tiene su propio ID de visitante personalizado para la segmentación de perfiles.
Posibles respuestas del servidor de Target :
Respuesta
Descripción
//ERROR:
Generado por el equilibrador de carga cuando no puede devolver contenido.
success
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.

Opción 3: Usar la plantilla de solo descarga

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 .