Импорт контактов в аудиторию
Импорт CSV со страницы аудитории, через API. Каждый корректный адрес становится контактом, если ещё им не является, и все попадают в эту аудиторию, до 500 строк за вызов. Более длинный список отправляйте несколькими вызовами.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
POST /audiences/{id}/import
Импорт CSV со страницы аудитории, через API. Каждый корректный адрес становится контактом, если ещё им не является, и все попадают в эту аудиторию, до 500 строк за вызов. Более длинный список отправляйте несколькими вызовами.
Пример
Требует audiences:write и contacts:write, потому что создаёт контакты. Каждая строка — это email и необязательное name длиной до 200 символов.
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 считает новые контакты, added — новые членства в этой аудитории, а skipped — строки, которые не были импортированы. invalid перечисляет некорректные адреса ровно в том виде, в каком они были отправлены. Новый контакт сохраняется как manual и тоже вступает в аудиторию по умолчанию.
Адрес, который уже является контактом, используется повторно, никогда не дублируется и сохраняет своё имя: name здесь заполняет только пустое. Адрес, удалённый из книги, снова становится контактом, а один и тот же адрес дважды в одном вызове считается один раз.
Повтор безопасен: второй такой же вызов ничего не создаёт и ничего не добавляет. Никому ничего не отправляется, и никто ни на что не подписывается.