Adicionar contactos a uma audiência em massa
Coloca até 200 contactos numa audiência numa só chamada, por endereço. Tal como a adição individual, aceita endereços que já estão no livro do espaço de trabalho e nunca cria um contacto: um endereço que não o é volta em `missing` e nada é escrito para ele, enquanto o resto da chamada segue.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /audiences/{id}/contacts/batch
Coloca até 200 contactos numa audiência numa só chamada, por endereço. Tal como a adição individual, aceita endereços que já estão no livro do espaço de trabalho e nunca cria um contacto: um endereço que não o é volta em missing e nada é escrito para ele, enquanto o resto da chamada segue.
Exemplo
Requer audiences:write. emails leva de 1 a 200 endereços, aparados e em minúsculas antes da correspondência.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added conta as novas associações, unchanged os contactos que já estavam na audiência, e missing lista os endereços que não são contactos, em minúsculas e sem repetições. Guarde-os com POST /contacts, ou envie-os para POST /audiences/{id}/import, que os cria.
Seguro de repetir. Uma segunda chamada idêntica não adiciona nada e indica toda a gente como unchanged. Adicionar à audiência predefinida responde sempre added: 0, porque todos os contactos já lá estão.
Um emails vazio, mais de 200 endereços ou qualquer outra chave no corpo dá um 422, e nada é escrito.