Импорт данных о затратах

Рекламодатели, рекламные сети и агентства могут подготовить CSV-файл для импорта затрат. См. пример файла

Как подготовить CSV-файл:

• Следуйте рекомендациям по схеме, формату и правилам для файла, подробно описанным в следующих таблицах.
  Примечание: Если для создания файла используется Excel или Google Таблицы, следуйте инструкциям по форматированию в Excel и Google Таблицах.

Схема CSV

Формат и правила для формата CSV

Рекламодатели и рекламные сети могут загружать CSV-файлы для импорта затрат.

Необходимые условия: Рекламным сетям требуются разрешения на импорт затрат от рекламодателя.

Как загрузить CSV-файл через интерфейс AppsFlyer:

1. В AppsFlyer в боковом меню выберите Настройки > Импорт затрат.
   Откроется страница импорта затрат. 
2. Нажмите + Импортировать файл затрат
   Открывается окно импорта затрат.
   
3. Перетащите CSV-файл в окно импорта файла затрат.
   Появится сообщение об обработке файла.
4. Если во время загрузки отображается сообщение об ошибке: устраните ее и повторите соответствующие действия. 
5. Откроется окно Импорт затрат: сводка файла .
6. Выполните одно из следующих действий:
   • Прервите загрузку, нажмите Отменить импорт. 
   • Завершите процесс импорта, нажмите Импортировать файл.
     Появится сообщение «Все готово!»
   • Если появляется сообщение об ошибке, следуйте инструкциям в сообщении об ошибке.
7. Нажмите кнопку Импортировать другой файл или Готово. 

Рекламодатели и рекламные сети могут загружать CSV-файлы для импорта затрат через электронную почту.

Необходимые условия:

• Рекламодатели:
  
  • Электронная почта отправителя должна принадлежать зарегистрированному пользователю AppsFlyer.
• Рекламные сети:
  
  • Электронная почта отправителя должна принадлежать зарегистрированному пользователю AppsFlyer.
  • Разрешение на импорт затрат от рекламодателя.

Как отправить файл CSV по электронной почте:

1. Получите токен для импорта по электронной почте.
   1. В AppsFlyer в боковом меню выберите Настройки > Импорт затрат.
   2. В правой верхней части страницы нажмите Токен для импорта по электронной почте.
   3. Скопируйте и сохраните токен.
2. Составьте электронное письмо со следующими полями: 
   • Кому:adspend-upload@appsflyer.com
   • Копия: Пользователи, которые должны получить копию автоматической обратной связи
   • Тема: Вставьте токен для импорта по электронной почте в поле темы.
   • Вложение: CSV-файл с данными.
3. Отправьте письмо.
   • После получения и обработки файла генерируется статусное письмо с итогами, деталями, проблемами или ошибками, обнаруженными в процессе обработки. Письмо отправляется всем участникам, указанным в письме, и администратору рекламодателя. Если обнаружены ошибки, следуйте инструкциям в сообщении об ошибке.
   • Просмотреть статус отправленных файлов можно на дэшборде импорта затрат

Чтобы просмотреть дэшборд импорта затрат, в AppsFlyer в боковом меню выберите Настройки > Импорт затрат.

Доступная информация для ранее импортированных файлов описаны в следующей таблице.

Сопоставление строк – это процесс, при котором стоимость, указанная в импорте, сопоставляется с данными атрибуции, записанными в AppsFlyer. Для этого используются все названия параметров (не идентификаторы), такие как медиа-источник, кампания, группа объявлений, объявление и т.д. Если все они совпадают, то строки обозначаются как is-matching=TRUE.

Затраты зафиксированы и доступны в дэшбордах и отчётах AppsFlyer, независимо от статуса совпадения.

Процент сопоставленных строк отображается на дэшборде импорта затрат. Если значение в несовпадающих строках не соответствуют ожидаемым, или процент совпадающих строк (%) выше ожидаемого:

• Загрузите отчёт о несопоставлении, чтобы выяснить причину. Отчет о несопоставлении содержит столбец «is-matched», который может иметь значение TRUE (сопоставлены) или FALSE (не сопоставлены).
• При необходимости отмените импорт, сбросив его.
• Смотрите раздел «Действие» в этой таблице для получения более подробной информации.

При использовании Excel или Google Таблиц для подготовки CSV-файла необходимо правильно отформатировать столбцы даты и расходов перед сохранением файла в формате CSV. После сохранения CSV-файла проверьте правильность форматирования его содержимого. Используйте следующие рекомендации для:

• форматирования ячеек с датами.;
• форматирования ячеек с затратами;
• проверки формата содержимого.

Форматирование ячеек с датами

Чтобы отформатировать ячейки даты в Excel в формате ГГГГ-ММ-ДД:

1. Выберите ячейки, которые необходимо отформатировать.
2. Щелкните правой кнопкой мыши, затем выберите Форматировать ячейки.
   Откроется окно форматирования ячеек.
   
3. Выберите Custom (Настраиваемый).
4. В поле Тип введите YYYY-MM-DD
5. Нажмите кнопку OK.
   Дата отформатируется.

Форматирование ячеек с затратами

Обычно Excel форматирует ячейки со значениями с помощью запятой для отделения тысяч, как показано на следующем изображении. Этот формат не подходит для файлов импорта затрат. 

Как отформатировать ячейки с затратами, чтобы запятая не использовалась в качестве разделителя групп разрядов: 

1. Выберите ячейки, которые необходимо отформатировать.
2. Щелкните правой кнопкой мыши, затем выберите Форматировать ячейки.
   Откроется окно форматирования ячеек.
3. Выберите Number (Число).
   
4. Очистите поле Use 1000 separator (,) (Использовать разделитель групп разрядов (,)).
5. (Необязательно) Установите количество знаков после десятичного разделителя. По умолчанию установлено значение 2. Максимально допустимое значение — 5.
6. Нажмите кнопку OK.
   Ячейки отформатированы правильно.

Проверка формата содержимого

Чтобы проверить формат содержимого:

1. Используйте редактор для просмотра файла.
   • Windows: Блокнот, Notepad++
   • macOS: TextEdit
2. Обратите особое внимание на следующие элементы:
   • Пробелы: Убедитесь, что до и после запятых, разделяющих поля, нет пробелов. В Excel для удаления пробелов используйте команду @trim.
   • Дата: Проверьте, чтобы ячейки с датами имели формат ГГГГ-ММ-ДД.
   • Затраты: Проверьте, чтобы в ячейках с затратами не было запятых.
   • Разделители: Должны использоваться запятые. Если применяется точка с запятой:
     • Это может происходит, когда в региональных настройках компьютера установлен язык/регион, отличный от английского, особенно часто это случается при выборе немецкого.
     • Решение зависит от операционной системы компьютера (macOS или Windows).
     • Чтобы решить эту проблему, найдите последние рекомендации на форумах Microsoft или других аналогичных форумах. Используйте следующие поисковые запросы: Операционная система (macOS или Windows) Excel меняет разделитель для файлов CSV.

Ниже приведен скриншот с примером CSV-файла, отображаемого в редакторе.

Токен для импорта по электронной почте используется для проверки авторизации отправителя электронного сообщения для отправки файла импорта затрат.

Токены рекламодателей и рекламных сетей различаются.

• Токен рекламодателя:
  • Один и тот же токен действителен для всех приложений в аккаунте.
  • Токен может получить любой пользователь аккаунта.
• Токен рекламной сети:
  • Для всех рекламодателей используется один и тот же токен. 

Рекламодатели и рекламные сети не должны делиться своими токенами друг с другом!

Рекламным сетям требуется разрешения рекламодателя на каждое приложение для доступа к импорту затрат.

Чтобы предоставить рекламной сети разрешение на импорт затрат:

1. В AppsFlyer рекламодателю нужно перейти в боковое меню и выбрать Сотрудничество > Активные интеграции.
   О странице интегрированного партнера
2. Выберите интегрированного партнера.
3. Перейдите на вкладку Разрешения.
4. Активируйте Разрешения для рекламной сети, если они еще не включены.
5. (необязательно) Добавить пользователей аккаунта.
6. Активируйте Импорт данных о расходах.
7. Нажмите Сохранить разрешения.

В следующей таблице перечислены все возможные сообщения об ошибках при импорте затрат и соответствующие решения.