PREMIUM Recommendations Integrar o com o email

Adobe Target O suporta personalização de tempo de envio de recomendações em email.

Três métodos de integração Target Recommendations com seu Provedor de serviços de email (ESP) estão disponíveis. 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ê.

Método Detalhes
Método 1: Adobe Target Delivery API (Preferencial) Use o Adobe Target Delivery API para fazer solicitações por cliente/por email para recomendações.
Método 2: Adobe Rawbox API Use o Adobe Target Rawbox API para fazer solicitações por cliente/por email para recomendações.
Método 3: Recommendations Download API Use a API de download do Recommendations para solicitar recomendações em massa para uma lista de produtos ou categorias no formato CSV.

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/por email e aguarde o conteúdo ser retornado. Estes métodos não são suportados por todos os PEE; entre em contato com o ESP para determinar 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 à lista de emails. Esse método pode ser baseado em um atributo, como o último produto visualizado do cliente, o último produto comprado ou a categoria mais visualizada. No entanto, seu ESP deve ter acesso a esses dados em seu perfil de cliente para realizar a associação. Entre em contato com o ESP para determinar se ele tem acesso a esses dados e é compatível com esse padrão de integração.

A personalização de tempo aberto de recomendações não é suportada por Adobe Target.

IMPORTANTE

As seguintes diretrizes de capacidade se aplicam à API de entrega e aos métodos de modelo de email rawbox descritos abaixo (métodos 1 e 2):

  • As solicitações devem ser limitadas à taxa mais baixa de 1.000 solicitações por segundo ou 25 vezes o pico de tráfego diário.
  • Aumentar o tráfego em etapas de 200 solicitações por segundo a cada minuto.

Entre em contato com seu gerente de conta se desejar usar limites de taxa mais alta.

Método 1: Usar a API de entrega (preferencial)

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

OBSERVAÇÃO

Certifique-se de fornecer um valor único para ambas sessionId e um dos tntId ou thirdPartyId para cada destinatário de email (por exemplo, para cada chamada de API). Se você não fornecer valores exclusivos para esses campos, a resposta da API poderá ser lenta ou falhar devido ao grande número de eventos gerados em um único perfil.

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

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

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

OBSERVAÇÃO

Ao usar um rawbox e o Target, consulte o aviso de segurança importante em Criar listas de permissões que especificam hosts autorizados a enviar chamadas de mbox para o Target.

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

  • Neste caso, a resposta será o que for definido como o valor do parâmetro mboxDefault. Veja a explicação abaixo sobre este parâmetro.
  • O provedor de email deve ter um bloco HTML padrão de recomendações para usar neste caso.

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

  • Nesse caso, o servidor do Target retorna o seguinte conteúdo:

    //ERROR: application server timeout

  • O aplicativo de email deve procurar esse texto e deve ser capaz de lidar com o erro. O provedor de email tem várias opções para lidar com este caso:

    • Tentar outra chamada de servidor imediatamente (recomendado, talvez com um contador de tentativas).
    • Descartar esse email específico e continuar com o próximo.
    • Colocar esse email específico na fila e executar novamente os emails com falha em lote no final da execução inicial.

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:

OBSERVAÇÃO

Para usar o Recommendations no email, a chamada rawbox geralmente deve incluir entity.id, entity.categoryId ou ambos, dependendo do tipo de critérios de recomendação. O exemplo de chamada acima inclui ambas.

Parâmetro Valor Descrição Validação
client_code client_code O código do cliente usado no Recommendations. Seu consultor da Adobe pode fornecer esse valor.
mbox mboxName O nome da mbox usado para direcionamento. Mesma validação que para todas as chamadas de mbox.
Limite de 250 caracteres.
Não pode conter nenhum dos seguintes caracteres: ', ", %22, %27, <, >, %3C, %3E
mboxXDomain desativado Impede que a resposta configure um cookie em ambientes não-Web.
entity.id
(Obrigatório para determinados tipos de critérios: exibir/exibir, exibir/comprado, comprado/comprado)
entity_id A productId na qual a recomendação se baseia, como um produto abandonado no carrinho ou uma compra anterior.
Se exigido pelos critérios, a chamada de rawbox deve incluir a entity.id.
entity.event.detailsOnly true Se entity.id for transmitido, é altamente recomendável também transmitir esse parâmetro para evitar que a solicitação incremente o número de exibições de página contadas para um item, a fim de não distorcer os algoritmos baseados na visualização do produto.
entity.categoryId
(Obrigatório para determinados tipos de critérios: mais vistos por categoria e mais vendidos por categoria)
category_id A categoria na qual a recomendação se baseia, como os mais vendidos em uma categoria.
Se exigido pelos critérios, a chamada de rawbox deve incluir a entity.categoryId.
mboxDefault https://www.default.com Se o parâmetro mboxNoRedirect não estiver presente, mboxDefault deverá ser um URL absoluto que retornará o conteúdo padrão se nenhuma recomendação estiver disponível. Esse URL pode ser uma imagem ou outro conteúdo estático.
Se o parâmetro mboxNoRedirect estiver presente, mboxDefault poderá ser qualquer texto indicando que não há recomendações, por exemplo no_content.
O provedor de email deve lidar com o caso em que esse valor é retornado e inserir o HTML padrão no email.
Prática recomendada de segurança: se o domínio usado no URL mboxDefault não estiver na lista de permissões, você poderá ser exposto ao risco de uma vulnerabilidade de redirecionamento aberto. Para evitar o uso não autorizado de links redirecionadores ou mboxDefault por terceiros, a Adobe recomenda qusar "hosts autorizados" para permitir a lista de domínios de URL de redirecionamento padrão. O Target usa hosts para a lista de permissões de domínios aos quais você deseja permitir redirecionamentos. Para obter mais informações, consulte Criar lista de permissões que especificam hosts autorizados a enviar chamadas de mbox para o Target em Hosts.
mboxHost mbox_host O domínio adicionado ao ambiente padrão (grupo de hosts) quando a chamada é acionada.
mboxPC Empty (Obrigatório para recomendações que usam o perfil de um visitante.)
Se nenhum "thirdPartyId" for fornecido, um novo tntId será gerado e retornado como parte da resposta. Caso contrário, fica vazio.
Observação: certifique-se de fornecer um valor exclusivo de mboxSession e mboxPC para cada destinatário de email (ou seja, para cada chamada de API). Se você não fornecer valores exclusivos para esses campos, a resposta da API poderá ser lenta ou falhar devido ao grande número de eventos gerados em um único perfil.
1 < Comprimento < 128
Não pode conter mais do que um único “.” (ponto).
O único ponto permitido é para o sufixo de localização do perfil.

Parâmetros opcionais

Parâmetro Valor Descrição Validação
mboxPC
(Opcional)
mboxPCId ID de visitante do Target. Use esse valor quando quiser acompanhar um círculo completo do usuário de volta ao seu site em várias visitas ou ao usar um parâmetro de perfil do usuário.
Esse valor precisa ser o PCID real do Adobe Target para o usuário, que seria exportado do site para o seu CRM O provedor de email recuperaria essa ID do seu CRM ou Data Warehouse e o usaria como o valor desse parâmetro.
O valor mboxPC também é útil para acompanhar o comportamento do visitante no site em várias visitas para o rastreamento de métricas quando uma recomendação fizer parte de uma atividade A/B.
Observação: certifique-se de fornecer um valor exclusivo de mboxSession e mboxPC para cada destinatário de email (ou seja, para cada chamada de API). Se você não fornecer valores exclusivos para esses campos, a resposta da API poderá ser lenta ou falhar devido ao grande número de eventos gerados em um único perfil.
1 < Comprimento < 128
Não pode conter mais do que um único “.” (ponto).
O único ponto permitido é para o sufixo de localização do perfil.
mboxNoRedirect
(Opcional)
1 Por padrão, o chamador é redirecionado quando nenhum conteúdo entregável é encontrado. Use para desativar o comportamento padrão.
mbox3rdPartyId xxx Use essa opção se você tiver sua própria ID de visitante personalizado para usar para direcionamento de perfil.

Possíveis respostas do servidor do Target

Resposta Descrição
//ERROR: Gerado pelo balanceador de carga quando não é capaz de retornar o conteúdo
Sucesso O parâmetro mboxNoRedirect é definido como "true" e o servidor não retorna nenhuma recomendação (ou seja, não há correspondência para a mbox ou o cache do servidor não foi inicializado).
bad request O parâmetro da mbox está ausente.
  • O parâmetro mboxDefault ou mboxNoRedirect não foi especificado.
  • O parâmetro de rastreamento mboxTrace está especificado, mas mboxNoRedirect não está.
  • mboxTargetnão é especificado quando os nomes das mboxes terminam com -clicked sufixo.
Cannot redirect to default content, please specify mboxDefault parameter mboxDefault não especificado quando não existe correspondência para a solicitação e o parâmetro mboxNoRedirect não é especificado.
Invalid mbox name:= MBOX_NAME Indica que o parâmetro da mbox contém caracteres inválidos.
Mbox name [MBOX_NAME] is too long Indica que o parâmetro da mbox excede 250 caracteres.

Método 3: Usar a API de download do Recommendations

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.

Nesta página