Аудитории — импорт аудитории

Премиум

Краткий обзор. Импортируйте предопределенные сегменты аудитории из ваших внутренних систем (таких как BI и CRM) в Аудитории AppsFlyer, что позволит вам использовать Аудитории для подключения и обслуживания этих сегментов с вашими рекламными партнерами.

Зачем импортировать аудитории?

В определенных обстоятельствах в ваших внутренних системах могут быть заранее определенные сегменты аудитории. Импорт этих аудиторий (в виде списков идентификаторов устройств и/или пользователей) в AppsFlyer позволяет вам использовать Аудитории в качестве центральной точки для подключения и обслуживания всех сегментов вашей аудитории с вашими рекламными партнерами. Кроме того, это позволяет пользоваться такими функциями Аудиторий, как сопоставление идентификаторов/обогащение данных и связанные метрики кампаний.

Рассмотрим следующие примеры:

 Примеры

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

Вот как это сделать с аудиториями:

  1. Используйте свою внутреннюю CRM, чтобы создать список пользователей с указанием их дней рождения.
  2. Сегментируйте список по месяцу рождения и экспортируйте его как отдельные списки рекламных идентификаторов.
  3. Импортируйте списки в AppsFlyer как аудитории и подключите их к партнерам, с которыми вы хотите проводить рекламные кампании.
  4. Настройте кампании с соответствующими партнерами, чтобы соответствующим образом таргетировать аудитории.

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

Вот как это сделать с аудиториями:

  1. Получите список идентификаторов устройств из приобретенной вами студии и импортируйте его в AppsFlyer в качестве аудитории.
  2. Подключите аудиторию к партнерам, с которыми вы хотите проводить кампании.
  3. Настройте кампании с соответствующими партнерами, чтобы соответствующим образом таргетировать этих пользователей.

Импорт Аудиторий V2.0

В этой статье описаны концепции и процедуры, связанные с новой функцией импорта аудиторий версии 2.0 (с возможностью импорта через CSV и API). 

Типы импортированных аудиторий

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

Стандартная импортированная аудитория:

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

Импортированная аудитория «как есть»:

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

 Важно!

  • Все аудитории, существующие по состоянию на 23 ноября 2021 г., обозначены как аудитории «как есть» и не могут быть изменены на стандартные аудитории. При необходимости вы можете продолжать обновлять эти аудитории, используя функцию импорта версии 2.0 (описанную в этой статье).
  • Одновременно вы можете иметь до 500 активных импортированных аудиторий.
  • Только администратор может обозначить новую импортированную аудиторию как аудиторию «как есть».
  • При создании аудитории с CUID в качестве идентификатора, привязка CUID должна быть получена AppsFlyer при установке (а не только в событиях после установки) для полной связи с соответствующими устройствами и успешного обогащения данных идентификаторами устройств (т. е. GAID, IDFA). Узнать больше

Процедуры импорта аудитории

Импортируйте аудиторию, загрузив файл CSV или используя API импорта аудитории.

Импорт файла CSV

Подготовьте файл CSV со следующими спецификациями:

Формат

  • Один столбец для каждого загружаемого идентификатора пользователя.
  • Строка заголовка с именем идентификатора в каждом столбце (все строчные буквы).
  • Нет пустых строк
  • Максимальное количество строк: 10 миллионов
  • Если вы готовите файл с помощью Excel, сохраните его как файл CSV (Comma delimited) (*.csv) , как показано на следующем рисунке:

    CSV.jpg

Столбцы и идентификаторы

  • Данные импортируются с использованием строки заголовка для идентификации данных в каждом столбце, поэтому:
    • Нет требования, чтобы столбцы располагались в определенном порядке.
    • Нет необходимости включать столбцы для идентификаторов, которые не загружаются.
    • Вы можете импортировать столько идентификаторов, сколько хотите, в один CSV-файл, при условии, что каждая строка содержит необходимые идентификаторы, как подробно описано ниже.
  • Доступные идентификаторы:
    • app_id (идентификатор приложения)
    • idfv
    • idfa
    • gaid
    • oaid
    • imei
    • cuid
    • emails
    • phone
    • phone_e164
    • braze_id
    • amplitude_id
  • Обязательные идентификаторы:
    • Для аудиторий Android: app_id + один из: gaid ИЛИ oiad ИЛИ imei ИЛИ cuid ИЛИ braze_id ИЛИ amplitude_id
    • Для аудитории iOS: app_id + один из: idfv ИЛИ cuid ИЛИ braze_id ИЛИ amplitude_id
  • В соответствии с выполнением Google Закона о цифровых рынках (DMA) с 6 марта 2024 г. при импорте аудитории «как есть» необходимо добавить два дополнительных столбца согласия AppsFlyer. Это:
Столбцы согласия AppsFlyer  Поле Google  Значения Пояснение к полю
ad_personalization_enabled ad_personalization true/false Давал ли пользователь согласие Google на использование его данных для персонализации рекламы?
ad_user_data_enabled ad_user_data true/false Давал ли пользователь согласие на отправку своих данных в Google? 

Если поля согласия не заполнены значениями, они будут отправлены в Google как «Не указано» и, скорее всего, не будут включены в аудиторию на стороне Google. Заполнение этих полей обеспечивает максимальное включение пользователей из Европейской экономической зоны (ЕЭЗ) в ваши аудитории Google.

Примеры CSV-файлов:

new-import-android-example.csv
new-import-ios-example.csv

Чтобы создать и импортировать новую аудиторию с помощью файла CSV:

  1. В левой панели AppsFlyer перейдите в раздел Вовлечение > Аудитории.
  2. Нажмите Новая аудитория.
  3. Выберите Импортировать аудиторию.
    Откроется окно Импортировать аудиторию .
  4. Введите уникальное Имя аудитории.
  5. Выберите платформу аудитории: Android или iOS.
  6. Укажите, является ли эта аудитория стандартной аудиторией или аудиторией «как есть».
  7. Для стандартной аудитории оставьте флажок снятым.
  8. Для аудитории «как есть» установите флажок. (Примечание: Эта опция доступна только для администраторов).
  9. Нажмите Сохранить аудиторию и продолжить.
    Откроется вкладка Импорт .
  10. В разделе Импорт с использованием CSV оставьте значение по умолчанию Добавить новые устройства/пользователей(поскольку это новая аудитория).
  11. Выберите CSV-файл для загрузки.
    Дождитесь сообщения с подтверждением Загружено успешно.
  12. Нажмите Далее.
    Отобразится вкладка Подключение.
  13. (Необязательно) Следуйте инструкциям по подключению аудитории к партнерам.
  14. Нажмите Готово.

Ваша аудитория теперь видна на дэшборде «Аудитории», она импортирована и подключена к партнерам. Однако обратите внимание, что список недавно импортированных аудиторий пока недоступен для загрузки партнерам, поскольку данные импортированных аудиторий обрабатываются с ежедневным обновлением.

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

  1. В левой панели AppsFlyer перейдите в раздел Вовлечение > Аудитории.
  2. Нажмите на название аудитории, которую хотите обновить.
    Откроется экран Изменить аудиторию с вкладкой Определить .
  3. Если вы хотите изменить название аудитории, вы можете сделать это здесь. В противном случае выберите вкладку Импорт, чтобы загрузить новый файл CSV.
  4. В разделе Импорт с помощью CSV выберите, что делать с загруженным списком:
  5. Добавить новые устройства/пользователей: Добавьте идентификаторы устройств/пользователей в существующую аудиторию.
  6. Удалить устройства/пользователей из существующей аудитории: Удалите идентификаторы устройств/пользователей в загруженном списке из аудитории.
  7. Заменить существующую аудиторию новыми устройствами/пользователями: Замените всю аудиторию загруженным списком.
  8. Выберите CSV-файл для загрузки.
    Дождитесь сообщения с подтверждением Загружено успешно.
  9. Нажмите Далее.
    Отобразится вкладка Подключение.
  10. При необходимости внесите изменения в подключения партнеров для этой аудитории.
  11. Нажмите Готово.

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

Подтверждающие сообщения

Сообщение Причина Рекомендуемые действия
Загружено успешно    
Проблема со списком устройств. Одна или несколько проблем со списком устройств. Пожалуйста, убедитесь, что CSV-файл:
  • заполнен устройствами и идентификаторами GAID/IDFA в правильном формате.
  • содержит необходимые идентификаторы
  • содержит строку заголовка с заголовками в правильном формате
  • не имеет пустых строк
  • app_id заполнен правильным приложением, которое вы используете для аудиторий.
Похоже, ваш список устройств пуст. Добавьте идентификаторы устройств и попробуйте еще раз. CSV-файл пуст.

Убедитесь, что CSV-файл содержит хотя бы один идентификатор устройства.

Нам не удалось распознать один или несколько идентификаторов ваших устройств.
  • Неправильный формат CSV.
  • Загруженный вами файл не является файлом CSV.
  • Файл CSV был отредактирован и сохранен с помощью программы, отличной от допустимого редактора CSV (например, Microsoft Excel).
  • Один или несколько идентификаторов устройств имеют неправильный формат.
  • Убедитесь, что CSV имеет необходимый формат.
  • Убедитесь, что все идентификаторы устройств имеют правильный формат.
  • Если вы использовали Excel, сохраните файл в формате CSV, как описано выше.
Невозможно использовать импорт версии 1 при применении политики аккаунтов пользователей к аудитории. Вы загрузили CSV-файл для стандартной аудитории, используя структуру импорта версии 1.0. Стандартные аудитории необходимо загрузить в формате CSV в структуре версии 2.0. Отредактируйте загружаемый CSV-файл, используя формат, столбцы и идентификаторы, описанные выше.
Не удалось загрузить ваш файл из-за временных проблем с подключением. Вы можете попробовать еще раз сейчас. Возможна ошибка сети Попробуйте загрузить CSV-файл еще раз.

Используйте API импорта аудитории

API импорта аудитории используется для добавления или удаления устройств из аудитории. 

Чтобы импортировать новую аудиторию с помощью API:

  1. В левой панели AppsFlyer перейдите в раздел Вовлечение > Аудитории.
  2. Нажмите Новая аудитория.
  3. Выберите Импортировать аудиторию.
    Откроется окно Импортировать аудиторию .
  4. Введите уникальное Имя аудитории.
  5. Выберите платформу аудитории: Android или iOS.
  6. Укажите, является ли эта аудитория стандартной аудиторией или аудиторией «как есть».
    • Для стандартной аудитории оставьте флажок снятым.
    • Для аудитории «как есть» установите флажок (обратите внимание, эта опция доступна только администраторам). При импорте аудитории «как есть» требуются два дополнительных поля согласия в соответствии с требованиями Google по Закону о цифровых рынках (DMA) от 6 марта 2024 г. Заполнение этих полей обеспечивает максимальное включение пользователей из Европейской экономической зоны (ЕЭЗ) в ваши аудитории Google.
  7. Нажмите Сохранить.
    Откроется страница импорта.
  8. В разделе Импорт с использованием API оставьте значение по умолчанию Добавить новые устройства/пользователей(поскольку это новая аудитория).
  9. Скопируйте URL-адрес запроса API со страницы Импортировать новую аудиторию API (токен API уже включен).
  10. Затем скопируйте и вставьте тело запроса API.
  11. Нажмите Готово.
    Отобразится вкладка Подключение.
  12. (Необязательно) Следуйте инструкциям по подключению аудитории к партнерам.
  13. Нажмите Готово.
  14. Подготовьте запрос API, включая идентификаторы пользователя/устройства, и отправьте его POST в AppsFlyer. 

Чтобы обновить существующую аудиторию с помощью API:

  1. В левой панели AppsFlyer перейдите в раздел Вовлечение > Аудитории.
  2. Нажмите на название аудитории, которую хотите обновить.
    Откроется экран Изменить аудиторию с вкладкой Определить .
  3. Если вы хотите изменить название аудитории, вы можете сделать это здесь. В противном случае выберите вкладку Импорт .
  4. В разделе Импорт с помощью API выберите, что делать с загруженным списком:
  5. Добавить новые устройства/пользователей: Добавьте идентификаторы устройств/пользователей в существующую аудиторию. 
  6. Удалить устройства/пользователей из существующей аудитории: Удалите идентификаторы устройств/пользователей из существующей аудитории.
  7. Скопируйте URL-адрес запроса API со страницы Импортировать новую аудиторию API (токен API уже включен). Примечание. Изменение этого параметра изменяет путь к конечной точке в копируемом коде. Обязательно используйте правильную конечную точку для действия, которое вы предпринимаете (в этом и будущих запросах API).
  8. Затем скопируйте тело запроса API.
  9. Нажмите Далее.
    Отобразится вкладка Подключение.
  10. При необходимости внесите изменения в подключения партнеров для этой аудитории.
  11. Нажмите Готово.
  12. Подготовьте запрос API, включая идентификаторы пользователя/устройства, и отправьте его POST в AppsFlyer.

Коды ответа

Код Сообщение Описание

200

Запрос выполнен успешно

Аудитория успешно импортирована

400 Недопустимая платформа аудитории. Эта аудитория уже настроена для Android/iOS. Чтобы использовать другую платформу, создайте новую аудиторию в пользовательском интерфейсе. Платформа, указанная в теле запроса, не соответствует платформе, указанной при создании аудитории.
400 X или более ваших строк не содержат идентификатор приложения. Вы должны прикрепить идентификатор приложения к каждой строке.

Каждая строка должна содержать app_id.

  • Примечание. App_id не требуется для аудитории «как есть», импортированной с помощью устаревшей функции импорта версии 1.0.
400 X или более ваших строк не содержат действительный уникальный идентификатор.

Все или некоторые строки не содержат хотя бы один из следующих идентификаторов в допустимом формате:

  • Для аудитории Android:gaid ИЛИ oiad ИЛИ imei ИЛИ cuid ИЛИ braze_id ИЛИ amplitude_id
  • Для аудитории iOS: idfv ИЛИ cuid ИЛИ braze_id ИЛИ amplitude_id.
400 Невозможно обработать более Y устройств за один запрос (в этом запросе учтено n устройств)

Тело запроса содержит список из более чем 10 000 идентификаторов устройств.

400 Список устройств не может быть пустым

Тело запроса содержит пустой список устройств.

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

400 Нам не удалось распознать один или несколько идентификаторов ваших устройств. Все или некоторые идентификаторы устройств имеют недопустимый формат.

400

X или более устройств, которые нужно удалить, содержат более одного идентификатора для каждого устройства.

Запрос на удаление был отправлен с более чем одним идентификатором для каждого устройства. 

403 Запрещено Несанкционированный запрос: Неправильный или отсутствующий ключ импорта
429 Слишком много запросов Количество запросов ограничено: 350 в минуту.
500 Не удалось проанализировать запрос

Неправильный формат тела запроса (не ожидаемая структура JSON или не JSON).

См. образец запроса выше.

Ограничения API

  • Вы можете добавлять устройства только в одну аудиторию за один запрос.
  • За один запрос вы можете удалить устройства только из одной аудитории.
  • Вы можете отправить до 10 000 идентификаторов устройств за один запрос.
  • Вы можете отправлять до 350 запросов в минуту.

API управления импортированной аудиторией

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