Adobe Target Single Profile Update API
A Adobe Target API de Atualização de Perfil Único permite enviar uma atualização de perfil para um único usuário. A API de Atualização de Perfil Único é quase idêntica à API de Atualização de Perfil em Massa, mas um perfil de visitante é atualizado de cada vez, em linha com a chamada de API em vez de com um arquivo .cvs.
A API de Atualização de Perfil Único e geralmente é usada quando uma atualização deve ocorrer em relação a uma transação que ocorre em um canal que não implementou o Target. Por exemplo, você deseja atualizar o perfil de um único visitante que executa alguma ação offline. As ações podem incluir alcançar uma central de atendimento, um empréstimo é financiado, usar um cartão de fidelidade na loja, acessar um quiosque e assim por diante.
Os benefícios da API de Atualização de Perfil Único incluem:
- Nenhum limite sobre o número de atributos de perfil.
- Os atributos de perfil enviados pelo site podem ser atualizados por meio da API e do oposto.
Avisos
-
A API de Atualização de Perfil Único está limitada a executar 1 milhão de atualizações em qualquer período contínuo de 24 horas.
-
As atualizações geralmente ocorrem em menos de uma hora, mas podem levar até 24 horas para serem refletidas.
Se você precisar enviar mais atualizações ou solicitar que elas sejam processadas em prazos mais curtos, considere enviar atualizações de perfil transacional por atualização do lado do cliente (preferencial) ou pela Adobe Target API de entrega do lado do servidor.
-
A API de Atualização de Perfil Único é uma API de servidor para servidor e não foi projetada para funcionar em uma página da Web. Para atualizar um perfil de visitante na sua página da Web, você pode usar a função trackEvent() ou a API de Entrega.
Formato
Especifique os parâmetros do perfil no formato profile.paramName=value.
Para atualizar o perfil de pcId, use:
https://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01_00&profile.attr=0&profile.attr2=1...
Para atualizar o perfil de um mbox3rdPartyId, use:
shell http://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456&profile.attr=0&profile.attr2=1...
A API de Atualização de Perfil Único é somente para atualizações. Se nada for encontrado, um perfil não será criado.
Notas
- Os parâmetros e valores devem ser codificados em URL usando UTF-8.
- O formato do parâmetro é
profile.paramName. - Nem todos os valores de parâmetro devem existir para todas as pcIds e mbox3rdPartyIds.
- Os parâmetros e valores diferenciam maiúsculas de minúsculas.
- Há suporte para GET e POST.
- O limite de tamanho atual é de 8 KB para GET e 60 KB para POST.
Resposta
Um exemplo de resposta para as solicitações acima tem esta aparência:
trueRequest successfully submitted
Essa resposta indica que a resposta foi enviada e será processada em breve.