Створення додаткових полів

Додаткові поля в картках контактів створюються для зберігання будь-якої специфічної інформації щодо контактів — їхні персональні промокоди, пам’ятні дати, локація тощо. Створення полів дозволяє вам виконувати розширену сегментацію контактів та глибше персоналізувати комунікацію.

Вкладка “Додаткові поля”

Списки додаткових полів знаходяться в налаштуваннях акаунту → вкладка Додаткові поля (за замовчуванням наявний лише список Personal з полями День народження та Стать).

У списку додаткових полів відображаються:

Тип поля (текстове поле, дата тощо).
Назва поля.
Змінна для автоматичного підставляння вмісту поля в повідомлення.
ID поля.
Кнопка редагування поля.
Кнопка видалення поля.

Ви можете створювати списки та додавати в них поля.

Створення списку

Створення списків дозволяє групувати поля за певним спільним значенням: особисті дані, товарні вподобання тощо. Алгоритм створення списку полів наступний:

1. Натисніть кнопку Новий список полів.

2. Введіть назву списку.

3. Ключ персоналізації генерується автоматично на основі назви, але ви можете змінити його. Цей ключ використовується при формуванні змінної для поля з цього списку (тому краще обирати більш лаконічний варіант).

4. Натисніть Зберегти.

📘
Примітка

Список буде неактивним, доки до нього не буде додано перше поле

Перш ніж видалити список з полями, видаліть поля, що він містить

Додавання полів

1. Натисніть плюс, щоб створити поле у списку.

2. Вкажіть назву поля та за необхідністю відредагуйте його автоматично сформований ключ персоналізації.

3. Виберіть тип поля (за замовчуванням він зберігається як текстове поле).

Типи полів

Залежно від типу контактних даних в системі доступні такі типи полів:

Текстове поле може містити до тисячі символів, як літер, так і цілих чисел. Спеціальні символи не підтримуються. Може використовуватися, наприклад, для запису імені та адреси контакту.
Текстова область може містити до п’яти тисяч символів, як літер, так і цілих чисел. Спеціальні символи не підтримуються. Може використовуватися, наприклад, для запису відповідей на розгорнуті питання.
Число може містити тільки цілочисельні значення від -2147483647 до 2147483647 (ID замовлення, кількість бонусів тощо).
Дробове число може містити цілі числа й дроби (сума замовлень тощо).
Дата — значення мають передаватися в форматі ISO 8601. Формат дати: РРРР-ММ-ДД. Параметр Регулярна дата використовується для створення умовних груп для регулярної комунікації з приводу повторюваної події, як то річниця, день народження тощо.

Дата з часом — формат даних: РРРР-ММ-ДДГГ:ХХ (термін дії промокоду тощо).
Випадаючий список містить заздалегідь визначені значення: стать, статус чи мова контакту.

📘
Важливо
Не використовуйте символ крапки в назві поля. Наприклад, Marital status (Сімейний стан) можна написати через пробіл або нижнє підкреслення

Чекбокс надає контакту можливість вибрати більш ніж один варіант відповіді.

Щоб записати чи оновити поле чекбоксу за допомогою API-методу Add/update contacts, передайте ID поля (вказане у списку полів числове значення) в масиві fields й вкажіть значення через кому:

{
  "fields": [
    {
      "id": 87166,
      "value": "Chinese"
    }
  ]
}

Також вкажіть ідентифікатор в об’єкті customFieldsIDs — список ID додаткових полів, які необхідно оновити. Оновлюються лише ті додаткові поля контактів, ідентифікатори яких вказані в цьому списку.

📘
Примітка
Після створення додаткового поля системі знадобиться до години на синхронізацію, після чого поле стане доступним для використання через АРІ.

Оновлення додаткових полів даними з користуваьких подій через SDK

Використовуйте змінні полів контактів без символів % як ключі для оновлення відповідних полів контактів через SDK.

Приклад для Android:

{
   "userAttributes":{
      "email":user.mail,
      },
      "fields":[
         {
            "key":"TRAININGAPP.GOAL",
            "value":"lose weight"
         }
      ]
   }
}


Reteno.setUserAttributes(externalUserId: String, user: User?)

Приклад для iOS:

let UserAttributes = .init(
    email: user.email
    fields: [.init(key: "TRAININGAPP.GOAL", value: "lose weight")]
}


Reteno.updateUserAttributes(externalUserId: "USER_ID", attributes: UserAttributes)

Докладніше про мобільний SDK >

Updated 4 days ago