[Premium]{class="badge positive" title="See what's included in Target Premium."}

Integrar o Recommendations ao email

O Adobe Target oferece suporte à personalização de hora de envio das recomendações de email.

Há três métodos disponíveis para integrar o Target Recommendations ao seu Provedor de serviços de email (ESP). Os recursos do ESP determinam qual método usar. Seu gerente de conta ou consultor pode ajudá-lo a escolher a melhor opção para você.

O uso do método 1 ou do método 2 exige que o ESP faça chamadas para uma API externa com base no cliente/email e aguarde o retorno do conteúdo. Estes métodos não são compatíveis com todos os ESPs; entre em contato com o seu ESP para descobrir se ele é compatível com esse padrão de integração.

O uso do método 3 exige que o ESP participe de uma lista de recomendações por ID de produto ou ID de categoria feita para a sua lista de emails. Este método pode ser baseado em um atributo, como o último produto visualizado, o último produto comprado ou a categoria mais visualizada pelo cliente. No entanto, o ESP deve ter acesso a esses dados em seu perfil de cliente para realizar a associação. Entre em contato com o seu ESP para descobrir se ele tem acesso a esses dados e é compatível com esse padrão de integração.

A personalização de recomendações de tempo aberto não é compatível com o Adobe Target.

Método 1: usar a API de entrega (preferencial) delivery-api

A API de entrega é uma solicitação POST que funciona com o email de tempo de criação. Essa opção é o método preferencial para o email de tempo de criação.

A maioria dos clientes de email não permite solicitações POST; portanto, essa API não é recomendada para os casos de uso de tempo aberto. Alguns clientes de email, como o Gmail ou o Outlook, podem armazenar o conteúdo em cache ou bloquear a imagem e exigir que o recipient permita que ela seja processada.

Não é possível retornar o conteúdo padrão usando a API de entrega.

O código a seguir é um exemplo de solicitação de entrega da 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
}'

Onde clientcode é o código de cliente do Target.

Consulte a Documentação da API de entrega para obter mais informações.

Método 2: usar um modelo de email de rawbox rawbox

Uma rawbox é semelhante a uma solicitação de mbox, mas para ambientes fora da Web, como provedores de serviços de email (ESPs). Como você não tem o Adobe Experience Platform Web SDK ou a at.js para usar em solicitações de rawbox, deve criar suas solicitações manualmente. Os exemplos abaixo explicam como trabalhar com solicitações de rawbox no email.

Essa abordagem permite rastrear o desempenho das recomendações em emails, testá-las da maneira normal com uma recomendação, e continuar a rastrear o site.

Defina uma atividade de Recommendations no Target usando a opção Criador de experiências baseado em formulários. Para o local, selecione o nome da mbox escolhido para usar na solicitação de rawbox proveniente do ESP. Selecione um design com a aparência desejada para o seu email. No momento da criação do email, o ESP faz uma chamada aos servidores do Target para cada rawbox em cada email gerado. Seu ESP deve ter uma maneira de incluir o HTML retornado no email quando ele for enviado.

O sistema de email usado deve ser capaz de lidar com os seguintes cenários:

Uma resposta válida é recebida, mas nenhuma recomendação está presente

O servidor do Target atinge o limite de tempo e retorna sem dados

Exemplo de URL de solicitação

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 obrigatórios: reqparams

Parâmetros opcionais

Possíveis respostas do servidor do Target

Método 3: usar a API de download do Recommendations download-api

Defina uma recomendação como de costume, mas escolha somente download na seção de apresentação ao invés de uma combinação de modelo e mbox. Depois, no ESP, diga ao ESP qual ID de recomendação você criou. O ESP acessa os dados da recomendação por meio de API. Esses dados mostram quais itens devem ser recomendados para determinada categoria ou item-chave, como itens em um carrinho abandonado. O ESP armazena esses dados, conecta-os com sua própria aparência, exibe informações sobre cada item e envia isso por email.

Com essa opção, o servidor de recomendações não poderá acompanhar diretamente o desempenho de uma recomendação ou dividir o tráfego entre múltiplas combinações de algoritmo/modelo. Além disso, as recomendações não estão vinculadas a um perfil de visitante.

Para obter mais informações sobre como baixar a API, consulte APIs herdadas > Baixar.