Editar Contacto
atenção
Antes de utilizar as operações de manipulação de contactos de Audiência é necessário primeiro criar uma Audiência para a sua Organização, via plataforma Arpoone. Esta opção está disponível no menu: Audiência > Criar Audiência
A edição de um contacto contacto da audiência de uma organização pode ser feita através de dois endpoints:
- identificação de contacto (recipient) por campo recipientId no URL do pedido
- identificação de contacto (recipient) por conjunto de campos-chave audienceKeyFields no corpo do pedido
O corpo do pedido deve conter um objecto recipient onde os campos tags e subscriptions são opcionais e os seus campos do array fields estão em conformidade com o schema de audiência.
A edição de campos segue a seguinte estratégia:
- No caso do campo
fields, campos de audiência já existentes no recipient serão atualizados, ao passo que campos não existentes serão criados (desde que compatíveis com o schema de audiência). O camponamede cada objecto emfieldsidentifica o campo da audiência a ser actualizado; - Os valores de
tagsserão introduzido no campotagsdo recipient, ou adicionados a um array detagsjá existente; - Os valores de
subscriptionsserão introduzidos no camposubscriptionsdo recipient, sobrepondo-se a subscrições anteriores.
Não é possível atualizar os valores de campos chave da audiência – tal situação resulta num erro com HTTP Status Code 400 – Bad Request