Importer des contacts dans une audience
L'import CSV de la page de l'audience, par l'API. Chaque adresse bien formée devient un contact si elle n'en est pas déjà un, et toutes arrivent dans cette audience, jusqu'à 500 lignes par appel. Envoyez une liste plus longue en plusieurs appels.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /audiences/{id}/import
L'import CSV de la page de l'audience, par l'API. Chaque adresse bien formée devient un contact si elle n'en est pas déjà un, et toutes arrivent dans cette audience, jusqu'à 500 lignes par appel. Envoyez une liste plus longue en plusieurs appels.
Exemple
Nécessite audiences:write et contacts:write, car l'appel crée des contacts. Chaque ligne est un email et un name facultatif de 200 caractères au plus.
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 compte les nouveaux contacts, added les nouvelles appartenances à cette audience, et skipped les lignes qui n'ont pas été importées. invalid liste les adresses mal formées exactement comme elles ont été envoyées. Un nouveau contact est enregistré en manual et rejoint aussi l'audience par défaut.
Une adresse qui est déjà un contact est réutilisée, jamais dupliquée, et garde son nom : un name ici ne remplit qu'un nom vide. Une adresse supprimée du carnet redevient un contact, et la même adresse deux fois dans un appel compte une seule fois.
Peut être rejoué sans risque : un second appel identique ne crée rien et n'ajoute rien. Rien n'est envoyé à personne et personne n'est abonné à quoi que ce soit.