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

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

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

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

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

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

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

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

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

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 >