Сравнение версий

Старая версия 60

changes.mady.by.user Кадубовский Андрей (Twin)

Сохранено

по сравнению с

Новая версия 61

changes.mady.by.user Кадубовский Андрей (Twin)

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

После того как вы выполните описанные выше действия, язык виджета будет изменен на английский. Переведите сценарий на английский язык и разместите виджет на англоязычной версии страницы вашего сайта.

Якорь
colorwidgetsettingscolor
widgetsettings

Как подключить к виджету метрики yandexMetrika и googleAnalytics

Вы можете настроить сбор статистики по действиям пользователей в виджете с помощью метрик yandexMetrika и googleAnalytics. Для этого в объекте analytics нужно разместить дочерние объекты yandexMetrika и googleAnalytics. Сам объект analytics должен быть расположен внутри объекта appearance. Ниже приводится описание объектов analytics, yandexMetrika и googleAnalytics.

  • analytics – содержит свойства, которые позволяют подключить яндекс метрику для оценки частоты использования чата:
    • yandexMetrika – имя используемой метрики;
      • counter – идентификатор яндекс метрики;
      • method – метод, который нужно вызывать при инициализации виджета. Можно использовать любой метод. По умолчанию применяется метод 'ym';
      • prefix – пространство имен для идентификации событий виджета в отчетах Яндекс.Метрики. По умолчанию используется значение 'chat-widget'.
    • googleAnalytics – имя используемой метрики;
      • counter – идентификатор метрики Google Analytics;
      • method – метод, который нужно вызывать при инициализации виджета. Можно использовать любой метод. По умолчанию применяется метод 'gtag';
      • prefix – пространство имен для идентификации событий виджета в отчетах Google Analytics. По умолчанию используется значение 'chatWidget'.
Блок кода
languagejs
linenumberstrue
Блок кода
languagejs
linenumberstrue
TwinChat.init('#twin-chat-container', {
            chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244',
            sessionDefaultsanalytics: {
                name: 'Диалог с клиентом',
    yandexMetrika: {
                        clientExternalIdcounter: 'externalKey86962928',
                clientEmail: 'client@mail.ru',
       // method: 'ym',
       clientPhone: '79111234567',
                 // clientNameprefix: 'Иван/chat-widget',
                   orderNumber: '1234567'},
                clientDeviceId: '0000-1111-2222-3333-44444444',
    {
            clientTimezone: '-300'
           googleAnalytics: },{
            appearance: {
                langcounter: 'en88777666',
                start: {
                    mode// method: 'messengerButtonsgtag',
                },
                rating: {
                    midterm: 'Оцените, как проходит диалог// prefix: 'ChatWidget',
                }
                analytics: {},
                    yandexMetrika: {},
                }         counter: '86962928',
         

Image Added

Раскрыть
titleПолный фрагмент кода инициализации виджета


Блок кода
languagejs
linenumberstrue
<!DOCTYPE html>
<html>
<body>
<div id="twin-chat-container"></div> 
<script> 
  (function () { 
    const script = document.createElement('script'); 
    script.async =
// method: 'ym',
true; 
    script.src 
= 'https://modern-v3.twin24.ai/manual.umd.min.js'; 
    document.head.appendChild(script); 
    script.onload = () => {
//
prefix:
'/
TwinChat.init('#twin-chat-
widget
container',
 { 
        chatId: 'febb3685-2cbc-4815-ba13-96199f9b8beb',
		  sessionDefaults: {
}, 
          name: 
'Черная пятница',
{ 
          clientMetadata: {
googleAnalytics:
{ 
      orderNumber: 31,
counter
address:
'88777666'
"Москва,
 Некрасова 13",
                    finalDate: '13 июня 2022 года'
//
method:
'gtag', 
             },
//
prefix
clientEmail: '
ChatWidget
client@mail.ru',
                clientPhone: '79111234567',
}, 
       clientName: 'Иван',
            },
            appearance: {
} TwinChat.init('#twin-chat-container', {
chatId
lang: '
35a40e2c-4955-4ae3-a8e0-559fd4381244
en',
sessionDefaults
start: {
name
    mode: '
Диалог с клиентом
messengerButtons',
clientExternalId: 'externalKey'
},
clientMetadata
 analytics: {
age
yandexMetrika:
31,
{
topic:
"Открытие
магазина", 
  counter: '86962928',
city:
'Москва' 
      // method: 'ym',
}, 
               //
clientEmail
prefix: '
client@mail.ru
/chat-widget',
clientPhone:
'79111234567', 
   
},
clientName:
'Иван', 
         {
orderNumber:
'1234567',
clientDeviceId
googleAnalytics:
'0000-1111-2222-3333-44444444',
{
clientTimezone:
'-300' 
           counter:
}
'88777666',
appearance:
{ 
               //
lang
method: '
en
gtag',
start:
{
mode
// prefix: '
messengerButtons
ChatWidget',
},
rating: {
},
midterm: 'Оцените, как проходит диалог'
},
} 
    }
analytics:
{ 
     },		
      }).then(client => window.TwinClient
yandexMetrika: { counter: '86962928', // method: 'ym', // prefix: '/chat-widget', }, { googleAnalytics: { counter: '88777666', // method: 'gtag', // prefix: 'ChatWidget', }, }, }

...

Виджет имеет настройки, которые задаются при помощи объектов sessionDefaults, appearance и analytics. Ниже приводится фрагмент кода с этими объектами.

Блок кода
languagejs
linenumberstrue
TwinChat.init('#twin-chat-container', {
            chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244',
            sessionDefaults: {
                name: 'Диалог с клиентом',
                clientExternalId: 'externalKey',
                clientEmail: 'client@mail.ru',
                clientPhone: '79111234567',
                clientName: 'Иван',
                orderNumber: '1234567',
                clientDeviceId: '0000-1111-2222-3333-44444444',
                clientTimezone: '-300'
            },
            appearance: {
                lang: 'en',
                start: {
                    mode: 'messengerButtons',
                },
                rating: {
                    midterm: 'Оцените, как проходит диалог',
                }
                analytics: {
                    yandexMetrika: {
                        counter: '86962928',
                        // method: 'ym',
                        // prefix: '/chat-widget',
                    },
                    {
                        googleAnalytics: {
                            counter: '88777666',
                            // method: 'gtag',
                            // prefix: 'ChatWidget',
                        },
                    },
                }





TwinChat.init('#twin-chat-container', {
            chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244',
            sessionDefaults: {
                name: 'Диалог с клиентом',
                clientExternalId: 'externalKey',
                clientMetadata: {
                    age: 31,
                    topic: "Открытие магазина",
                    city: 'Москва'
                },
                clientEmail: 'client@mail.ru',
                clientPhone: '79111234567',
                clientName: 'Иван',
                orderNumber: '1234567',
                clientDeviceId: '0000-1111-2222-3333-44444444',
                clientTimezone: '-300'
            },
            appearance: {
                lang: 'en',
                start: {
                    mode: 'messengerButtons',
                },
                rating: {
                    midterm: 'Оцените, как проходит диалог',
                }
                analytics: {
                    yandexMetrika: {
                        counter: '86962928',
                        // method: 'ym',
                        // prefix: '/chat-widget',
                    },
                    {
                        googleAnalytics: {
                            counter: '88777666',
                            // method: 'gtag',
                            // prefix: 'ChatWidget',
                        },
                    },
                }

Объект sessionDefaults  передает в сценарий виджета системные и пользовательские переменные (например, ФИО клиента, день недели, контактный номер телефона, идентификатор клиента во внешней системе). Данные переменные можно использовать в диалогах виджета.

В указанном выше фрагменте кода используются следующие переменные:

...

  • yandexMetrika – имя используемой метрики;
    • counter – идентификатор яндекс метрики;
    • method – метод, который нужно вызывать при инициализации виджета. Можно использовать любой метод. По умолчанию применяется метод 'ym';
    • prefix – пространство имен для идентификации событий виджета в отчетах Яндекс.Метрики. По умолчанию используется значение 'chat-widget'.

...

= client); 
    }; 
  })(); 
</script>

</body>
</html>



Подсказка
Подробнее о метриках см. Сбор статистики по действиям пользователей в виджете c помощью Яндекс.Метрикии Сбор статистики по действиям пользователей в виджете c помощью Google Analytics
Подсказка
Ниже указано место размещения фрагмента кода с объектами sessionDefaults,appearance и analyticsв код инициализации виджета:Image Removed.

...