Importar contactos para uma audiência
A importação CSV da página da audiência, através da API. Cada endereço bem formado torna-se um contacto se ainda não o for, e todos vão parar a esta audiência, até 500 linhas por chamada. Envie uma lista mais longa em várias chamadas.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /audiences/{id}/import
A importação CSV da página da audiência, através da API. Cada endereço bem formado torna-se um contacto se ainda não o for, e todos vão parar a esta audiência, até 500 linhas por chamada. Envie uma lista mais longa em várias chamadas.
Exemplo
Requer audiences:write e contacts:write, porque cria contactos. Cada linha é um email e um name opcional com até 200 caracteres.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{ "contacts": [ { "email": "[email protected]", "name": "Grace Hopper" }, { "email": "[email protected]", "name": "Katherine Johnson" }, { "email": "not-an-address" } ]}'{ "object": "audience_import", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "created": 1, "added": 1, "skipped": 1, "invalid": ["not-an-address"]}created conta os novos contactos, added as novas associações nesta audiência, e skipped as linhas que não foram importadas. invalid lista os endereços mal formados exatamente como foram enviados. Um contacto novo é guardado como manual e também entra na audiência predefinida.
Um endereço que já é contacto é reutilizado, nunca duplicado, e mantém o nome: um name aqui só preenche um que estava vazio. Um endereço que foi apagado do livro volta a ser contacto, e o mesmo endereço duas vezes numa chamada conta uma vez.
Seguro de repetir: uma segunda chamada idêntica não cria nem adiciona nada. Nada é enviado a ninguém e ninguém fica subscrito a coisa nenhuma.