Руководство по импорту затрат

Формат, схема и правила проверки CSV-файла расходов на рекламу описаны здесь. Если для создания файла используется Excel или Google Sheets, необходимо ознакомиться с инструкциями по форматированию Excel. 

См. пример файла

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

Формат, схема и правила проверки CSV-файла расходов на рекламу описаны далее. Если для создания файла используется Excel или Google Sheets, необходимо ознакомиться с инструкциями по форматированию Excel.

Правила содержания и схема CSV-файлов рекламных расходов

Схема CSV с затратами на рекламу

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

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

Чтобы получить токен для затрат на рекламу:

1. В AppsFlyer в боковом меню выберите Настройки > Импорт затрат.
2. В правой верхней части страницы нажмите Получить токен расходов на рекламу
   На экране отображается токен расходов на рекламу. 
3. Скопируйте и сохраните токен для затрат на рекламу.

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

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

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

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

Чтобы отправить файл с затратами по эл. почте:

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

Чтобы загрузить файл с расходами на рекламу:

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

   

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

Чтобы просмотреть статус импорта на уровне файлов:

• В AppsFlyer в боковом меню выберите Настройки > Импорт затрат.
  На странице импорта затрат отображается список загруженных файлов.
• Если у вас есть разрешения на все приложения, содержащиеся в файле, используйте команду Действие, чтобы:
  
  • Скачать файл CSV: Это копия загруженного файла CSV.
  • Скачать несопоставленный отчет для всех приложений в файле.

Чтобы просмотреть статус импорта на уровне приложения:

• Выберите файл.
  Откроется страница уровня приложения. Отобразится список приложений в файле с расходами на рекламу.

  

• Выполните действия на уровне файлов или приложений, как описано здесь.
• Уровень файла: Если у вас есть разрешения на все приложения, содержащиеся в файле, вы можете использовать элементы управления в правом верхнем углу страницы: 
  • Вернуть (отменить) импорт затрат для всех приложений в файле. 
  • Скачать копию отправленного CSV-файла. 
• На уровне приложения: Если у вас есть разрешение на использование определенного приложения, вы можете сделать это с помощью команды Действие:
  • Скачать данные в приложении.
  • Скачать несопоставленный отчет для приложения.
  • Вернуть (отменить) импорт затрат для выбранного приложения. 

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

Имена и идентификаторы

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

Примечание. Независимо от статуса сопоставления затраты фиксируются.

Процент совпавших строк отображается на странице импорта.

Если несопоставленные строки появляются неожиданно, загрузите отчет о несопоставлении, чтобы выяснить причину. При необходимости отмените импорт, сбросив его.

Отчет о несопоставлении содержит столбец is-matched, который может иметь значение TRUE (сопоставлены) или FALSE (не сопоставлены).

Страница импорта затрат, на которой отображается процент сопоставленных строк

Ранее импортированные расходы на рекламу могут быть перезаписаны с помощью CSV-файлов, содержащих данные с ключом, идентичным ключу ранее импортированных данных.

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

Следующие примеры иллюстрируют перезапись рекламных расходов.

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

Признак ошибки 1: Данные о затратах не отображаются после успешного импорта

1. На дэшборде проверьте, отображается ли название кампании более одного раза.
2. Если это так, то найдите строку, в которой идентификатор кампании пуст.
   Строка с пустым идентификатором кампании содержит затраты. 

Признак ошибки 2: Импортированные затраты отображаются в отдельной (дополнительной) строке без данных об эффективности (установках). Идентификатор кампании в строке пуст.

Причина: Когда в данных атрибуции есть и ID кампании, и ее название, файл CSV должен содержать и то, и другое, чтобы AppsFlyer корректно сопоставил данные о затратах и избежал появления отдельных строк.

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

После сохранения CSV-файла проверьте правильность форматирования его содержимого. Примечание. Не используйте Excel для проверки, лучше воспользуйтесь редактором. 

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

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

1. Выберите ячейки, которые необходимо отформатировать.
2. Щелкните правой кнопкой мыши и выберите Форматировать ячейки.
   Откроется окно форматирования ячеек.
   

   

3. Выберите Custom (Настраиваемый).
4. В поле Тип введите YYYY-MM-DD
5. Нажмите кнопку OK.
   Дата отформатируется.

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

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

Это можно исправить, отформатировав ячейки в Excel.  

Для форматирования сумм расходов без разделителя 1000:  

1. Выберите ячейки, которые необходимо отформатировать.
2. Щелкните правой кнопкой мыши и выберите Форматировать ячейки.
   Откроется окно форматирования ячеек.
3. Выберите Number (Число).
   

   

1. Очистите поле Использовать 1000-й сепаратор (,) .
2. (Необязательно) Установите количество знаков после десятичного разделителя. По умолчанию установлено значение 2. Максимально допустимое значение — 5. 
3. Нажмите кнопку OK.
   Ячейки отформатированы правильно.

Чтобы просмотреть содержимое CSV-файла, воспользуйтесь редактором. 

• Windows: Блокнот, Notepad++
• macOS: TextEdit

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

Вид в редакторе

Используя редактор, просмотрите CSV-файл. Обратите особое внимание на следующее:

• Пробелы: Убедитесь, что до и после запятых, разделяющих поля, нет пробелов. В Excel для удаления пробелов используйте команду @trim. 
• Дата: Убедитесь, что поле даты имеет формат ГГГГ-ММ-ДД.  
• Расходы: Убедитесь, что в поле расходов нет запятой.
  

   

Если Excel создает CSV-файл, в котором в качестве разделителя используется точка с запятой «;» или другой символ, но не запятая:

• Это происходит, когда в региональных настройках компьютера установлен язык/регион, отличный от английского.
• Особенно часто эта проблема возникает, когда в региональных настройках выбран немецкий язык.
• Решение зависит от операционной системы компьютера (macOS или Windows).
• Чтобы решить эту проблему, найдите последнее руководство от Microsoft или пообщайтесь на других форумах. Используйте следующие поисковые запросы: Операционная система (macOS или Windows) Excel меняет разделитель для файлов CSV.

Вероятно, это означает, что файл расходов на рекламу не был обработан. Это может произойти по разным причинам:

Неправильный тип содержимого

AppsFlyer обрабатывает только сообщения с типом содержимого multipart/mixed. Другие типы не обрабатываются, и, соответственно, не формируется и не отправляется письмо со статусом. В обычном случае электронные сообщения с вложениями автоматически устанавливаются почтовым клиентом на multipart/mixed.

Чтобы убедиться в том, что тип содержимого сообщения multipart/mixed, просмотрите значение content-type в заголовке письма.

• Для просмотра заголовка сообщения в Gmail следуйте документации Gmail.
• Для просмотра заголовка сообщения в Outlook следуйте документации Outlook.

HTML-сообщение отформатировано неправильно

Ошибки HTML могут помешать корректной обработке письма. Например, тег пуст или отсутствует. Проверьте свой скрипт на наличие HTML-ошибок.

Рекламодатели и агентства могут подготовить CSV-файлы для загрузки и импорта данных о затратах. Для этого CSV-файлы должны содержать столбец Agency с названием агентства (название агентства — это значение параметра af_prt). См. схему CSV

Рассмотрим:

• В один файл может быть включено только одно агентство. Причем в файл могут быть включены только кампании, управляемые этим агентством.
• Название агентства является обязательным для каждой строки. В столбце Агентство не допускаются пустые ячейки.
• Агентство должно иметь разрешение на все приложения, входящие в файл.
• Загрузить файл могут только рекламодатели. Агентства не могут загружать данные. Они могут подготовить свои файлы и отправить их рекламодателю для загрузки.