Lado do servidor: implementar o Target

Informações sobre Adobe Target APIs de entrega do lado do servidor, SDKs e Target Recommendations APIs.

NOTE
Se sua implementação usa at.js e AppMeasurement no lado do cliente, você deve usar a API de entrega do Target e os SDKs do lado do servidor discutidos abaixo.
Se sua implementação usa a Adobe Experience Platform Web SDK, você deve usar a Adobe Experience Platform API do Edge Network Server.

O processo a seguir ocorre em uma implementação do lado do servidor do Target:

  1. Um dispositivo cliente faz uma solicitação para uma experiência por meio do servidor.
  2. O servidor envia essa solicitação para o Target.
  3. O Target envia a resposta para o servidor.
  4. O servidor decide qual experiência deve ser entregue ao dispositivo cliente para que seja renderizada.

A experiência não precisa ser exibida em um navegador. A experiência pode ser exibida em um email ou quiosque, por meio de um assistente de voz ou por alguma outra experiência não visual ou dispositivo não baseado em navegador. Como o servidor fica entre o cliente e o Target, esse tipo de implementação também será ideal se você precisar de mais controle e segurança ou de processos de back-end complexos que deseja executar no servidor.

NOTE
Um visitante de primeira vez pode ser inicializado somente no lado do cliente. Um visitante pela primeira vez não pode ser inicializado no lado do servidor. Isso se deve à ECID, que depende do cookie demdex de terceiros e, portanto, precisa ser inicializada por meio da API.js do visitante em uma implementação em que o navegador está envolvido.

As seguintes seções fornecem mais informações sobre as várias APIs e SDKs do lado do servidor:

APIs de entrega no lado do servidor

Link: APIs de entrega no lado do servidor

/rest/v1/delivery

Por meio da API de entrega Target, você pode:

  • Ofereça experiências na Web, incluindo SPAs e canais móveis, bem como dispositivos IoT não baseados em navegador, como TVs conectadas, quiosques ou telas digitais na loja.
  • Fornecer experiências de qualquer plataforma ou aplicativo do lado do servidor que possa fazer chamadas HTTP/s.
  • Forneça experiências consistentes e personalizadas a um visitante, independentemente do canal ou dos dispositivos que o visitante usou para se envolver com sua empresa.
  • Armazene em cache experiências de um visitante em uma sessão no servidor para que várias chamadas de API possam ser evitadas, o que resulta em melhor desempenho.
  • Integre-se perfeitamente aos produtos da Adobe Experience Cloud, como o Adobe Analytics, o Adobe Audience Manager (AAM) e o Serviço da Experience Cloud ID do lado do servidor.

SDKs do servidor

A documentação do SDK do lado do servidor do Adobe Target ajuda a implementar o Target nos servidores no idioma de sua escolha.

Através dos SDKs do lado do servidor do Adobe Target, você pode:

  • Execute e execute os sinalizadores de recursos, implantações e experimentos A/B na latência quase zero.
  • Entregar experiências na web, incluindo SPAs e canais móveis, bem como dispositivos da IoT (Internet das Coisas) não baseados em navegador, como uma TV conectada, um quiosque ou uma tela digital na loja.
  • Forneça experiências personalizadas orientadas por aprendizado de máquina para um usuário, independentemente do canal ou dispositivo com o qual o usuário tenha se envolvido em sua empresa.
  • Integre facilmente com a Adobe Experience Cloud produtos como o Adobe Analytics, o Adobe Audience Manager e o Serviço da Experience Cloud ID do lado do servidor.

Consulte a página Introdução para saber como executar um caso de uso de sinalização de recurso simples via decisão no dispositivo.

Confira nossos Aplicativos de exemplo para se divertir e se divertir!

Target Recommendations APIs

Link: APIs do Target Recommendations e Visão geral da API do Adobe Recommendations.

As APIs do Recommendations permitem interagir programaticamente com Target servidores de recomendações. Essas APIs podem ser integradas a uma variedade de pilhas de aplicativos para executar funções que normalmente seriam realizadas por meio da interface do usuário do Target.

Platform Edge Network chamadas de API sem um SDK platform-edge-api-user-agent

O Adobe Experience Platform Web SDK e outras integrações do SDK com suporte incluem um valor User-Agent semelhante a um navegador nos cabeçalhos de solicitação HTTP ao chamar o Experience Platform Edge Network. As integrações do lado do servidor que usam a API de Interação pública sem uma SDK devem fornecer explicitamente esse cabeçalho.

Para chamadas de API do Interact que não sejam da SDK, observe os seguintes requisitos:

  • Inclua um User-Agent válido, semelhante a um navegador, nos cabeçalhos de solicitação HTTP. Um valor de visitante ou agente-usuário no corpo da solicitação JSON não atende aos requisitos de detecção de bot para esse padrão de integração.
  • Não use valores de espaço reservado ou valores que não sejam do navegador, por exemplo, MyApp/1.0, esses valores podem resultar na classificação de bot.
  • Um nome ou versão do SDK não é necessário para chamadas públicas de API do Edge. Para este cenário, um cabeçalho HTTP User-Agent válido é o elemento necessário.

Quando Target classifica uma solicitação como tráfego de bot, a personalização pode falhar ou parecer intermitente porque a pesquisa de perfil, a avaliação de segmento e o conteúdo personalizado de atividades como Recomendações e Direcionamento automático são suprimidos, conforme descrito abaixo.

Saiba mais sobre como implementar o com a SDK na Adobe Experience Platform Web SDK visão geral.

Exemplo de solicitação de API Interact (os cabeçalhos devem incluir User-Agent):

POST https://edge.adobedc.net/ee/v2/interact?dataStreamId=YOUR_DATASTREAM_ID&requestId=YOUR_REQUEST_ID
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.5 Safari/605.1.15
Accept: */*
Content-Type: text/plain; charset=UTF-8
recommendation-more-help
target-dev-help-dev