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

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

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

Схема CSV

Формат CSV-файла и правила его заполнения

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

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

Для загрузки CSV файла через AppsFlyer UI:

1. В AppsFlyer в боковом меню выберите Настройки > Импорт затрат.
   Откроется страница импорта затрат. 
2. Нажмите + Импортировать файл затрат
   Открывается окно импорта затрат.
    
3. Перетащите CSV-файл в окно импорта файла затрат.
   Появится сообщение об обработке файла.
4. Если во время загрузки отображается сообщение об ошибке: устраните ее и повторите соответствующие действия. 
5. Откроется окно Импорт затрат: сводка файла .
6. Выполните одно из следующих действий:
   • Прервите загрузку, нажмите Отменить импорт. 
   • Завершите процесс импорта, нажмите Импортировать файл.
     
     Сообщение «All set!» отображается.
   • Если появляется сообщение об ошибке, следуйте инструкциям в сообщении об ошибке.
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. Выберите Настраиваемый.
4. В поле Тип введите YYYY-MM-DD
5. Нажмите OK.
   Дата отформатируется.

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

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

Чтобы отформатировать ячейки с расходами без запятых в качестве разделителей тысяч: 

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

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

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

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

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

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

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

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

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

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

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

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

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