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

Премиум

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

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

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

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

 Примеры

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

Вот как это сделать с помощью аудиторий:

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

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

Вот как это сделать с помощью аудиторий:

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

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

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

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

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

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

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

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

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

Важно!

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

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

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

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

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

Формат

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

    CSV.jpg

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

  • Данные распознаются с использованием строки заголовка для идентификации данных в каждом столбце, поэтому:
    • Нет никаких требований к конкретному порядку столбцов.
    • Нет необходимости включать столбцы для идентификаторов, которые не загружаются.
    • Вы можете импортировать столько идентификаторов, сколько хотите, в один CSV файл, если каждая строка содержит необходимые идентификаторы, как указано ниже.
  • Доступные идентификаторы:
    • app_id
    • idfv
    • idfa
    • gaid
    • oaid
    • imei
    • cuid
    • emails
    • телефон
    • телефон_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 файлов:

новый-импорт-android-пример.csv
новый-импорт-ios-пример.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, как описано выше.
Невозможно использовать импорт v1 при применении политики учётной записи пользователя к аудитории. Вы загрузили CSV-файл для стандартной аудитории, используя структуру импорта V1.0. Стандартные аудитории необходимо загружать с помощью CSV в структуре V2.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.

Примечание: При импорте через API для обновления аудитории потребуется 24 часа.

Коды ответа

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

200

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

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

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

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

  • Примечание: app_id не требуется для аудитории как есть, импортируемой через устаревшую функцию импорта версии V1.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

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

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

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