Google Analytics 4 — различия между версиями

Материал из MstarProject Manual
Перейти к: навигация, поиск
(Новая страница: «'''Модуль электронной торговли Google Аналитики 4 (GA4)'''.»)
 
(→‎remove_from_cart)
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
 
'''Модуль электронной торговли Google Аналитики 4 (GA4)'''.
 
'''Модуль электронной торговли Google Аналитики 4 (GA4)'''.
 +
 +
В данном модуле реализовано передачу событий на уровень данных для функции электронной торговли Google Аналитики 4 (GA4).
 +
<br>
 +
Настройка:
 +
<br>
 +
а) в константе ecommerce:project_name указать адрес своего сайта (например auto-parts.com) при отправке тегов данные будут сверяться со значениями константы и отправляться при условии совпадении доменного имени со значением константы.
 +
<br>
 +
б) в константе ecommerce:locale задаём язык на котором будут отправляться данные значение ua-украинский , ru-русский (по умолчанию ua).
 +
<br>
 +
<br>
 +
Список событий:
 +
 +
==== view_item_list====
 +
Фиксируется список товаров,передается массивом по мере отображения пользователю (Рубрикатор,Группы товара, Поиск)
 +
<br>
 +
Пример отправки события при поиске товара:
 +
        window.dataLayer = window.dataLayer || [];
 +
        dataLayer.push({ ecommerce: null }); 
 +
        dataLayer.push({
 +
        event: "view_item_list",
 +
        "ecommerce": {
 +
          "items": [
 +
                      {
 +
                  "item_name": "KNECHT/MAHLE", 
 +
                  "item_id": "OC90",     
 +
                  "price": "156.24",                     
 +
                  "item_brand": "KNECHT/MAHLE",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },  {
 +
                  "item_name": "KNECHT/MAHLE", 
 +
                  "item_id": "OC90",     
 +
                  "price": "183.15",                     
 +
                  "item_brand": "KNECHT/MAHLE",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },  {
 +
                  "item_name": "CHAMPION", 
 +
                  "item_id": "COF101102S",     
 +
                  "price": "143.52",                     
 +
                  "item_brand": "CHAMPION",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },  {
 +
                  "item_name": "BLUE PRINT", 
 +
                  "item_id": "ADG02102",     
 +
                  "price": "169.05",                     
 +
                  "item_brand": "BLUE PRINT",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },  {
 +
                  "item_name": "BOSCH", 
 +
                  "item_id": "1457429178",     
 +
                  "price": "220.95",                     
 +
                  "item_brand": "BOSCH",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },  {
 +
                  "item_name": "BOSCH", 
 +
                  "item_id": "1457429178",     
 +
                  "price": "280.72",                     
 +
                  "item_brand": "BOSCH",         
 +
                  "item_category": "Масляный фильтр",
 +
                  "item_category2": "Фильтры",
 +
                  "item_category3": "Двигатель и Система выхлопа",     
 +
                  "item_list_name": "catalog_price_view"                             
 +
                  },
 +
                ]
 +
            }
 +
        });
 +
 +
==== select_item====
 +
Фиксация кликов по продуктам в списке. Передается описание товара по которому выполнен клик. В поле item_list_name передаётся название название списка, из которого выполняется переход.
 +
<br>
 +
Пример отправки события при переходе на товар из рубрикатора (каталога товаров):
 +
 +
            window.dataLayer = window.dataLayer || [];
 +
            dataLayer.push({ ecommerce: null }); 
 +
            dataLayer.push({
 +
            event: "select_item",
 +
            "ecommerce": {
 +
              "items": [
 +
                          {
 +
                      "item_name": "FEBI BILSTEIN", 
 +
                      "item_id": "24196",
 +
                      "item_brand": "FEBI BILSTEIN",         
 +
                      "item_category": "Антифриз",
 +
                      "item_category2": "Жидкости",
 +
                      "item_category3": "Смазки и Жидкости",       
 +
                      "item_list_name": "rubricator",
 +
                      "price": "175.50"                             
 +
                      }
 +
                    ]
 +
                }
 +
            });
 +
 +
==== view_item====
 +
Фиксирует отображения карточки товара.
 +
<br>
 +
Пример отправки события:
 +
            window.dataLayer = window.dataLayer || [];
 +
            dataLayer.push({ ecommerce: null }); 
 +
            dataLayer.push({
 +
            event: "view_item",
 +
            "ecommerce": {
 +
              "items": [
 +
                          {
 +
                      "item_name": "GATES", 
 +
                      "item_id": "5204XS",
 +
                      "item_brand": "GATES",         
 +
                      "item_category": "Ремень ГРМ",
 +
                      "item_category2": "Ремни, цепи и натяжители",
 +
                      "item_category3": "Двигатель и Система выхлопа",       
 +
                      "item_list_name": "buy",
 +
                      "price": "78.20"                             
 +
                      }
 +
                    ]
 +
                }
 +
            });
 +
               
 +
==== add_to_cart====
 +
Фиксирует все добавления товара в корзину, а также все увеличения числа единиц товара в корзине (“+” или “стрелка вверх”).
 +
<br>
 +
Пример отправки события:
 +
                    $( document ).ready(function() {
 +
                    window.dataLayer = window.dataLayer || [];
 +
                    dataLayer.push({ ecommerce: null }); 
 +
                    dataLayer.push({
 +
                    event: "add_to_cart",
 +
                    "ecommerce": {
 +
                      "items": [
 +
                                  {
 +
                              "item_name": "NIPPARTS", 
 +
                              "item_id": "J1342023",
 +
                              "price": "97.72" ,
 +
                              "item_brand": "NIPPARTS",         
 +
                              "item_category": "Фильтр салона",
 +
                              "item_category2": "Диск сцепления",
 +
                              "item_category3": "Система сцепления",     
 +
                              "item_list_name": "rubricator",
 +
                              "quantity": "1"                             
 +
                              }
 +
                            ]
 +
                        }
 +
                    });
 +
                   
 +
              }); 
 +
 +
==== remove_from_cart====
 +
Фиксирует удаление товара из корзины и уменьшения единиц товара в корзине (“-” или “стрелка вниз”).
 +
<br>
 +
Пример отправки события:
 +
                   
 +
                $( document ).ready(function() {
 +
                    window.dataLayer = window.dataLayer || [];
 +
                    dataLayer.push({ ecommerce: null }); 
 +
                    dataLayer.push({
 +
                    event: "remove_from_cart",
 +
                    "ecommerce": {
 +
                      "items": [
 +
                                  {
 +
                                  "item_name": "KNECHT", 
 +
                                  "item_id": "OC90",
 +
                                  "price": "156.24" ,
 +
                                  "item_brand": "KNECHT",         
 +
                                  "item_category": "Масляный фильтр",
 +
                                  "quantity": "1"                             
 +
                                  }
 +
                            ]
 +
                        }
 +
                    });
 +
                });
 +
 +
==== begin_checkout====
 +
Фиксирует покупку, передает список товаров которые есть в корзине (чекаут).
 +
<br>
 +
Пример отправки события:
 +
                                window.dataLayer = window.dataLayer || [];
 +
                                dataLayer.push({ ecommerce: null }); 
 +
                                dataLayer.push({
 +
                                event: "begin_checkout",
 +
                                "ecommerce": {
 +
                                    "items": [
 +
                                              {
 +
                                      "item_name": "STARLINE", 
 +
                                      "item_id": "SFKF9549",     
 +
                                      "price": "108.43",                     
 +
                                      "item_brand": "STARLINE",         
 +
                                      "item_category": "Фильтр салона",
 +
                                      "item_category2": "Диск сцепления",
 +
                                      "item_category3": "Система сцепления",   
 +
                                      "quantity": 2                             
 +
                                      },  {
 +
                                      "item_name": "WIX FILTERS", 
 +
                                      "item_id": "WP2128",     
 +
                                      "price": "109.96",                     
 +
                                      "item_brand": "WIX FILTERS",         
 +
                                      "item_category": "Фильтр салона",
 +
                                      "item_category2": "Диск сцепления",
 +
                                      "item_category3": "Система сцепления",   
 +
                                      "quantity": 2                             
 +
                                      },
 +
                                        ]
 +
                                    }
 +
                                });
 +
                           
 +
 +
==== purchase====
 +
Фиксирует транзакцию покупки.
 +
<br>
 +
При покупке купить в 1 клик перед событием purchase эмулируются события add_to_cart и begin_checkout, а при покупке по номеру телефона begin_checkout.
 +
<br>
 +
Пример отправки события:
 +
 +
                        window.dataLayer = window.dataLayer || [];
 +
                        dataLayer.push({ ecommerce: null }); 
 +
                        dataLayer.push({
 +
                        event: "purchase",
 +
                        "ecommerce": {
 +
                          transaction_id: "48",                   
 +
                          value: "488.82",                       
 +
                          "currency": "UAH",
 +
                                "items": [
 +
                                      {
 +
                                  "item_name": "FEBI BILSTEIN", 
 +
                                  "item_id": "24196",     
 +
                                  "price": "175.50",                     
 +
                                  "item_brand": "FEBI BILSTEIN",         
 +
                                  "item_category": "Антифриз",
 +
                                  "item_category2": "Жидкости",
 +
                                  "item_category3": "Смазки и Жидкости",     
 +
                                  "quantity": 1                             
 +
                                  },  {
 +
                                  "item_name": "FEBI BILSTEIN", 
 +
                                  "item_id": "02374",     
 +
                                  "price": "313.32",                     
 +
                                  "item_brand": "FEBI BILSTEIN",         
 +
                                  "item_category": "Антифриз",
 +
                                  "item_category2": "Жидкости",
 +
                                  "item_category3": "Смазки и Жидкости",     
 +
                                  "quantity": 1                             
 +
                                  },
 +
                                ]
 +
                            }
 +
                        });

Текущая версия на 11:54, 18 января 2024

Модуль электронной торговли Google Аналитики 4 (GA4).

В данном модуле реализовано передачу событий на уровень данных для функции электронной торговли Google Аналитики 4 (GA4).
Настройка:
а) в константе ecommerce:project_name указать адрес своего сайта (например auto-parts.com) при отправке тегов данные будут сверяться со значениями константы и отправляться при условии совпадении доменного имени со значением константы.
б) в константе ecommerce:locale задаём язык на котором будут отправляться данные значение ua-украинский , ru-русский (по умолчанию ua).

Список событий:

view_item_list

Фиксируется список товаров,передается массивом по мере отображения пользователю (Рубрикатор,Группы товара, Поиск)
Пример отправки события при поиске товара: 

       window.dataLayer = window.dataLayer || [];
       dataLayer.push({ ecommerce: null });  
       dataLayer.push({
       event: "view_item_list",
       "ecommerce": {
          "items": [
                      {
                 "item_name": "KNECHT/MAHLE",  
                 "item_id": "OC90",       
                 "price": "156.24",                       
                 "item_brand": "KNECHT/MAHLE",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },   {
                 "item_name": "KNECHT/MAHLE",  
                 "item_id": "OC90",       
                 "price": "183.15",                       
                 "item_brand": "KNECHT/MAHLE",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },   {
                 "item_name": "CHAMPION",  
                 "item_id": "COF101102S",       
                 "price": "143.52",                       
                 "item_brand": "CHAMPION",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },   {
                 "item_name": "BLUE PRINT",  
                 "item_id": "ADG02102",       
                 "price": "169.05",                       
                 "item_brand": "BLUE PRINT",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },   {
                 "item_name": "BOSCH",  
                 "item_id": "1457429178",       
                 "price": "220.95",                       
                 "item_brand": "BOSCH",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },   {
                 "item_name": "BOSCH",  
                 "item_id": "1457429178",       
                 "price": "280.72",                       
                 "item_brand": "BOSCH",          
                 "item_category": "Масляный фильтр", 
                 "item_category2": "Фильтры",
                 "item_category3": "Двигатель и Система выхлопа",      
                 "item_list_name": "catalog_price_view"                              
                 },
               ]
           }
       });

select_item

Фиксация кликов по продуктам в списке. Передается описание товара по которому выполнен клик. В поле item_list_name передаётся название название списка, из которого выполняется переход.
Пример отправки события при переходе на товар из рубрикатора (каталога товаров): 

           window.dataLayer = window.dataLayer || [];
           dataLayer.push({ ecommerce: null });  
           dataLayer.push({
           event: "select_item",
           "ecommerce": {
              "items": [
                          {
                     "item_name": "FEBI BILSTEIN",  
                     "item_id": "24196",
                     "item_brand": "FEBI BILSTEIN",          
                     "item_category": "Антифриз", 
                     "item_category2": "Жидкости",
                     "item_category3": "Смазки и Жидкости",        
                     "item_list_name": "rubricator",
                     "price": "175.50"                              
                     }
                   ]
               }
           });

view_item

Фиксирует отображения карточки товара.
Пример отправки события: 

           window.dataLayer = window.dataLayer || [];
           dataLayer.push({ ecommerce: null });  
           dataLayer.push({
           event: "view_item",
           "ecommerce": {
              "items": [
                          {
                     "item_name": "GATES",  
                     "item_id": "5204XS",
                     "item_brand": "GATES",          
                     "item_category": "Ремень ГРМ", 
                     "item_category2": "Ремни, цепи и натяжители",
                     "item_category3": "Двигатель и Система выхлопа",        
                     "item_list_name": "buy",
                     "price": "78.20"                              
                     }
                   ]
               }
           });

add_to_cart

Фиксирует все добавления товара в корзину, а также все увеличения числа единиц товара в корзине (“+” или “стрелка вверх”).
Пример отправки события: 

                   $( document ).ready(function() {
                   window.dataLayer = window.dataLayer || [];
                   dataLayer.push({ ecommerce: null });  
                   dataLayer.push({
                   event: "add_to_cart",
                   "ecommerce": {
                      "items": [
                                  {
                             "item_name": "NIPPARTS",  
                             "item_id": "J1342023",
                             "price": "97.72" ,
                             "item_brand": "NIPPARTS",          
                             "item_category": "Фильтр салона", 
                             "item_category2": "Диск сцепления",
                             "item_category3": "Система сцепления",      
                             "item_list_name": "rubricator",
                             "quantity": "1"                              
                             }
                           ]
                       }
                   });
                   
              });

remove_from_cart

Фиксирует удаление товара из корзины и уменьшения единиц товара в корзине (“-” или “стрелка вниз”).
Пример отправки события: 

               $( document ).ready(function() {
                   window.dataLayer = window.dataLayer || [];
                   dataLayer.push({ ecommerce: null });  
                   dataLayer.push({
                   event: "remove_from_cart",
                   "ecommerce": {
                      "items": [
                                  {
                                 "item_name": "KNECHT",  
                                 "item_id": "OC90",
                                 "price": "156.24" ,
                                 "item_brand": "KNECHT",          
                                 "item_category": "Масляный фильтр", 
                                 "quantity": "1"                              
                                 }
                           ]
                       }
                   });
               });

begin_checkout

Фиксирует покупку, передает список товаров которые есть в корзине (чекаут).
Пример отправки события: 

                               window.dataLayer = window.dataLayer || [];
                               dataLayer.push({ ecommerce: null });  
                               dataLayer.push({
                               event: "begin_checkout",
                               "ecommerce": {
                                   "items": [
                                              {
                                     "item_name": "STARLINE",  
                                     "item_id": "SFKF9549",       
                                     "price": "108.43",                       
                                     "item_brand": "STARLINE",          
                                     "item_category": "Фильтр салона", 
                                     "item_category2": "Диск сцепления", 
                                     "item_category3": "Система сцепления",     
                                     "quantity": 2                              
                                     },   {
                                     "item_name": "WIX FILTERS",  
                                     "item_id": "WP2128",       
                                     "price": "109.96",                       
                                     "item_brand": "WIX FILTERS",          
                                     "item_category": "Фильтр салона", 
                                     "item_category2": "Диск сцепления", 
                                     "item_category3": "Система сцепления",     
                                     "quantity": 2                              
                                     },
                                       ]
                                   }
                               });

purchase

Фиксирует транзакцию покупки.
При покупке купить в 1 клик перед событием purchase эмулируются события add_to_cart и begin_checkout, а при покупке по номеру телефона begin_checkout.
Пример отправки события: 

                       window.dataLayer = window.dataLayer || [];
                       dataLayer.push({ ecommerce: null });  
                       dataLayer.push({
                       event: "purchase",
                       "ecommerce": {
                          transaction_id: "48",                    
                          value: "488.82",                        
                          "currency": "UAH",
                               "items": [
                                      {
                                 "item_name": "FEBI BILSTEIN",  
                                 "item_id": "24196",       
                                 "price": "175.50",                       
                                 "item_brand": "FEBI BILSTEIN",          
                                 "item_category": "Антифриз", 
                                 "item_category2": "Жидкости",
                                 "item_category3": "Смазки и Жидкости",      
                                 "quantity": 1                              
                                 },   {
                                 "item_name": "FEBI BILSTEIN",  
                                 "item_id": "02374",       
                                 "price": "313.32",                       
                                 "item_brand": "FEBI BILSTEIN",          
                                 "item_category": "Антифриз", 
                                 "item_category2": "Жидкости",
                                 "item_category3": "Смазки и Жидкости",      
                                 "quantity": 1                              
                                 },
                               ]
                           }
                       });
Источник — «http://manual.mstarproject.com/index.php?title=Google_Analytics_4&oldid=4663»