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

Премиум

Краткий обзор. Функция импорта затрат, входящая в состав AppsFlyer ROI360, обеспечивает рекламодателям 100-процентное покрытие потребностей в отчетности по затратам на кампании. Рекламодатели и рекламные сети могут регистрировать стоимость кампаний из медиа-источников, которые не сообщают о расходах по API или кликам.

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

Adspendimport.jpg

Полные данные о затратах кампании

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

Затраты должны учитываться на уровне кампании, а другие параметры в рекламной иерархии являются необязательными. Отчетность о расходах (затратах) ведется с помощью CSV-файлов, загружаемых на дэшборд для импорта. Обновленные данные о совокупных затратах доступны на дэшборде в течение 4 часов после импорта.

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

При необходимости ранее импортированные данные о расходах на рекламу можно перезаписать.

Конкретные кейсы:

  • Учет затрат, поступающих от сетей, которые не передают данные о затратах по API или в ссылке атрибуции.
  • Офлайн-каналы, такие как кампании по радио и рекламные щиты
  • Агенты влияния

Для управления импортом затрат перейдите в раздел Настройки > Импорт затратПримечание. Страница импорта расходов на рекламу — это страница на уровне аккаунта. Это означает, что рекламодатели могут управлять импортом для всех приложений в аккаунте с помощью одной и той же страницы. 

Подготовка, загрузка и импорт файлов с расходами на рекламу

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

  • Загрузка файла в пользовательском интерфейсе.
    Примечание:
    • Мы рекомендуем сначала попробовать этот метод. Это связано с тем, что сообщения об ошибках, связанных с форматом и содержанием файлов, отображаются сразу, что упрощает решение проблем.
    • Этот метод недоступен для приложений на платформах CTV, PC и консолях.
  • Загрузка файла по электронной почте.
    • Для приложений на платформах CTV, PC и консолях используйте только этот метод.

Оба рабочих процесса описаны в последующих разделах.

Рабочие процессы загрузки 

Рабочий процесс: Загрузка файла в пользовательском интерфейсе.

Шаг Описание Ссылка
1

Шаг только для рекламных сетей: Прежде чем рекламная сеть сможет отправлять файлы, рекламодатель должен предоставить рекламной сети разрешение

Предоставление разрешения на импорт расходов
2

Подготовка CSV-файла

Примечание: Агентства также могут подготовить файлы для своих данных. Узнать больше

Формат и схема файла CSV
3

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

Загрузка файлов с расходами на рекламу

4

По завершении импорта используйте интерфейс для мониторинга импорта:

  • Статус
  • Совпадение строк (во многих случаях низкий процент совпавших строк означает наличие ошибок в данных)
 Действия по импорту затрат
 

Дополнительная процедура: Перезапись предыдущего импорта

Перезапись ранее импортированных расходов

Рабочий процесс: Загрузка файла по электронной почте.

Шаг Описание Ссылка
1

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

Предоставление разрешения на импорт расходов
2

Необходимые условия: Получение токена расходов на рекламу

Получение токена рекламных расходов
3

Подготовка CSV-файла

Примечание: Агентства также могут подготовить файлы для своих данных. Узнать больше

Формат и схема файла CSV
4

Отправка файла по электронной почте 

Электронная почта

5 AppsFlyer отправляет отчет о статусе; в нем отмечается, был ли импорт успешным или были обнаружены проблемы.  
6  Используйте интерфейс для мониторинга импорта:
  • Статус 
  • Совпадение строк (во многих случаях низкий процент совпавших строк означает наличие ошибок в данных)
Действия по импорту затрат
 

Дополнительная процедура: Перезапись предыдущего импорта

Перезапись ранее импортированных расходов

Процедура

Формат и схема файла CSV

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

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

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

importfile_en-us.png

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

 Примечание

Не используйте Excel или Google Sheets ни для просмотра, ни для проверки правильности форматирования CSV-файла. Вместо этого используйте редактор.

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

Наименование Требования

Запрещенные символы

Поля в формате строки не могут иметь в качестве первого символа =, +, - или @. Например, @example_campign или =123 запрещены.

Медиа-источник

  • Один медиа-источник на файл
  • Допускаются несколько приложений для одного и того же медиа-источника
  • Ограничения:
    • Не отправляйте данные о затратах из медиа-источника, который уже имеет интеграцию Cost API с AppsFlyer. Импорт из этих источников запрещен. К ним относятся Meta ads, Apple Search Ads и Snapchat.

Владелец приложения 

Допускается один рекламодатель (владелец приложения) на файл. Это означает, что допускаются несколько приложений от одного рекламодателя. 

Расширение имени файла

Пример CSV: abc123.csv

Структура файла

  • Формат: Файлы имеют формат CSV, то есть каждый столбец отделен запятой. Обратите внимание, что именно таким образом Excel по умолчанию форматирует CSV-файлы. Если Excel форматирует файл точкой с запятой (;), это связано с региональными настройками вашего компьютера. 
  • Строка заголовка: Первая строка — это строка заголовка, которая соответствует схеме
  • Строки данных: Содержат обязательные столбцы. Примечание. Убедитесь, что в данных нет пробелов в конце строки. Например, [USD ] (после буквы D есть пробел) следует заменить на [USD].
  • Пустые строки: Запрещены
  • Дублированные строки с одинаковым ключом: Запрещены. Ключ извлекается из использования обязательных полей.
  • Пустые ячейки: Пустые значения в файле не допускаются. Если вы не хотите загружать определенные поля, их не должно быть в файле.

Иерархия рекламы 

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

Например: Если вы импортируете файл с затратами кампании для рекламного блока 1 и отдельно импортируете другой файл для рекламного блока 2 той же кампании, то общая стоимость кампании будет заменена и будут показаны только данные рекламного блока 2. Для определения общих затрат кампании необходимо, чтобы файл, который вы импортируете, включал в себя рекламный блок 1 и 2.

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

Имя столбца

(чувствительно к регистру)

Формат/примечание

Пример

Обязательно/Не обязательно

дата

  • Дата, когда были произведены расходы
  • Формат: Строка:
    (Оптимальный вариант) ГГГГ-ММ-ДД
    ГГГГ-ММ-ДД
    ММ-ДД-ГГГГ 
    ММ/ДД/ГГГГ 
  • Даты в будущем не допускаются
  • Рекомендация: Используйте тот же часовой пояс, который определен для вашего приложения в AppsFlyer.
  • Примечание. Используете Excel/Google sheets для подготовки файла? Прочитайте эту статью

2019-05-30
2019/05/30
5-30-2019 
5/30/2019
05-30-2019
05/30/2019

 

app-id

  • Формат: Строка
  • Идентификатор приложения (App id), как он отображается на дэшборде.
  • В одном файле допускаются несколько приложений.
  • Все приложения должны принадлежать одному рекламодателю.
  • com.app.name 
  • id12356789

media-source

  • Формат: Строка
  • Имя медиа-источника в точности соответствует его названию на дэшборде. Примечание. Добавьте суффикс _int, если он отображается на дэшборде.
  • Для одного файла допускается только один медиа-источник.

network_x_int

campaign (кампания)

  • Формат: Строка
  • Название кампании. Если название кампании встречается в рекламной сети, то оно должно совпадать (с учетом регистра) с названием в этой сети.
  • Не используйте одно и то же название кампании для нескольких приложений.

campaign_a

Примечание. Если данные атрибуции содержат и имя, и идентификатор, то для соответствия CSV должен содержать и то, и другое.

расходы

  • Денежные расходы
  • После десятичной точки допускается пять цифр
  • Допускается значение 0 (ноль)
  • Примечание:

2874.12345

 

 

geo (гео)

Формат: Строка

Код страны из двух букв по стандарту ISO 3166

Для Соединенного Королевства используйте UK, , а не GB.
Примечание. Убедитесь, что вы отправили два символа без пробелов.

US, CN, AU

 

Нет

currency (валюта)

  • Формат: Строка
  • Код валюты из трех символов по стандарту ISO-4217. Примечание. Убедитесь, что вы отправляете три символа без пробелов до и после.
  • Разрешается использовать один код валюты для каждого приложения в файле. В разных приложений могут быть разные коды валют.

USD, GBP, EUR, JPY

Нет.

Если оставить пустым, то по умолчанию будет USD.

campaign-id

Формат: Строка

abc1234def

Нет.

Примечание. Если данные атрибуции содержат и имя, и идентификатор, то для соответствия CSV должен содержать и то, и другое.

adset (группа объявлений)

Формат: Строка  my_adset_1

adset-id

Формат: Строка id5678ghi

ad (объявление)

Формат: Строка  my_ad_name

ad-id

Формат: Строка  id91011jkl

site-id

Формат: Строка  id1213mno Нет

channel

Формат: Строка   Видео Нет

keywords

Формат: Строка

  • better
  • better you app
  • better you online
Нет

agency

  • Название агентства. Значение в параметре af_prt.
  • Формат: Строка
Название агентства Нет

Внимание: Имена, содержащие неанглийские символы, должны быть закодированы с использованием UTF-8.

Получение токена расходов на рекламу

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

 Внимание!

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

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

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

Предоставление разрешения на импорт рекламной сети

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

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

Отправка файлов с затратами на рекламу по электронной почте

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

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

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

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

Загрузка файлов с расходами на рекламу

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

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

    AdspendInestionFileSummary.png

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

Управление импортом затрат

На странице импорта затрат можно выполнять следующие действия. 

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

Разрешение на просмотр загруженных файлов и несопоставленных отчетов:

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

Действия по импорту затрат

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

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

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

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

    Adspendimports2.png

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

Индикатор состояния

Статус Примечания
Применено Действие успешно завершено
Отменено Действие успешно завершено 
Ошибка обработки данных

Системная проблема AppsFlyer. Подождите 10 минут и повторите попытку. При повторном сбое обратитесь в службу поддержки AppsFlyer.

Нет разрешений

Токен не одобрен для данного приложения.

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

Ошибка проверки

 

 

Сопоставление строк и отчет о несопоставленных строках

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

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

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

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

 Пример: Сопоставленные и несопоставленные строки

Дата Медиа-источник Кампания Показы Клики Затраты Статус сопоставления
01.01.2019 пример abc 5000 100 $1000 is-matching = TRUE
Найдена информация об эффективности
02.01.2019 пример abc       is-matching = FALSE
Нет информации об эффективности на 2019-01-02
02.01.2019 пример агент влияния     $2500

is-matching = FALSE
Нет информации об эффективности на 2019-01-02

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

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

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

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

Adpsendmatching.png

Перезапись (корректировка) ранее импортированных расходов

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

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

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

 Пример: Перезапись расходов на рекламу

+ указывает на обязательные поля

Пример A

Spend1.csv импортирован в понедельник

Дата+ App ID+ Медиа-источник+ Кампания+ Расходы
01.06.2019 com.my.app network_x campaign_a 100

Spend2.csv импортирован во вторник

Дата+ App ID+ Медиа-источник+ Кампания+ Расходы
01.06.2019 com.my.app network_x campaign_a 200
Данные о расходах из файла spend1.csv были перезаписаны данными о расходах из файла spend2.csv. Это связано с тем, что файл spend2.csv был импортирован последним, и обязательные поля, формирующие ключ, совпадают. 

Пример B

Spend3.csv импортирован в понедельник

Дата+ App ID+ Медиа-источник+ Кампания+ Расходы Геоданные
05.01.2019 com.my.app network_x campaign_a 100 США
05.01.2019 com.my.app network_x campaign_a 200 CN

Spend4.csv импортирован во вторник

Дата+ App ID+ Медиа-источник+ Кампания+ Расходы
05.01.2019 com.my.app network_x campaign_a 50
Данные о расходах из файла spend3.csv были перезаписаны данными о расходах из файла spend4.csv. Это связано с тем, что файл spend4.csv был импортирован последним, и обязательные поля, формирующие ключ, совпадают. Примечание. Обе строки spend3.csv будут перезаписаны. 

Устранение неполадок

Сообщения об ошибках и способы их устранения

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

Сообщение об ошибке Описание Решение
Ни один из идентификаторов приложений, указанных в файле, не существует в AppsFlyer. Проверьте правильность идентификаторов приложений. Идентификатор приложения не существует в аккаунте. Измените идентификатор приложения и отправьте повторно.

Строка [название строки] имеет неправильное количество столбцов. Ожидалось [количество] столбцов, получено [количество] столбцов.

Все столбцы в файле должны иметь значение. Измените значения, заполненные в файле, в соответствии с определенными заголовками.
Отсутствует media-source (медиа-источник) в заголовке файла.
  • Отсутствует media- source в заголовке файла.
  • Имя столбца должно быть точно таким, как в схеме.
Добавьте медиа-источник в качестве имени заголовка.
Файл может содержать только один медиа-источник. В файле обнаружено несколько медиа-источников: [количество медиа-источников].  Нельзя загрузить файл с более чем одним медиа-источником. Разделите загрузку на отдельный файл для каждого медиа-источника.
Значение [значение], предоставленное для [поле], не является допустимым значением для этого столбца. Неправильный формат данных в столбце. Например, вместо гггг-мм-дд дата указана как дд-мм-гг. Исправьте формат и отправьте повторно. 
Для приложения определено несколько валют. Используйте одну валюту для каждого приложения в файле. Обнаруженные валюты: %количество валют%. Для одного приложения может использоваться только одна валюта. Используйте одну валюту в импорте и отправьте повторно.
Следующие столбцы в заголовке файла не поддерживаются: [заголовки файлов].

Заголовок файла не соответствует схеме. То есть имя столбца должно быть точно таким, как в схеме.

Удалите неподдерживаемые столбцы и отправьте повторно.
Отсутствуют необходимые столбцы в заголовке файла: [заголовки файла]. В заголовке файла отсутствует обязательный столбец. Добавьте недостающий столбец и его значения и отправьте повторно.
В приложении указана будущая дата: [дата] Даты в будущем не допускаются. Исправьте дату на сегодняшнюю или более раннюю и отправьте повторно.
В файле нет данных. Нет данных для обработки. В файле нет данных. Заполните данные в файле и отправьте повторно.
Следующие две строки противоречат друг другу из-за одинаковых параметров. Пожалуйста, включите одну строку расходов для каждого блока параметров [противоречивые строки]. Имеется более одной строки с одинаковыми ключевыми (обязательными) полями. Удалите дублирующиеся строки и отправьте повторно.
Файл может содержать данные только от одного аккаунта рекламодателя. В файле встречаются различные рекламодатели: [имена рекламодателей]. У партнеров загрузка не может быть более чем для одного рекламодателя. Разделите загрузку на отдельные файлы для каждого рекламодателя.
Приложения [ID приложения] нет в аккаунте. Проверьте идентификатор приложения. Идентификатор приложения не существует. Исправьте идентификатор приложения и отправьте повторно.
Для приложения [ID приложения] не найдены геоданные (код страны). Используйте код из двух букв по ISO 3166. Гео не существует. Исправьте гео и отправьте повторно.
Не найден код валюты для приложения [ID приложения]. Используйте код из трех букв по ISO 4217. Валюта не существует Измените валюту на действительную и отправьте повторно.
Для одного или нескольких приложений в файле обнаружены ошибки проверки. Проверьте информацию в файле. В файле имеется более одной ошибки. Загрузите файл и проверьте его на наличие ошибок.
При обработке файла произошла внутренняя ошибка, попробуйте загрузить его еще раз.
  • Проблема обработки файла бэкендом.
  • Как правило, это временная проблема.
Подождите 1 час и снова загрузите файл.

Импортированные данные о затратах не отображаются или отображаются в отдельной строке

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

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

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

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

Использование Excel для форматирования полей даты и расходов в файлах CSV

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

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

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

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

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

    Formatdate..png

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

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

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

mceclip1.png

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

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

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

    Formatnumbers.png

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

Визуальный контроль CSV-файла без использования Excel

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

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

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

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

mceclip1.png

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

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

    mceclip1.png 

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

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

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

После отправки по эл. почте файлов с расходами на рекламу не приходит письмо со статусом

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

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

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

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

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

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

Дополнительные сведения

Подготовка CSV-файла с данными агентства

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

Рассмотрим:

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

Ограничения и особенности

Специфика Поддержка импорта затрат Примечания 
Рекламным сетям    
Агентства  

Агентства не могут загружать данные. Они могут подготовить свои файлы и отправить их рекламодателю для загрузки.

Прозрачность агентства x  
Часовой пояс приложения  
Валюта приложения  Расходы на кампанию конвертируются в валюту конкретного приложения.
Название кампании Одно и то же название кампании не может быть использовано для нескольких приложений, иначе затраты одного приложения будут применяться к обоим.
Названия полей

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

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

Размер файла

При загрузке CSV-файла импорта затрат применяется следующее ограничение по размеру:

  • Через дэшборд AppsFlyer: 2 МБ
  • По электронной почте: 5 МБ
Органические данные  
Неорганические данные  
Актуальность данных расходы на рекламу  
Исторические данные

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

Ретаргетинг x  
Доступ пользователей аккаунта Недоступно для пользователей с ограничениями по гео или медиа-источникам.