#195: Загрузка действий по промокодам через файл

Загрузка действий по промокодам через файл

Cтатья предназначена для рекламодателей, у которых не настроена автоматическая отправка информации о целевых действиях, выполненных с использованием промокодов, которые закрепляются за конкретными веб-мастерами.

В этом случае вам нужно регулярно передавать данные о целевых действиях путем загрузки файла в разделе «Загрузка действий по промокодам» (меню → Финансы → Загрузка действий по промокодам).

Чем чаще вы передаете эти данные, тем более привлекательной и надежной ваша программа выглядит для веб-мастеров, и в результате они стараются привлечь для вас больше заказов и клиентов.

Вы можете автоматизировать отправку данных по промокодам. Для этого нужно настроить интеграцию вашей системы с платформой Admitad. Чтобы узнать подробности, свяжитесь с поддержкой support@admitad.com или вашим менеджером.

Порядок загрузки действий по промокодам

Чтобы загрузить действия по промокодам:

  1. Подготовьте файл для загрузки.

  2. Загрузите файл в систему.

Если при заполнении файла допущены ошибки, исправьте их и загрузите файл повторно. Подробнее о возможных ошибках

Как подготовить файл для загрузки

  1. Скачайте шаблон «Шаблон для загрузки действий по промокодам» и откройте его.

  2. Файл содержит один лист, на который вам нужно внести данные из своей системы.

Не создавайте в файле новые листы: система не сможет их обработать.

  1. Заполните обязательные колонки таблицы:
  • promocode* — в этой колонке указывайте кодовые слова промокодов, по которым были выполнены целевые действия (заказы, покупки и т.п.);
    • важно: указывайте только те промокоды, которые уже добавлены в вашу программу, а также уникальны для каждого отдельного веб-мастера.
  • order_id* — в этой колонке указывайте ID заказов в вашей системе, которые были выполнены по соответствующим промокодам;
    • важно: каждый ID заказа должен быть уникальным.
  • price* — в этой колонке указывайте суммы заказов, которые были выполнены по по соответствующим промокодам;
    важно:
    • число должно быть больше нуля;
    • в десятичных числах нельзя указывать больше 2 цифр после запятой;
    • сумму нужно указывать в валюте вашей программы.
  1. Колонка datetime_action (дата совершения заказа по промокоду) — заполняется опционально.

Когда вы заполняете эту колонку, веб-мастера получают более точную статистику по своим размещениям и понимают, какие форматы и публикации позволяют привлечь для вас больше заказов и клиентов.

Правила заполнения поля datetime_action: 

  • дату нужно указать в формате: DD.MM.YYYY hh:mm;
    пример: 27.05.2024 16:50
  • нельзя указывать:
    • дату раньше, чем 180 дней назад;
    • дату в будущем по UTC+3.

Если вы не заполните колонку datetime_action, то в качестве даты совершения заказа автоматически будет указана дата загрузки файла в систему.

  1. Сохраните файл.

Готово, теперь вы можете приступить к загрузке файла.

Как загрузить файл с действиями по промокодам

Обратите внимание: если в вашей программе настроено несколько действий и/или несколько тарифов, то после обработки файла система автоматически рассчитает сумму вознаграждения веб-мастера по ставке из того активного действия и/или тарифа, которые были созданы раньше всего.

Вы можете скорректировать сумму в соответствии с нужной ставкой при проведении сверки.

Максимальный размер файла — 10 Мб.

  1. В разделе «Загрузка действий по промокодам» (меню → Финансы → Загрузка действий по промокодам) нажмите «Choose File».

  2. Выберите подготовленный файл на своем устройстве.

  3. Нажмите «Отправить».

Если файл заполнен корректно, вы увидите сообщение, что файл успешно загружен:

  • обработка файла занимает от нескольких минут до нескольких часов;
  • после этого действия по промокодам появятся в разделе «Статистика» (подробнее).

Если при заполнении файла допущены ошибки, вам нужно исправить и загрузить файл повторно. Подробнее о возможных ошибках

Возможные ошибки при загрузке файла

Если на странице загрузки отобразилась ошибка, исправьте ее в соответствующей строке и колонке, а затем загрузите файл снова.

Текст ошибкиКак исправить
Недопустимый формат файла. Разрешенные форматы: XLS или XLSX.Повторно скачайте «Шаблон для загрузки действий по промокодам», заполните его и загрузите файл снова.
Файл поврежден. Создайте новый файл на основе шаблона.
Файл слишком большой. Максимальный размер файла: 10 МБ.Проверьте размер своего файла. Если он составляет больше 10 Мб, то попробуйте разбить файл на два или больше. Затем последовательно загрузите каждый из них.
Названия колонок в файле не соответствуют шаблону.Убедитесь, что названия колонок в файле соответствуют шаблону, размещены в первой строке и расположены в правильном порядке: promocode*
Нельзя использовать пустой файл. Заполните файл и повторите загрузку.Проверьте, что в файле, помимо названий колонок, есть хотя бы одна строка промокодом, номером заказа и его суммой.
Это поле обязательно для заполнения.Проверьте, что в обозначенной строке заполнены все обязательные поля. Заполните их в этой строке или удалите строку из файла.
Промокод не относится к типу промокодов, которые назначаются на конкретных веб-мастеров.Проверьте кодовое слово в колонке promocode: такой промокод: * должен присутствовать в вашей программе; * быть уникальным для отдельного веб-мастера. Исправьте кодовое слово или удалите строку с ним из файла.
В программе не найден промокод с таким кодовым словом.
Действие с таким ID заказа уже есть.Проверьте, что в колонке order_id вы указали уникальный ID заказа, который содержит не более 100 символов. Исправьте значение order_id или удалите строку с ним из файла.
ID заказа не может содержать больше 100 символов.
Недопустимый формат. Можно использовать только числа больше 0: целые либо дробные с точкой или запятой в качестве разделителя.Проверьте, что в обозначенной строке, в колонке datetime_action, указанная дата: * соответствует формату DD.MM.YYYY hh:mm; * не превышает лимит по самой ранней доступной дате (180 дней назад); * не позже текущего времени (по UTC+3).
Нельзя загрузить действие, если заказ был оформлен более 180 дней назад.
Нельзя указывать дату в будущем.
В настройках программы нет активного действия и тарифа, чтобы рассчитать вознаграждение. Добавьте или активируйте хотя бы 1 действие. Тариф в нем также должен быть активным.Проверьте, что в вашей программе добавлено и активно хотя бы одно действие с активным тарифом в разделе «Действия» (меню → Программа → Действия и вознаграждения). Добавьте или активируйте хотя бы 1 действие с активным тарифом.