Персонализация рассылок через шаблонизатор

(% class="lead" %)

Шаблонизатор позволяет кастомизировать текст сообщений (email, SMS, push) в [[массовых рассылках>>doc:Main.Using.Smart_Communications.Mass_mailings.WebHome]] и [[кампаниях>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]]. Каждый клиент увидит в сообщении информацию, которая относится именно к нему.

3

**Содержание:**

== Персонализация ==

Технология персонализации позволяет адаптировать рассылки под каждого клиента. [[Loymax Smart Communications>>doc:Main.Using.Smart_Communications.WebHome]] адаптирует текст сообщения и строит актуальное для клиента предложение, при необходимости выбирая подходящий момент отправки сообщения.

11

**Пример:**

12

В рамках одной и той же рассылки по рекомендуемым товарам:

13

14

* Один клиент получит сообщение (на основе истории покупок) с предложением купить сменные лезвия для бритвы и с блоком о том, что в торговых точках его города действует акция "3 по цене 2".

15

* Другой клиент получит сообщение (на основе истории покупок) с предложением купить зарядное устройство и с промо-блоком о том, что в его городе открылся новый пункт выдачи заказов.

16

17

В Loymax Smart Communications есть инструменты для персонализации:

18

19

* Конструкции шаблонизатора;

20

* Товарные рекомендации.

== Шаблонизатор ==

Шаблонизатор включает в себя:

25

26

* [[Переменные>>doc:||anchor="H41F43544043543C43543D43D44B435432A0SmartCommunications"]] — данные о клиенте, его чеках и продуктах в чеке. Например, с помощью переменной можно вывести в текст сообщения имя клиента;

27

* [[Макросы>>doc:||anchor="H41C43043A44043E44144B"]] — функции, позволяющие вывести информацию о промокодах, опросах и т. д.;

28

* [[Управляющие конструкции>>doc:||anchor="H42343F44043043243B44F44E44943843543A43E43D44144244044343A446438438"]] — циклы, условия, фильтры.

29

30

Пример использования переменной в тексте сообщения:

(% class="box" %)

(((

##Добрый день, ~{~{client.properties.full_name}}.##

35

)))

36

37

При отправке сообщения переменная будет заменена на значение, например:

(% class="box" %)

(((

Добрый день, Иванов Иван Иванович.

42

)))

43

44

== Переменные в Smart Communications ==

45

46

Переменные позволяют подставлять в текст сообщения (а для писем — и в тему письма) данные:

47

48

* Из [[профиля клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="Profile"]]:

49

** Атрибуты и метрики клиента;

50

** Ссылки для [[управления подпиской>>doc:Main.Using.Smart_Communications.Mass_mailings.Mailing_Loyalty_SC.WebHome]];

51

** Атрибуты и содержимое из последнего чека и/или заказа;

52

** Даты;

53

** И любые другие атрибуты;

54

* О чеках клиента;

55

* О продуктах в чеке;

56

* О категории продукта.

Переменные бывают:

* [[Системные>>doc:||anchor="H42143844144243543C43D44B43543F43544043543C43543D43D44B435"]] — служат для доступа к системным полям;

61

* [[Пользовательские>>doc:||anchor="H41F43E43B44C43743E43243044243543B44C44143A43843543F43544043543C43543D43D44B435"]] — для доступа к пользовательским полям. Подробнее о полях можно прочитать [[здесь>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]].

62

63

Формат записи переменной:

(% class="box" %)

(((

##~{~{наименование_переменной}}##

68

)))

69

70

=== Системные переменные ===

71

72

В Smart Communications доступны следующие системные переменные:

73

74

(% class="table-bordered" %)

|=(((

Переменная

)))|=(((

Назначение

)))

|(((

##~{~{client.properties.full_name}}##

)))|(((

Полное имя клиента

)))

|(((

##~{~{client.properties.last_name}}##

)))|(((

Фамилия клиента

)))

|(((

##~{~{client.properties.first_name}}##

)))|(((

Имя клиента

)))

|(((

##~{~{client.properties.middle_name}}##

)))|(((

Отчество клиента

)))

|(((

##~{~{client.properties.register_date}}##

)))|(((

Дата регистрации

)))

|(((

##~{~{client.properties.city}}##

)))|(((

Город клиента

)))

|(((

##~{~{client.properties.zip}}##

)))|(((

Индекс клиента

)))

|(((

##~{~{client.properties.email}}##

)))|(((

E-mail клиента

)))

|(((

##~{~{client.properties.password}}##

)))|(((

Пароль клиента

)))

|(((

##~{~{client.properties.phone}}##

127

)))|(((

128

Номер телефона клиента

129

)))

130

|(((

131

##~{~{client.properties.order_cnt}}##

132

)))|(((

133

Количество чеков клиента

134

)))

135

|(((

136

##~{~{client.properties.order_sum}}##

137

)))|(((

138

Общая сумма всех чеков клиента

139

)))

140

|(((

141

##~{~{client.orders.first.date}}##

142

)))|(((

143

Дата первого чека клиента

144

)))

145

|(((

146

##~{~{client.orders.last.date}}##

147

)))|(((

148

Дата последнего чека клиента

149

)))

150

|(((

151

##~{~{client.orders.last.number}}##

152

)))|(((

153

Номер последнего чека

154

)))

155

|(((

156

##~{~{client.properties.rating}}##

)))|(((

Скоринг клиента

)))

|(((

##~{~{client.links.profile}}##

162

)))|(((

163

Ссылка на профиль клиента на Платформе

164

)))

165

|(((

166

##~{~{client.links.unsubscribe}}##

167

)))|(((

168

Ссылка на [[управление подписками>>doc:Main.Using.Smart_Communications.Mass_mailings.Mailing_Loyalty_SC.WebHome]]

169

)))

170

|(((

171

##~{~{client.links.web_version}}##

172

)))|(((

173

Ссылка на веб-версию письма

174

)))

175

|(((

176

##~{~{client.properties.bonus_active}}##

177

)))|(((

178

Количество активных бонусов

179

)))

180

|(((

181

##~{~{client.properties.bonus_expect_activate}}##

182

)))|(((

183

Количество бонусов, которые ожидают активации

184

)))

185

|(((

186

##~{~{client.properties.bonus_expect_deactivate}}##

187

)))|(((

188

Количество бонусов, которые ожидают деактивации

189

)))

190

|(((

191

##~{~{client.properties.bonus_expect_deactivate_date}}##

192

)))|(((

193

Дата деактивации бонусов

194

)))

195

|(((

196

##~{~{client.properties.bonus_expect_deactivate_next}}##

197

)))|(((

198

Количество бонусов, которые будут деактивированы в ближайшее время

199

)))

200

|(((

201

##~{~{client.eventContext.<код_поля>}}##

202

)))|(((

203

Данные из [[контекста события>>doc:Main.Using.Smart_Communications.Events.WebHome]]

204

)))

205

|(((

206

##~{~{client.containers.webcart.items}}##

)))|(((

Содержимое корзины

)))

|##~{~{client.properties.eorder_cnt}}##|Количество заказов клиента

211

|##~{~{client.properties.eorder_sum}}##|Общая сумма всех заказов клиента

212

|##~{~{client.eorders.first.date}}##|Дата первого заказа клиента

213

|##~{~{client.eorders.last.date}}##|Дата последнего заказа клиента

214

|##~{~{client.eorders.first.number}}##|Номер первого заказа клиента

215

|##~{~{client.eorders.last.number}}##|Номер последнего заказа клиента

216

|##~{~{client.eorders.first.<код поля>}}##|Значение атрибута в первом заказе клиента

217

|##~{~{client.eorders.last.<код поля>}}##|Значение атрибута в последнем заказе клиента

218

|##~{~{client.eorders.first.items}}##|Содержимое первого заказа

219

|##~{~{client.eorders.last.items}}##|Содержимое последнего заказа

220

221

=== Пользовательские переменные ===

222

223

Доступ к пользовательским полям **Клиент/Чек/Строка чека/Категория продукта** осуществляется по их коду с помощью конструкции вида ##~{~{client.properties.<код_поля>}}##. Например:

(% class="box" %)

(((

##~{~{client.properties.eye_color}}##

228

)))

229

230

Узнать код поля можно в разделе **Настройки >** [[Поля>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] во вкладках **Клиенты/Транзакции/Строки транзакций/Категории**.** **Например, код атрибута чека "Статус оплаты" — "payment_status_name".

Для формирования переменной необходимо использовать формат:

235

236

* ##~{~{client.properties.<код поля>}}## — значение атрибута в **профиле** клиента;

237

* ##~{~{client.orders.first.<код поля>}}## — значение атрибута в **первом чеке** клиента;

238

* ##~{~{client.orders.last.<код поля>}}## — значение атрибута в **последнем чеке** клиента.

239

240

Для вывода значений атрибутов продуктов в [[брошенной корзине>>doc:Main.Using.Smart_Communications.Campaign_list.Abandoned_cart.WebHome]], первом и последнем чеке, категории продукта необходимо использовать [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)циклы>>doc:||anchor="H42643843A43B44B"]](%%).

241

242

=== Значение по умолчанию ===

243

244

Для атрибутов с типом **строка** можно установить значение по умолчанию. Это значение будет выведено в тексте сообщения, если атрибут не заполнен. Например, в сообщении можно обратиться к клиенту по имени, а если имя неизвестно — использовать значение по умолчанию:

(% class="box" %)

(((

##~{~{client.properties.full_name|default ('Уважаемый клиент')}##

)))

== Макросы ==

Макросы — это небольшие команды, которые позволяют выполнять заскриптованные действия в Системе. Например, макрос ##~{~{client.promocode('группа промокода')}}## находит и возвращает промокод из группы.

254

255

=== Системные макросы ===

256

257

В Smart Communications доступны макросы:

258

259

(% class="table-bordered" %)

|=(((

Макрос

)))|=(((

Назначение

)))

|(((

##~{~{"now"|date('формат')}}##

)))|(((

Текущая дата

)))

|(((

##~{~{client.promocode('группа промокода')}}##

272

)))|(((

273

Выдать промокод клиенту из группы промокодов

274

)))

275

|(((

276

##~{~{client.last_promocode('группа промокода')}}##

277

)))|(((

278

Последний выданный клиенту промокод из группы

279

)))

280

|(((

281

##~{~{client.last_campaign_promocode('группа промокода')}}##

282

)))|(((

283

Последний промокод из группы, выданный клиенту в рамках этой кампании

284

)))

285

|(((

286

##~{~{client.template_constant('наименование')}}##

)))|(((

Константа региона

)))

|(((

##~{~{client.poll('POLL-идентификатор_опроса')}}##

)))|(((

Ссылка на опрос

)))

|(((

##~{~{client.loyaltyCard.lastActive.number}}##

297

)))|(((

298

Информация по активной карте лояльности клиента

)))

=== Формат дат ===

Поля с типом **дата** можно выводить в разном формате. Для обозначения формата можно использовать любые комбинации следующих значений:

304

305

* Год:

306

** y — 2 цифры (например, 97, 20);

307

** Y — 4 цифры (например, 1997, 2020);

308

* m — месяц (в формате от 01 до 12);

309

* d — день (в формате от 01 до 31);

* h — час;

* i — минута;

* s — секунда.

**Пример 1. Вывод даты в сообщении**

315

316

При заданном формате 'Y-m-d' дата будет выведена в виде '2020-10-20'. При формате 'd.m.Y h:i' — в виде '20.10.2020 11:56'.

317

318

Пример использования макроса **Благодарность клиенту за последний заказ**:

(% class="box" %)

(((

##Спасибо за заказ от ~{~{client.orders.last.date|date('d.m.Y')}}!##

323

)))

324

325

Клиент получит сообщение со строкой вида:

(% class="box" %)

(((

Спасибо за заказ от 29.06.2020!

330

)))

331

332

**Пример 2. Вывод даты на несколько дней позже текущей**

333

334

Чтобы вывести в сообщение дату, которая на несколько дней позже текущей, используйте такой макрос:

(% class="box" %)

(((

##~{~{"now"|date_modify('+1 day')|date('Y-m-d')}}##

339

)))

340

341

В сообщении для клиента будет выведена завтрашняя дата.

342

343

**Пример 3. Вывод даты —** **через месяц после даты регистрации клиента**

344

345

Вывод даты +1 месяц от даты регистрации клиента.

(% class="box" %)

(((

##~{~{client.properties.register_date|date_modify('+1 month')|date('Y-m-d')}}##

350

)))

351

352

== Вставка переменной или макроса в сообщение ==

353

354

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

355

356

|(% style="border-color:white; text-align:center" %){{lightbox image="Editor.png"/}}

357

358

Для вставки пользовательской переменной необходимо напечатать ее вручную.

359

360

== Предварительный просмотр ==

361

362

|(% style="border-color:white; width:1115px" %)(((

363

Чтобы посмотреть, как будет выглядеть сообщение с переменными и макросами, замененными на их значение, используйте кнопку **Предпросмотр сообщения**.

364

)))|(% style="border-color:white; width:324px" %){{lightbox image="Preview.png"/}}

365

|(% style="border-color:white; width:1115px" %)(((

366

Можно увидеть предпросмотр письма для конкретного клиента. Для этого в поле **Клиент** необходимо ввести Фамилию/Имя/Номер телефона/email/идентификатор клиента (local_id). Чтобы результаты поиска были однозначны, рекомендуется искать по номеру телефона/email/локальному идентификатору клиента.

367

368

(% class="box infomessage" %)

369

(((

370

Поиск в поле **Клиент **— регистрозависимый. Имя и фамилию клиента необходимо вводить с заглавной буквы.

371

)))

372

)))|(% style="border-color:white; width:324px" %){{lightbox image="Client3.png"/}}

373

374

== Управляющие конструкции ==

375

376

С помощью управляющих конструкций можно создавать более сложные шаблоны на основе переменных и макросов. Управляющие конструкции включают в себя for-циклы, условия (if/elseif/else) и фильтры. Управляющие конструкции выводятся внутри блоков {% ... %}.

=== Переменные ===

Чтобы несколько раз использовать в сообщении одно и то же выражение, можно ввести переменную. Например, введем переменную ##webcart## для массива элементов в корзине:

(% class="box" %)

(((

##{% set webcart = client.containers.webcart.items %}##

)))

=== Циклы ===

В следующих случаях необходимо использовать циклы:

390

391

* Вывод атрибутов продуктов в первом/последнем чеке клиента;

392

* Вывод атрибутов продуктов в корзине;

393

* Вывод атрибутов категории продукта;

394

* Вывод информации по всем активным картам клиента, если их больше одной.

395

396

Например, можно вывести названия всех продуктов в последнем чеке клиента:

(% class="box" %)

(((

##{% for item in client.orders.last.items%}

~{~{item.name}}

{% endfor %}##

)))

Вывести название и цвет для всех продуктов из корзины:

406

407

(% class="box" %)

408

##{% set webcart = client.containers.webcart.items %}

409

{% for item in webcart %}

~{~{item.name}}

~{~{item.color}}

{% endfor %}##

Вывести название категории для всех продуктов в последнем заказе:

(% class="box" %)

(((

##{% for item in client.orders.last.items%}

419

~{~{item.category.name}}

{% endfor %}##

)))

Вывести информацию по всем активным картам клиента:

(% class="box" %)

(((

##{% for card in client.loyaltyCard.items %}

~{~{card.number}}

{% endfor %}##

)))

=== Условия ===

Можно вывести в сообщении только те данные, для которых выполняется заданное условие. Например, можно выдать [[промокод>>doc:Main.Using.Smart_Communications.Promo_codes.WebHome]] только клиентам из Екатеринбурга:

(% class="box" %)

(((

##{% if client.properties.city == 'Екатеринбург' %}

439

~{~{client.promocode('группа промокода')}}

440

{% endif %}##

441