Dicas de localização

Visão geral overview

O Adobe Experience Platform Edge Network usa vários servidores distribuídos globalmente para garantir tempos de resposta rápidos, independentemente da localização do usuário final. Ele também usa roteamento baseado em DNS para garantir que as solicitações sejam sempre roteadas para o local do Edge Network mais próximo dos usuários finais.

Se os usuários finais se conectarem a uma VPN ou alternarem tipos de rede em seus dispositivos móveis durante uma sessão, as solicitações de Edge Network poderão ser roteadas para um local diferente. O roteamento de meia sessão entre servidores pode ser problemático, pois as soluções da Adobe Experience Platform e da Adobe Experience Cloud armazenam informações de perfil do usuário final no Edge Network.

É aqui que as dicas de localização são exibidas.

Para garantir que os usuários finais sempre interajam com o servidor regional Edge Network que contém seus dados de perfil atuais, a funcionalidade de dicas de localização garante que todas as solicitações para o Edge Network sejam enviadas para o mesmo servidor onde a primeira solicitação de sessão foi feita. Isso ajuda os usuários a ter uma experiência consistente, independentemente das alterações de rede que possam ocorrer durante uma sessão.

Uso de dicas de localização

As dicas de localização são incluídas na resposta da solicitação de Edge Network inicial e em todas as solicitações subsequentes, como mostrado no exemplo abaixo:

{
   "payload":[
      {
         "scope":"EdgeNetwork",
         "hint":"or2",
         "ttlSeconds":1800
      }
   ],
   "type":"locationHint:result"
}

O escopo EdgeNetwork contém todas as informações relevantes de que o Edge Network precisa para rotear as solicitações subsequentes de acordo. Na resposta da solicitação inicial e de cada solicitação subsequente à rede Edge, haverá uma seção no identificador com um tipo de locationHint:result.

A dica associada ao escopo EdgeNetwork pode conter um dos seguintes valores:

Formato da API

Para garantir que as solicitações subsequentes sejam roteadas corretamente, insira a dica de local no caminho de URL das chamadas de API subsequentes entre o caminho base, normalmente as versões de API ee e v2.

POST 'https://edge.adobedc.net/ee/{LOCATION_HINT}/v2/interact?dataStreamId={DataStream_ID}'

Armazenamento de dicas de localização em cookies storing-hints-in-cookies

Para garantir que a dica de localização retornada pelo Edge Network persista pela duração da sessão, você pode armazenar o valor da dica de localização em um cookie, juntamente com a duração do cookie, contida no campo ttlSeconds (normalmente 1800 segundos).

Como na maioria dos cookies, você deve estender o tempo de vida desse cookie sempre que houver uma resposta do Edge Network. Para garantir compatibilidade máxima com o SDK da Web, use o nome de cookie kndctr_{IMSORG}_AdobeOrg_cluster. As IDs de organização normalmente terminam com @AdobeOrg. O valor @ deve ser convertido em um sublinhado para garantir que o cookie esteja no formato correto.