Adobe Target Single Profile Update API
O Adobe Target Single Profile Update API permite enviar uma atualização de perfil para um único usuário. O Single Profile Update API é quase idêntico ao Bulk Profile Update API, mas um perfil de visitante é atualizado de cada vez, em linha com a chamada de API em vez de com um arquivo .cvs.
O Single Profile Update API e geralmente é usado 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 Single Profile Update API 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
-
O Single Profile Update API está limitado 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.
-
O Single Profile Update API é uma API de servidor para servidor e não foi projetado 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…\
O Single Profile Update API é 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.
- O GET e o POST são compatíveis.
- O limite de tamanho atual é de 8 KB para o GET e 60 KB para o 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.