Аудитории — атрибуты пользователей

Вы, маркетолог приложений, заняты следующим:

• Поддержание 2 гейминговых приложений: game_a и game_b.
• Запуск игры game_c
• Адресование, нацеливание текущих пользователей приложений с этими атрибутами пользователей:
  • Любимый вид спорта: Крикет
  • Текущий счет в игре: 15 и более в одной из текущих игр

Таблица содержит данные об атрибутах пользователей из вашей CRM. Наборы правил аудитории должны иметь доступ к этим данным. 

Используйте данные CRM в наборах правил

В разделе «Аудитории» создайте атрибуты пользователей (любимый вид спорта и счет в игре). Это предоставляет наборам правил доступ к данным CRM. 

Атрибуты пользователя в сценарии

Атрибуты пользователей в наборах правил

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

altUserAttributedExample.jpgalt

Предварительное условие:

Для управления атрибутами на уровне приложения пользователь аккаунта должен иметь разрешение на доступ. 

Чтобы настроить атрибуты пользователей, выполните следующие шаги:

1. Добавление атрибутов пользователей.

2. Сделайте одно из следующих действий

   • Импортируйте данные атрибутов пользователей через CSV.

   • Импортируйте данные атрибутов пользователей через API.

3. Реализуйте атрибуты пользователей в наборах правил.

Чтобы добавить атрибуты пользователей:

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

   

4. Заполните поля. Характеристики полей перечислены в таблице ниже. 
   
   • Имя атрибута
   • Формат
   • Уровень
5. Нажмите Сохранить.

Чтобы управлять атрибутами пользователя, перейдите на вкладку Аудитории > Атрибуты пользователей.

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

Чтобы удалить атрибут, являющийся частью набора правил:

1. Удалите атрибут из набора правил.
2. Удалите атрибут.

Данные атрибутов пользователя добавляются или удаляются через CSV файл. Рисунок и пример CSV файла, приведенные ниже, соответствуют сценарию, описанному в этой статье.

Пример атрибутов пользователя.csv

Требования к CSV файлу

• Нет строки заголовка
• Содержит все столбцы, перечисленные в предыдущей таблице. 

Чтобы импортировать CSV файл:

1. Перейдите на вкладку Аудитории > Атрибуты пользователей.
2. Нажмите Импорт данных.
3. Выберите CSV.
4. Выберите одно из:
   • Добавить данные
   • Удалить данные
5. Выберите CSV файл для импорта. 
6. Нажмите Загрузить; появится сообщение о статусе загрузки.

Примечание: При импорте атрибутов пользователей все известные устройства, связанные с идентификатором клиента, также получают этот атрибут. Например, если пользователь импортировал 10 устройств (по идентификатору клиента) для атрибута «Счет игры», и один из идентификаторов клиентов связан с 2 устройствами (т.е. 2 GAID с одинаковым CUID), то этот импорт будет содержать 11 записей атрибутов пользователей.

Этот метод импорта требует URL-адрес запроса и JSON с данными атрибутов пользователя.

1. На дэшборде получите подготовленные вызовы API-запросов и шаблон JSON.
2. Заполните шаблон JSON своими данными в соответствии со спецификациями полей. 

Чтобы сгенерировать URL-адрес запроса API и шаблон JSON:

1. Нажмите Импортировать данные.
2. Выберите API.
3. Выберите действие:
   
   • Обновить атрибуты пользователей: Перезаписать или добавить.
   • Удалить атрибуты пользователей.
   • Удалить данные пользователя: Удаляет все данные, относящиеся к конкретному пользователю. Пользователь идентифицируется по своему идентификатору AppsFlyer.
   • Удалить данные приложения: Удаляет все данные на уровне приложения. 
4. Скопируйте сгенерированный URL-адрес запроса API.
5. Скопируйте сгенерированное тело запроса API.
6. Подготовьте JSON (с данными атрибутов пользователя), используя указанный формат JSON. Для атрибутов на уровне аккаунта установите "app_ids": ["*"]
7. Подготовьте вызов API на основе URL-адреса и тела запроса.
8. Отправьте запрос программно.

https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
  "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
  "attributes_values": [
    {
      "device_id": "",
      "customer_id": "",
      "app_ids": [],
      "attributes": [
        {
          "attribute_key": "",
          "attribute_value": ""
        }
      ]
    }
  ]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "2222222",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 5
                }
                ,
                {
                    "attribute_key": "favorite_sport",
                    "attribute_value": "cricket"
                }
            ]
        }
        ,
        {
            "device_id": "555555-d1d1-d1d1-555-fffffffff",
            "customer_id": "111111",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "order",
                    "attribute_value": 7
                }
                ,
                {
                    "attribute_key": "number",
                    "attribute_value": 8
                }
            ]
        }]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "12345678",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 90
                }
                ,
                {
                    "attribute_key": "favorite-sport",
                    "attribute_value": "cricket"
                }
                ,
                {
                    "attribute_key": "orderNumber",
                    "attribute_value": 93
                }
                ,
                {
                    "attribute_key": "netPromoterScore",
                    "attribute_value": 94
                }
            ]
        }
    ]
}

Общие ограничения

• В данных импорта CSV\/API поддерживаются только целые числа. Числа с плавающей запятой не поддерживаются. Пример: Значение атрибута "оценка" может быть равно 90, но не 90,5.
• Данные об атрибутах пользователя не могут быть распечатаны или загружены. 

• Ограничения значений атрибутов:

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

Ограничения импорта API

• Максимум 350 запросов API в минуту, 10 тыс. устройств для плоской полезной нагрузки (10 тыс. устройств с одним атрибутом, 5 тыс. устройств с двумя атрибутами и т. д.)
• Оба ключа device_id и customer_id являются обязательными для каждого вызова импорта. Если вы хотите импортировать атрибуты только с одним из этих идентификаторов, вызов должен включать "заголовок" другого идентификатора с пустой строкой. Например, если вы хотите импортировать атрибуты для device_id и без customer_id, вызов должен выглядеть следующим образом:

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

Ограничения импорта CSV

• При добавлении значений атрибутов пользователя существует ограничение на 10 миллионов строк в CSV файле.