Ajouter des contacts à une audience en masse
Met jusqu'à 200 contacts dans une audience en un seul appel, par adresse. Comme l'ajout unitaire, il prend des adresses déjà présentes dans le carnet de l'espace de travail et ne crée jamais de contact : une adresse qui n'en est pas un revient dans `missing` et rien n'est écrit pour elle, tandis que le reste de l'appel passe quand même.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /audiences/{id}/contacts/batch
Met jusqu'à 200 contacts dans une audience en un seul appel, par adresse. Comme l'ajout unitaire, il prend des adresses déjà présentes dans le carnet de l'espace de travail et ne crée jamais de contact : une adresse qui n'en est pas un revient dans missing et rien n'est écrit pour elle, tandis que le reste de l'appel passe quand même.
Exemple
Nécessite audiences:write. emails contient de 1 à 200 adresses, nettoyées et mises en minuscules avant d'être comparées.
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 compte les nouvelles appartenances, unchanged les contacts qui étaient déjà dans l'audience, et missing liste les adresses qui ne sont pas des contacts, en minuscules et sans doublons. Enregistrez-les avec POST /contacts, ou envoyez-les à POST /audiences/{id}/import, qui les crée.
Peut être rejoué sans risque. Un second appel identique n'ajoute rien et signale tout le monde comme unchanged. Ajouter à l'audience par défaut répond toujours added: 0, car chaque contact y est déjà.
Un emails vide, plus de 200 adresses ou toute autre clé dans le corps donne un 422, et rien n'est écrit.