Використання Velocity у мобільних пушах

Дізнайтеся, як створювати мобільні push-сповіщення з динамічними змінними. Аналогічно ви можете використовувати змінні в SMS та веб-повідомленнях.

Як приклад ми будемо використовувати мобільне push-повідомлення з підтвердженням замовлення та додамо до нього динамічні деталі замовлення.

Створення мобільного push-сповіщення

  1. Перейдіть до ПовідомленняПовідомлення та відкрийте або створіть Mobile Push.
  2. Використовуйте змінні velocity у контенті повідомлення, де мають бути замінені особисті контактні дані.

Щоб отримати доступ до даних масиву, в повідомленні повинна використовуватися структура циклу foreach, вбудована в код. На прикладі масиву orderData velocity-код виглядає так:

// Inside the structure, the data are extracted in a sequence from every element of the array
#foreach($order in $!data.get('orderData'))
  // To extract the value from the name field of the order 
  $!order.get('name') 
  // For the price field
  $!order.get('price')
#end
📘

Зверніть увагу

Команда витягти дані data.get необхідна лише при зверненні до рекомендаційних або зовнішніх джерел даних. В усіх інших випадках ви також можете використовувати формат, описаний в документації Velocity версії 2.4.1.

Наприклад:

ФорматЗміннаОпис
Скорочний$discountЯкщо змінної немає —виводиться буквальний текст $discount
Тихий$!discountЯкщо значення відсутнє, нічого не виводиться
Формальний${discount}Дужки для однозначного відокремлення імені змінної від сусіднього тексту
Тихий формальний$!{discount}Коректно відокремлює змінну та приглушує відсутні значення
Альтернативне значення${discount|$otherGift}Якщо значення змінної відсутнє, підставляє запасне значення

Аналогічно для масиву, що передає recommendationsData:

// Inside the structure, the data are extracted in a sequence from every element of the array
#foreach($recomm in $!data.get('recommendationsData'))
  $!recomm.get('name')
  $!recomm.get('price')
#end

В результаті динамічної підстановки повідомлення може виглядати так (оформлення повідомлення може відрізнятися залежно від версії ОС):

📘

Важливо

Мобільне сповіщення відображається по-різному на різних пристроях, але ми рекомендуємо використовувати не більше 40 символів. Якщо вміст масиву може перевищити цей обсяг, цикл foreach краще не використовувати. Натомість можна звернутися до певного елементу масиву. Тоді конструкція velocity для масиву orderData буде виглядати так: $!data.get('orderData').get(0).get('name'). У такій конструкції виводиться перший елемент масиву (нумерація починається з 0).