Краткий обзор: Импортируйте предопределенные сегменты аудиторий из ваших внутренних систем (таких как бизнес-аналитика и CRM) в AppsFlyer аудитории, что позволит вам использовать аудитории для подключения и поддержания этих сегментов с вашими рекламными партнерами.
Почему стоит импортировать аудитории?
В некоторых случаях у вас могут быть предопределенные сегменты аудиторий во внутренних системах. Импорт этих аудиторий (в виде списков идентификаторов устройств и/или пользователей) в AppsFlyer позволяет использовать аудитории в качестве центральной точки для подключения и поддержки всех сегментов вашей аудитории с рекламными партнерами. Кроме этого, вы сможете в полной мере использовать другие функции аудиторий, такие как сопоставление идентификаторов/обогащение данных и связанные метрики кампаний.
Рассмотрим следующие примеры:
Примеры
Промо-ремаркетинг
Вы хотите предоставить специальные предложения пользователям в месяц их дня рождения.
Вот как это сделать с помощью аудиторий:
- Используйте свою внутреннюю CRM для создания списка пользователей с указанием их дней рождения.
- Сегментируйте список по месяцу рождения и экспортируйте его как отдельные списки рекламных ID.
- Импортируйте эти списки в AppsFlyer как аудитории и подключите их к партнерам, с которыми вы хотите запускать рекламные кампании.
- Настройте кампании с соответствующими партнерами, чтобы эффективно таргетировать аудитории.
Привлечение новых пользователей
Ваша студия разработки приложений приобретает другую студию. Приобретенная вами студия имеет идентификаторы устройств пользователей, которые ранее установили их приложения, и вы хотите привлечь этих пользователей для установки ваших существующих приложений.
Вот как это сделать с помощью аудиторий:
- Получите список идентификаторов устройств из приобретенной вами студии и импортируйте его в AppsFlyer как аудиторию.
- Подключите аудиторию к партнерам, с которыми вы хотите запускать кампании.
- Настройте кампании с соответствующими партнерами, чтобы эффективно таргетировать этих пользователей.
Импорт аудиторий 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 файл, если каждая строка содержит необходимые идентификаторы, как указано ниже.
- Доступные идентификаторы:
- 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 файла:
- На левой панели AppsFlyer перейдите в раздел Вовлеченность > Аудитории.
- Нажмите Новая аудитория.
- Выберите Импортировать аудиторию.
Откроется окно Импорт аудитории. - Введите уникальное Имя аудитории.
- Выберите платформу аудитории: Android или iOS.
- Укажите, является ли эта аудитория стандартной аудиторией или аудиторией как есть.
- Для стандартной аудитории оставьте флажок снятым.
- Для аудитории как есть установите флажок. (Примечание: Эта опция доступна только администраторам.)
- Нажмите Сохранить аудиторию и продолжить.
Отображается вкладка Импорт. - В разделе Импорт с помощью CSV оставьте значение по умолчанию Добавить новые устройства/пользователей (так как это новая аудитория).
- Выберите CSV файл для загрузки.
Дождитесь сообщения с подтверждением Загружено успешно. - Нажмите Далее.
Отображается вкладка Подключиться. - (Необязательно) Следуйте инструкциям по подключению аудитории к партнерам.
- Нажмите Готово.
Ваша аудитория теперь видна на дэшборде аудиторий, она импортирована и подключена к партнерам. Однако обратите внимание, что недавно импортированный список аудиторий пока недоступен для отправки партнерам, так как обработка данных выполняется с свежестью данных ежедневно.
Чтобы обновить существующую аудиторию с помощью CSV файла:
- На левой панели AppsFlyer перейдите в раздел Вовлеченность > Аудитории.
- Нажмите на название аудитории, которую хотите обновить.
Откроется экран Изменить аудиторию с отображаемой вкладкой Определить. - Если вы хотите изменить название аудитории, вы можете сделать это здесь. В противном случае выберите вкладку Импорт, чтобы загрузить новый CSV файл.
- В разделе Импорт с помощью CSV выберите, что делать с загруженным списком:
- Добавить новые устройства/пользователей: Добавьте идентификаторы устройств/пользователей к существующей аудитории.
- Удалить устройства/пользователей из существующей аудитории: Удалите идентификаторы устройств/пользователей в загруженном списке из аудитории.
- Перезаписать существующую аудиторию новыми устройствами/пользователями: Замените всю аудиторию загруженным списком.
- Выберите CSV файл для загрузки.
Дождитесь сообщения с подтверждением Загружено успешно. - Нажмите Далее.
Отображается вкладка Подключиться. - При необходимости внесите изменения в подключение к партнерам для этой аудитории.
- Нажмите Готово.
Ваша аудитория обновлена с использованием CSV файла. Однако следует отметить, что обновлённый список аудитории ещё не загружен Партнерам, так как импортированные аудитории обрабатываются с ежедневным обновлением данных.
Сообщения об ошибках
Сообщение | Причина | Что делать |
---|---|---|
Возникла проблема со списком устройств. | Одна или несколько проблем со списком устройств. | Пожалуйста, проверьте, что CSV-файл:
|
Похоже, ваш список устройств пуст. Добавьте несколько идентификаторов устройств и повторите попытку. | Файл CSV пуст. |
Убедитесь, что CSV содержит хотя бы один идентификатор устройства. |
Мы не смогли распознать один или несколько идентификаторов ваших устройств. |
|
|
Невозможно использовать импорт v1 при применении политики учётной записи пользователя к аудитории. | Вы загрузили CSV-файл для стандартной аудитории, используя структуру импорта V1.0. Стандартные аудитории необходимо загружать с помощью CSV в структуре V2.0. | Отредактируйте загружаемый CSV-файл, используя формат, столбцы и идентификаторы, описанные выше. |
У нас возникли временные проблемы с подключением, и мы не смогли загрузить ваш файл. Вы можете попробовать ещё раз сейчас. | Возможная ошибка сети | Попробуйте загрузить CSV-файл ещё раз. |
Использовать API импорта аудитории
API импорта аудитории используется для добавления или удаления устройств из аудитории.
Чтобы импортировать новую аудиторию с помощью API:
- На левой панели AppsFlyer перейдите в раздел Вовлеченность > Аудитории.
- Клик Новая аудитория.
- Выберите Импортировать аудиторию.
Откроется окно Импорт аудитории. - Введите уникальное Имя аудитории.
- Выберите платформу аудитории: Android или iOS.
- Укажите, является ли эта аудитория стандартной аудиторией или аудиторией как есть.
- Для стандартной аудитории оставьте флажок неотмеченным.
- Для аудитории «как есть» установите флажок (обратите внимание, что эта опция доступна только администраторам). Два дополнительных поля согласия требуются при импорте аудитории «как есть» в соответствии с соблюдением правовых норм Google Закона о цифровых рынках (DMA) от 6 марта 2024 года. Заполнение этих полей гарантирует максимальное включение пользователей из Европейской экономической зоны (ЕЭЗ) в ваши аудитории Google.
- Клик Сохранить.
Отображается страница импорта. - В разделе Импорт с помощью API оставьте значение по умолчанию Добавить новые устройства/пользователей (так как это новая аудитория).
- Скопируйте URL-адрес запроса API со страницы Импорт нового API аудитории (токен API уже включен).
- Затем скопируйте и вставьте тело запроса API.
- Клик Готово.
Отображается вкладка Подключиться. - (Необязательно) Следуйте инструкциям по подключению аудитории к партнерам.
- Нажмите Готово.
- Подготовьте запрос API, включая идентификаторы пользователя/устройства, и отправьте его POST в AppsFlyer.
Чтобы обновить существующую аудиторию с помощью API:
- На левой панели AppsFlyer перейдите в раздел Вовлеченность > Аудитории.
- Нажмите на название аудитории, которую хотите обновить.
Откроется экран Изменить аудиторию с отображаемой вкладкой Определить. - Если вы хотите изменить название аудитории, вы можете сделать это здесь. В противном случае выберите вкладку Импорт.
- В разделе Импорт с помощью API выберите, что делать с загруженным списком:
- Добавить новые устройства/пользователей: Добавьте идентификаторы устройств/пользователей в существующую аудиторию.
- Удалить устройства/пользователей из существующей аудитории: Удалите идентификаторы устройств/пользователей из существующей аудитории.
- Скопируйте URL-адрес запроса API со страницы Импорт новой аудитории API (токен API уже включен). Примечание: Изменение этой опции изменяет путь к конечной точке в копируемом коде. Обязательно используйте правильную конечную точку для действия, которое вы предпринимаете (в этом и будущих запросах API).
- Затем скопируйте тело запроса API.
- Нажмите Далее.
Отображается вкладка Подключиться. - При необходимости внесите изменения в подключение к партнерам для этой аудитории.
- Нажмите Готово.
- Подготовьте запрос API, включая идентификаторы пользователя/устройства, и отправьте его POST в AppsFlyer.
Примечание: При импорте через API для обновления аудитории потребуется 24 часа.
Коды ответа
Код | Сообщение | Описание |
---|---|---|
200 |
Запрос выполнен успешно |
Аудитория успешно импортирована |
400 | Недопустимая платформа аудитории, эта аудитория уже настроена для Android/iOS. Чтобы использовать другую платформу, пожалуйста, создайте новую аудиторию в пользовательском интерфейсе. | Платформа, указанная в теле запроса, не соответствует платформе, указанной при создании аудитории. |
400 | X или более ваших строк не содержат идентификатор приложения. Необходимо к каждой строке прикрепить идентификатор приложения. |
Каждая строка должна содержать app_id
|
400 | X или более ваших строк не содержат действительный уникальный идентификатор. |
Все или некоторые строки не содержат хотя бы один из следующих идентификаторов в действительном формате:
|
400 | Невозможно обработать более Y устройств за один запрос (в этом запросе учтено n устройств) |
Тело запроса содержит список из более чем 10 000 идентификаторов устройств. |
400 | Список устройств не может быть пустым |
Тело запроса содержит пустой список устройств. Вы должны указать хотя бы один идентификатор устройства для каждого запроса. |
400 | Не удалось распознать один или несколько идентификаторов ваших устройств. | Все или некоторые идентификаторы устройств имеют недопустимый формат. |
400 |
X или более устройств для удаления содержат более одного идентификатора на устройство |
Запрос на удаление был отправлен с более чем одним идентификатором на устройство |
403 | Запрещено | Несанкционированный запрос: Неправильный или отсутствующий ключ импорта |
429 | Слишком много запросов | Количество запросов ограничено 350 в минуту |
500 | Не удалось проанализировать запрос. |
Неверный формат тела запроса (неожиданная структура JSON или не JSON) См. пример запроса выше. |
Ограничения API
- Вы можете добавлять устройства только в одну аудиторию за один запрос.
- За один запрос можно удалить устройства только из одной аудитории.
- Вы можете отправить до 20 000 идентификаторов устройств за один запрос.
- Вы можете отправлять до 350 запросов в минуту.
API управления импортированной аудиторией
API управления импортированной аудиторией позволяет рекламодателям создавать и настраивать импортированные аудитории, подключать импортированные аудитории к партнерам, загружать импортированные аудитории партнерам и многое другое.