Розширені параметри блоків сценаріїв

Розширені параметри необхідно заповнювати в таких випадках:

• Використання нестандартних параметрів подій
• Відправлення повідомлень додатковому контакту
• Підстановка динамічного контенту

Перелік розширених параметрів:

Далі докладно розглянемо кожен випадок заповнення параметрів.

Використання нестандартних параметрів подій

За замовчуванням, щоб ідентифікувати контакт для відправцювання сценарію, в події мають передаватись стандартні параметри:

❗️

Важливо

1. Основним ідентифікатором є ContactId. Якщо він не вказаний, але передається хоча б один з інших ідентифікаторів, то ContactId автоматично додасться в подію.
2. Для запуску сценаріїв система ідентифікує контакт для якого надійшла подія. Пошук контакту відбувається за такими правилами: 

• ID контакту має найвищий пріоритет серед усіх параметрів.
• Вказані в полі блоку email контакту, номер телефону чи токен використовуються для відправлення повідомлень.
• Якщо задано externalCustomerId, виконується відправлення контакту, якому він належить; серед тих, що були знайдені за email-адресою, номером телефону чи токеном.
• Якщо externalCustomerId не задано, виконується відправлення контакту, знайденому за email адресою, номером телефону чи токеном.
• Якщо контакт не знайдено, для відправлення буде створено новий контакт.

3. Для узгодженості даних передавайте назву параметрів відповідно до вказаного переліку.

Якщо в події параметри не відповідають стандартним значенням, наприклад, замість “EmailAddress” вказано “PersonalEmail”.

В цьому випадку у полі “Email” вкажіть назву відповідної змінної.

Відправлення повідомлень додатковому контакту

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

Підстановка динамічного контенту

Використовується у випадку, коли необхідно вивести певні дані з події в повідомленні. 

Наприклад, якщо подія містить JSON: 

{
    "eventTypeKey": "AbandonedCart",
    "keyValue": "2424925572",
    "params": [
        {
            "name": "cartItems",
            "value": [
                {
                    "name": "Кондиціонер для сухого волосся",
                    "price": "341",
                    "url": "https://esputnik.com/uk",
                    "imageurl": "https://site.com/uploads/product/big/20161122/20161122_7zvb.jpg",
                    "brand": "Le Petit Olivier",
                    "tags_weight": "200",
                    "tags_oldprice": "467"
                },
                {
                    "name": "Magnolia Nobile Парфумована вода",
                    "price": "2341",
                    "url": "https://site.com/catalog/suhaya-detskaya-molochnaya-smes-hipp-combiotic-2-750-g",
                    "imageurl": "https://site.com/uploads/product/big/20161122/20161122_7zvb.jpg",
                    "brand": "Acqua Di Parma",
                    "tags_weight": "100",
                    "tags_oldprice": "4467"
                }
            ]
        },
        {
            "name": "recommendedItems",
            "value": [
                {
                    "name": "Шампунь для сухого волосся",
                    "price": "441",
                    "url": "https://esputnik.com/uk",
                    "imageurl": "https://site.com/uploads/product/big/20161122/20161122_7zvb.jpg",
                    "brand": "Le Petit Olivier",
                    "tags_weight": "200",
                    "tags_oldprice": "467"
                },
                {
                    "name": "Magnolia Nobile Крем для обличчя",
                    "price": "1341",
                    "url": "https://site.com/catalog/suhaya-detskaya-molochnaya-smes-hipp-combiotic-2-750-g",
                    "imageurl": "https://site.com/uploads/product/big/20161122/20161122_7zvb.jpg",
                    "brand": "Acqua Di Parma",
                    "tags_weight": "100",
                    "tags_oldprice": "4467"
                }
            ]
        },
        {
            "name": "emailAddress",
            "value": [email protected]
        }
    ]
}

де:

• name - назви масивів та полів,
• value -значення, яке необхідно підставити в повідомлення.

У повідомленні вкажіть змінні, які будуть відображати товари в повідомленні:

• $!data.get('recommendedItems') — у дужках вакзується назва масиву, з якого треба підставити дані;
• get(0) — у дужках вакзується індекс елементів масиву (відлік починається з 0);
• get('price') — у дужках вакзується назва параметру події, з якого треба підставити дані.

В результаті змінна може виглядати так:

• $!data.get('recommendedItems').get(0).get('price')

Детальніше про використання Velocity в email >