Як включити нестандартні дані до звітів
Вимоги
Спеціальні параметри та показники доступні лише у тих ресурсах, де використовується Universal Analyticsабо є принаймні одна вистава для програми. Спеціальні параметри та показники підтримуються в Analytics SDK для Android та iOS версії 2.x і вище, а також у бібліотеці analytics.js та на платформі Measurement Protocol.
Щоб використовувати спеціальні параметри та показники, необхідно настроїти обліковий запис Analytics та код відстеження.
Обмеження
У кожному ресурсі є 20 індексів для персоналізованих параметрів і ще 20 – для показників. Для облікових записів Analytics Преміум ці обмеження збільшені до 200 кожне.
Видалити спеціальний параметр неможливо, але його можна вимкнути. Не рекомендується повторно використовувати спеціальні параметри. Після зміни імені, області дії та значення спеціального параметра у звіті може виявитися як старий варіант, і новий. В результаті дані виявляться неточними, а відфільтрувати їх буде неможливо.
Робота зі спеціальними параметрами та показниками
Налаштування
Насамперед необхідно визначити значення спеціальних параметрів та показників у ресурсі Analytics. У кожному ресурсі може бути до 20 спеціальних параметрів та стільки ж спеціальних показників.
Вам необхідно вказати назву та інші властивості спеціального параметра або показника з певним номером. Для спеціальних параметрів задаються такі настройки:
Для спеціальних показників задаються такі настройки:
- Назва– під цим ім'ям спеціальний показник фігуруватиме у звітах.
- Тип– визначає, як значення спеціального показника відображатиметься у звітах.
- Мінімальне/максимальне значення– мінімальне та максимальне значення, які будуть оброблятися та заноситись до звітів.
- Активний– вказує, чи оброблятиметься значення спеціального показника. Спеціальні неактивні показники будуть з'являтися у звітах, але їх значення не будуть оброблятися.
Створити спеціальні параметри та показники можна в інтерфейсі Analytics.
Не змінюйте назви та область дії спеціальних параметрів та показників без нагальної потреби. .
Збір даних
Значення спеціальних параметрів та показників передаються в Analytics у вигляді пар "номер-значення". При цьому використовується номер, який ви поставили для спеціального параметра або показника під час .
На відміну від інших даних, спеціальні параметри та показники передаються в Analytics разом з іншими зверненнями (переглядами сторінок, подіями, транзакціями). Тому їх значення необхідно задавати перед викликом коду відстеження.
Наприклад, так може виглядати код, що встановлює значення спеціального параметра:
Ga("create", "UA-XXXX-Y", "auto"); // Вибір значення спеціального параметра з індексом 1. ga("set", "cd1", "Level 1"); // Передача значення спеціального параметра зі зверненням – переглядом сторінки. ga("send", "pageview");
Типи спеціальних показників
Спеціальні показники типу Integer (ціле число) чи Time (час) виражаються з допомогою цілих чисел, а типу Currency (валюта) можуть передаватися як фіксованих десяткових значень у місцевій валюті.
Обробка даних
Область доступу визначає, до яких звернень застосовуватиметься дане значення спеціального параметра, а фільтри профілю – які звернення та відповідні їм значення увійдуть до .
Область доступу та пріоритети
Область доступу визначає, які звернення пов'язані з певним значенням спеціального параметра. Усього таких областей чотири: товар, звернення, сеансі користувач.
- Товар- Значення застосовується тільки до того товару, для якого воно було задано. Ця область доступу використовується лише для розширеної електронної торгівлі.
- Звернення- Значення застосовується тільки до того звернення, для якого воно було задано.
- Сеанс– значення застосовується до всіх звернень у сеансі.
- Користувач– значення застосовується до всіх звернень у поточному сеансі та майбутніх сеансах, доки воно не зміниться або доки параметр не перестане бути активним.
За такої області дії значення спеціального параметра застосовується лише до того товару, котрим воно було задано. В одному обігу може вирушати кілька товарів і, відповідно, кілька спеціальних параметрів із різними областями дії рівня "Товарів".
Область доступу "Звернення"При такій області дії значення спеціального параметра застосовується тільки до звернення, для якого воно було задано (див. Мал. 1, Мал. 2і Мал. 3нижче).
Малюнок 1.Користувач надсилає два звернення: H1 та H2. Поверненню H2 відповідає спеціальний параметр CD1 зі значенням A. Це значення застосовується лише до H2.Малюнок 2.Користувач надсилає третє звернення H3. З H3 не пов'язано жодного спеціального параметра.
Малюнок 3.Користувач надсилає четверте звернення H4. Поверненню H2 відповідає спеціальний параметр CD1 зі значенням B. Це значення застосовується лише до H4.
Область доступу "Сеанс"
Коли в одному сеансі задано два значення з областю дії "Сеанс" та одним порядковим номером, пріоритет надається першому з них. Це значення застосовується для всіх звернень протягом сеансу. на Малюнок 4видно, що останнє значення перевизначає всі попередні для спеціального параметра з тим самим індексом.
Малюнок 1.Користувач надсилає звернення H1 без спеціального параметра.Малюнок 2.В рамках того ж сеансу користувач надсилає звернення H2 зі спеціальним параметром CD1, значення якого дорівнює A. Значення A використовується для H1.
Малюнок 3.Користувач надсилає третє звернення H3. Для H3 значення CD1 не визначено, однак у межах одного сеансу автоматично використовується значення A.
Малюнок 4.Користувач надсилає четверте звернення H4 з новим значенням B для CD1. У всіх попередніх зверненнях у межах того самого сеансу значення A змінюється на B.
Область доступу "Користувач"
Якщо в одному сеансі задано два спеціальні параметри з областю дії "Користувач", то в ході поточного сеансу пріоритет надається останньому значенню, і воно використовується в майбутніх сеансах даного користувача.
на Малюнок 2значення спеціального параметра А застосовується до всіх звернень у сеансі 2 аналогічно до спеціального параметра на рівні сеансу. Однак на Малюнок 3значення А застосовується і до звернень у третьому сеансі, оскільки спеціальний параметр CD1 діє лише на рівні користувача.
Малюнок 1.Під час сеансу користувача відбулося три звернення: H1, H2 та H3. Для жодного з них не встановлено спеціальних параметрів.Малюнок 2.Користувач повертається на сайт та здійснює три звернення за другий сеанс. Для H3 значення CD1 дорівнює A. Воно використовується всім трьох звернень у межах сеансу.
Малюнок 3.У третій сеанс користувача зареєстровано три звернення. Значення A для спеціального параметра CD1, задане на рівні користувача, використовується для всіх звернень у третьому сеансі.
Фільтри
Фільтри подання можуть застосовуватися до спеціальних параметрів та показників декількома способами.
Значення спеціальних параметрів та показників пов'язані з тим зверненням, з яким вони були передані. Область доступу у своїй ролі не грає. Якщо таке звернення відфільтровується з подання, спеціальний параметр або показник може бути відфільтрований.
- Рівень звернення. При видаленні звернення відфільтровуються пов'язані з ним спеціальні параметри лише на рівні звернення та спеціальні показники.
- Рівень сеансу чи користувача. Спеціальні параметри на рівні сеансу або користувача не будуть відфільтровані, навіть якщо буде відфільтровано поводження, з яким вони були передані. Їх значення використовуються для всіх звернень у рамках сеансу, а при дію "Користувач" – і в майбутніх сеансах.
Також можна створювати фільтри для звернень з урахуванням дії спеціальних параметрів. Наприклад, якщо ви задасте в якості фільтра певне значення спеціального параметра на рівні користувача, всі сеанси користувачів, до яких належить це значення, будуть відкидатися.
Звіти
Після обробки спеціальні параметри та показники з'являються у звітах Analytics.
Спеціальні параметри та показники, які представлені у власних звітах, можна використовувати для створення розширених сегментів. Спеціальні параметри також можна додавати як додаткові до стандартних звітів.
Приклади
Розробник нещодавно випустив на ринок нову гру.
Поточний код Analytics зараховує перегляд екрана щоразу, коли користувач виходить на певний рівень гри. Розробнику вже відомо, скільки разів користувачі запускають кожен рівень, і тепер його цікавлять складніші питання:
- Скільки разів користувачі грали на рівні різної складності?
- На скільки рівнях грали користувачі в різні дні ознайомлювального періоду?
- На скільки рівнях грали користувачі ознайомлювальної версії та платної програми?
Відповісти на ці запитання допоможе угруповання звернень, сеансів та користувачів з використанням спеціальних параметрів та показників.
Крім того, у додатку продаються різного роду поліпшення, що дозволяють спростити ігровий процес. Відповідно, крім категорій та варіантів, розробнику потрібно окреме поле для відстеження популярності покращень серед користувачів.
Область доступу "Звернення"
Давайте подивимося, як за допомогою спеціальних параметрів на рівні звернення дізнатися скільки разів користувачі грали на рівнях різної складності.
Розробник вже відстежує перегляди екрана і знає, скільки разів користувачі запускають кожен рівень. Залишилося з'ясувати, який рівень – простий, середній чи складний – найчастіше обирають геймери.
Використовуючи спеціальний параметр на рівні звернення, кожен перегляд екрана можна віднести до певного рівня складності. Це дозволить дізнатися, якому рівню складності відповідає найбільше переглядів.
Чому саме рівень звернення?
За один сеанс користувач може відвідати різні рівні. Якщо вибрано область дії "Звернення", значення складності буде присвоєно лише тому перегляду екрана, з яким воно було передано. В результаті кожен перегляд екрана буде пов'язаний із унікальним рівнем складності.
Налаштування
Насамперед необхідно визначити спеціальний параметр на вкладці Адміністратор в Analytics. Ось як виглядатиме визначення у нашому випадку:
Збір даних
Розробник вже відстежує проходження рівнів гри на екрані. Щоб привласнити кожному з них ступінь складності, необхідно встановити значення спеціального параметра до виклику коду відстеження.
Ось як це виглядатиме:
Ga("create", "UA-XXXX-Y", "auto"); // Вибір значення спеціального параметра з індексом 1. ga("set", "cd1", "easy"); // Передача значення спеціального параметра зі зверненням – переглядом сторінки. ga("send", "pageview", "/level_1/");
У цьому прикладі спеціальний параметр визначається безпосередньо до відстеження перегляду екрана. Таким чином, разом із переглядом екрана буде переданий і рівень складності, за яким потім звернення будуть згруповані у звітах.
Обробка даних
Ось так можуть виглядати дані для одного гравця, який побував на шести рівнях за сеанс:
UserId = 5555 Сеанс 1: H1: screen_name=/level_1/ cd1_value=easy H2: screen_name=/level_2/ cd1_value=medium H3: screen_name=/level_3/ cd1_value=hard H4: screen_name /level_5/ cd1_value=medium H6: screen_name=/level_6/ cd1_value=medium
Область дії "Звернення" гарантує, що значення рівня складності буде пов'язане лише з тим переглядом екрана, з яким він був надісланий.
Звіти
Оскільки кожному перегляду екрана було присвоєно рівень складності, розробник тепер може створити звіт, використовуючи назву екрана та рівень складності як параметри, а перегляди екрана – як показники:
Щоб дізнатися, скільки разів запускався кожен рівень, можна створити власний звіт з основним параметром "Рівень складності", за яким буде згруповано перегляд екрана:
Зі звіту випливає, що користувачі воліли середній рівень складності. Отримати цю важливу інформаціюрозробнику допомогло угруповання переглядів екрану за допомогою параметрів на рівні звернення.
Область доступу "Сеанс"
Тепер давайте подивимося, як дізнатися, на скільки рівнях грали користувачі в кожен з трьох днів ознайомлювального періоду.
Для цього потрібен такий звіт:
Використовуючи спеціальний параметр на рівні сеансу, можна згрупувати перегляди екрана щодня, щоб з'ясувати, в який день користувачі запускали найбільше рівнів.
Чому саме рівень сеансу?
Вибравши область дії "Сеанс", ви зможете згрупувати всі сеанси та звернення, що стосуються одного значення параметра "День ознайомлювального періоду".
Такого ж результату можна досягти, використовуючи область дії "Звернення", однак рівень сеансу вимагатиме мінімальних змін у коді, щоб задати значення параметра "День ознайомлювального періоду".
Налаштування
Спеціальний параметр "День ознайомлювального періоду" визначений у налаштуваннях ресурсу Analytics таким чином:
Збір даних
Розробник вже відстежує перегляди екрану для кожного рівня гри. Щоб зв'язати день ознайомлювального періоду з усіма переглядами екрана протягом сеансу, значення спеціального параметра достатньо лише один раз за сеанс.
Ga("create", "UA-XXXX-Y", "auto"); // Вибір значення спеціального параметра з індексом 2. var day = getDayOfTrial(); ga("set", "dimension2", day); // Передача значення спеціального параметра зі зверненням – переглядом сторінки. ga("send", "pageview", "/level_1/");
Спеціальний параметр на рівні сеансу можна задати у будь-який момент сеансу. Однак у нашому прикладі для розробника простіше зробити це на початку сеансу.
Обробка даних
Значення спеціального параметра, передані в Analytics, будуть застосовані до звернень відповідно до їхньої дії.
Наприклад, ось як виглядатимуть дані для користувача, який двічі грав у гру в перший день, один раз – у другий та ще один – у третій:
UserId = 5555 Сеанс 1: H1: screen_name=/level_1/ cd2_value=1 H2: screen_name=/level_2/ H3: screen_name=/level_2/ Сеанс 2: H4: screen_name=/level_3/ cd2_value= H6: screen_name=/level_4/ Сеанс 3: H1: screen_name=/level_1/ cd2_value=2 H2: screen_name=/level_2/ H3: screen_name=/level_3/ Сеанс 4: H1: screen_name=/level_3/ cd2
Зверніть увагу, що значення спеціального параметра надсилаються лише з одним переглядом екрана за сеанс.
Область доступу "Сеанс" гарантує, що значення "День ознайомлювального періоду" буде пов'язане з усіма зверненнями в цьому сеансі, а не лише з тим, з яким воно було надіслано.
Звіти
Після обробки значення спеціального параметра на рівні сеансу будуть надані всі перегляди екрана, отримані за один сеанс. Тепер розробник може створити звіт на основі параметрів "День ознайомлювального періоду" та "Назва екрану", а також показника "Перегляди екрану":
Згрупувавши перегляди екрану по днях, розробник побачить, на скільки рівнях грали користувачі в кожен з трьох днів ознайомлювального періоду. Для цього потрібно створити власний звіт із основним параметром "День ознайомлювального періоду":
Як видно зі звіту, найбільше рівнів гравці проходили першого дня, а на другий і третій – помітно менше. Отримати цю важливу інформацію допомогло угруповання сеансів та звернень за одним значенням за допомогою спеціального параметра на рівні сеансу.
Область доступу "Користувач"
І нарешті, давайте дізнаємося, скільки рівнів проходили користувачі платної та ознайомлювальної версії.
Для цього потрібен такий звіт:
Використовуючи спеціальний параметр на рівні користувача, можна пов'язати усі перегляди екрану певного користувача(як у поточному сеансі, і у майбутніх) з типом гравця.
Чому рівень користувача?
Область доступу "Користувач" дозволяє легко згрупувати всі сеанси та звернення користувача. Це ідеально працює зі значеннями, які залишаються незмінними для певного користувача, наприклад, "Тип гравця", як у нашому випадку.
Такого ж результату можна досягти, використовуючи рівень звернення та сеансу, проте рівень користувача набагато зручніший, оскільки потребує мінімальних змін у коді.
Налаштування
Спеціальний параметр "Тип гравця" визначений у розділі "Адміністратор" таким чином:
Збір даних
Як і в попередніх прикладах, розробник знає кількість переглядів екрану для кожного рівня гри. Щоб згрупувати ці перегляди екрану на кшталт гравця, достатньо визначити цей спеціальний параметр при запуску гри і потім ще раз – при переході на неї платну версію.
Розробнику потрібно буде визначити спеціальний параметр, коли користувач запускає гру:
Ga("create", "UA-XXXX-Y", "auto"); // Вибір значення спеціального параметра з індексом 3. ga("set", "dimension3", "Free"); // Передача значення спеціального параметра зі зверненням – переглядом сторінки. ga("send", "pageview", "/level_1/");
Цей же спеціальний параметр потрібно встановити при переході на платну версію:
Ga("create", "UA-XXXX-Y", "auto"); // Вибір значення спеціального параметра з індексом 3. ga("set", "dimension3", "Paid"); // Передача значення спеціального параметра зі зверненням – переглядом сторінки. ga("send", "pageview", "/level_1/");
Обробка даних
Значення спеціального параметра, передані в Analytics, будуть застосовані до звернень відповідно до їхньої дії.
Наприклад, ось як виглядатимуть дані для користувача, який двічі грав у гру безкоштовно та один раз – платно:
UserId = 5555 Сеанс 1: H2: screen_name=/level_1/ cd3_value=free H3: screen_name=/level_2/ Сеанс 2: H1: screen_name=/level_2/ H2: screen_name=/level_3/ H3: screen_name H1: screen_name=/level_3/ cd3_value=paid H2: screen_name=/level_4/
Зверніть увагу, що значення free (безкоштовно), задане в першому сеансі, застосовується до всіх звернень з першого та другого сеансів, оскільки значення paid (платно) задається лише у третьому сеансі.
Звіти
Значення спеціального параметра "Тип гравця" будуть пов'язані з сеансами, в яких вони були встановлені, а також з усіма майбутніми сеансами та зверненнями.
Тепер розробник може створити звіт на основі параметрів "Тип гравця" та "Назва екрану", а також показника "Перегляди екрана":
І нарешті, згрупуємо перегляди екрану на кшталт гравця, щоб порівняти кількість рівнів при грі у безкоштовну та платну версію. Для цього потрібно створити власний звіт із основним параметром "Тип гравця":
Як бачимо, за кількістю рівнів переваг у безкоштовної версіїігри. Отримати цю важливу інформацію допомогло угруповання користувачів та їх сеансів та звернень за одним значенням за допомогою спеціального параметра на рівні користувача.
Область доступу "Товар"
Розглянемо, як за допомогою спеціальних параметрів на рівні товару дізнатися, які покращення (мінімальні, середні чи сильні) гравці набувають частіше за інших.
Отже, розробник вже відстежує кількість покупок покращень із використанням розширеної електронної торгівлі. Залишилося з'ясувати, покращення якого рівня мають найбільший попит у користувачів.
Звіт виглядатиме приблизно так:
Раніше можна було дізнатися загальний прибуток від продажу поліпшень у грі, але без розбивки за рівнями.
Спеціальний параметр на рівні товару дозволяє присвоїти рівень покращення кожному товару. У звітах буде зазначено, покращення якого рівня найчастіше купують користувачі. Також можна отримати аналогічну статистику щодо кількості переглядів, кліків та інших дій розширеної електронної торгівлі.
Чому саме рівень товару?
Користувач може придбати одночасно кілька покращень. Якщо вибрано область дії "Товар", значення рівня буде присвоєно тільки тому товару, з яким його було передано. В результаті кожне поліпшення буде пов'язане з унікальним рівнем.
Налаштування
Спеціальний параметр "Рівень покращення" визначений у налаштуваннях ресурсу Analytics таким чином:
Збір даних
Розробник вже відстежує покупки покращень у грі. Щоб надати кожному з них певний рівень, необхідно задати значення спеціального параметра разом з даними про товар.
Ось як можна додати параметр до товару:
Ga("ec:addProduct", ( // Додавання даних про товар в об'єкт productFieldObject. "id": "P12345", // Ідентифікатор товару (рядок). "name": "Powerup", // Назва товару (рядок) "category": "Extras", // Категорія товару (рядок). "variant": "red", // Варіант товару (рядок). "price": "10.00", // Ціна товару (валюта). quantity": 2, // Кількість товарів (число). "dimension4": "strong" // Спеціальний параметр на рівні товару (рядок).)); ga("ec:setAction", "purchase", ( "id": "T12345", "revenue": "20.00")); ga("send", "pageview"); // Відправлення даних з транзакції з вихідним переглядом сторінки.
У цьому прикладі спеціальний параметр визначається разом з інформацією про товар та задає рівень відповідного покращення.
Обробка даних
Як і в попередніх прикладах, значення спеціального параметра, передані в Analytics, будуть застосовані до звернень відповідно до їх сфери дії.
Ось так можуть виглядати дані для одного гравця, який придбав три покращення за сеанс:
UserId = 5555 Сеанс 1: H1: product_name=powerup cd4_value=weak product_name=powerup cd4_value=strong H2: product_name=powerup cd4_value=weak
Використання області дії "Товар" гарантує, що значення параметра для кожного покращення буде пов'язане лише з тим товаром, з яким його було надіслано.
Звіти
Після цього можна створити власний звіт про доходи щодо кожного рівня поліпшень:
У разі поліпшення мінімального рівня принесли найбільший дохід.
Спеціальні показники
Область дії
Спеціальні показники також мають свою сферу дії, яка дозволяє зіставляти їх з параметрами того ж рівня. Так, показники рівня товару пов'язуються лише з товаром, з яким їх було відправлено. Далі показано два приклади спеціальних показників.
Спеціальний показник на рівні звернення
У наведених вище прикладах розробник відстежував перегляди екрана кожного рівня гри, тому у всіх звітах використовується показник "Перегляди екрана". Він свідчить про спробу користувача пройти рівень.
Проте розробника також цікавить коефіцієнт проходження кожного рівня.
Для цього розробник додає спеціальний показник "Пройдені рівні", а потім порівнює їх число з кількістю переглядів екрана для кожного рівня.
| Назва екрану | Перегляди екрану | Пройдені рівні |
|---|---|---|
| /level_1/ | ||
| /level_2/ | ||
| /level_3/ |
Для чого потрібні спеціальні показники?
Спеціальні показники, на відміну від стандартних (подій, переглядів екрану тощо), дозволяють вам створювати більш гнучкі та наочні звіти з даними, які цікавлять вас найбільше.
У нашому прикладі пройдені рівні не можна відстежувати як перегляди екрану, оскільки вони враховуватимуться двічі кожного рівня.
Хоча події можна використовувати окремо, через їхню ієрархічну природу буде складно створити показаний вище звіт, об'єднавши перегляди екрану та пройдені рівні з одним параметром.
Враховуючи ці факти та важливість такої інформації для розробника, пройдені рівні найзручніше відстежувати як спеціальний показник.
Налаштування
Спеціальний показник "Пройдені рівні" можна встановити в налаштуваннях Analytics:
Збір даних
Розробник вже відстежує запуск кожного рівня за допомогою перегляду екрана. Тепер його цікавить скільки рівнів користувачі проходять. І тому він створює спеціальний показник.
Спеціальні показники, як і спеціальні параметри, передаються в Analytics разом із зверненнями. Тому розробнику потрібно буде надсилати додаткове звернення, яке реєструватиме проходження рівня гри. У цьому прикладі після закінчення рівня запускатиметься подія, з якою зв'язуватиметься спеціальний показник.
Ось як це виглядатиме:
Ga("create", "UA-XXXX-Y", "auto"); // Збільшення показника завершеного рівня на 1. ga("set", "metric1", 1); // Передача значення спеціального параметра із зверненням – подією. ga("send", "event", "Level", "completion");
Обробка даних
До обробки дані про одного користувача, який запустив три рівні гри за один сеанс, виглядатимуть так:
UserId = 5555 Сеанс 1 H1: type=screen_view screen_name=/level_1/ H2: type=event screen_name=/level_1/ cm1_value=1 H3: type=screen_view screen_name=/level_2/ H4: type=screen type=screen_view screen_name=/level_2/ H6: type=event screen_name=/level_2/ cm1_value=1 H7: type=screen_view screen_name=/level_3/ H8: type=event screen_name=/level_3/ cm1_value=
Звіти
Тепер можна створити звіт із параметром "Назва екрана" та показниками "Перегляди екрана", "Усього подій" та "Пройдені рівні":
Ці дані свідчать про те, що другий рівень насправді важчий за перший і третій: коефіцієнт його проходження становить лише 33%. Відстежуючи проходження рівнів за допомогою спеціального показника, розробник може легко отримати дані, що його цікавлять, у вигляді простих, наочних звітів.
Спеціальний показник на рівні товару
У наведених вище прикладах розробник відстежує покупки покращень і може пов'язати з кожною з них різні показники, такі як кількість чи отриманий дохід.
Для цього використовується спеціальний показник "Витрачені бонуси".
Ось який звіт для цього потрібний:
Налаштування
Спеціальний параметр "Витрачені бонуси" визначено в розділі "Адміністратор":
Збір даних
Спеціальні показники, як і спеціальні параметри, передаються в Analytics разом із даними про товари.
Ось як це виглядатиме:
Ga("ec:addProduct", ( // Додавання даних про товар в об'єкт productFieldObject. "id": "P12345", // Ідентифікатор товару (рядок). "name": "Powerup", // Назва товару (рядок) "category": "Extras", // Категорія товару (рядок). "variant": "red", // Варіант товару (рядок). "price": "10.00", // Ціна товару (валюта). quantity": 2, // Кількість товарів (число). "dimension4": "strong", // Спеціальний параметр на рівні товару (рядок). "metric2": 5 // Спеціальний показник на рівні товару (ціле число). ); ga("ec:setAction", "purchase", ( "id": "T12345", "revenue": "20.00")); ga("send", "pageview"); // Відправлення даних з транзакції з вихідним переглядом сторінки.
Обробка даних
До обробки дані про одного гравця, які придбали кілька поліпшень, виглядатимуть так:
UserId = 5555 Сеанс 1 H1: type=screen_view screen_name=/level_1/ H2: type=screen_view screen_name=/level_2/ product_name=powerup cd4_value=weak cm4_value=5 product_name=powerup cd4 /level_2/ product_name=powerup cd4_value=medium cm4_value=1 product_name=powerup cd4_value=weak cm4_value=10
Звіти
Тепер можна створити звіт із параметром "Рівень покращення", а також показниками "Дохід від товару" та "Витрачені бонуси":
Очевидно, гравці вважають за краще витрачати бонуси на мінімальні покращення, а найбільший прибуток розробнику приносять покращення середнього рівня.
Примітки
Ось кілька моментів, які слід враховувати під час роботи зі спеціальними параметрами та показниками.
Редагування існуючого параметра та показника
Якщо ви зміните назву існуючого спеціального параметра або показника, це вплине на ваші дані таким чином:
- Редагування назвивпливає на вже опрацьовані дані: ви зможете отримати їх лише під новою назвою.
- Зміна сфери діїне впливає на оброблені дані: нова сфера дії буде застосовуватися лише до нових даних.
- Зміна статусу. Поле статусу визначає, чи оброблятимуться значення спеціального параметра чи показника. При неактивному статусі вони з'являтимуться у звітах, але даних для них не буде.
Правильний вибір області дії
Вибираючи область дії для спеціального параметра, подумайте, як часто змінюватиметься це значення. Якщо це відбуватиметься кілька разів за сеанс, як у випадку з рівнем гри, вибирайте рівень звернення та задавайте значення перед кожним зверненням. Якщо значення не змінюється протягом сеансу, як у випадку з віком, то спеціальний параметр достатньо встановити лише один раз на рівні користувача. Завжди вибирайте правильну область дії, щоб уникнути помилок.
Ця інформація виявилася корисною?
Як можна покращити цю статтю?
4 Настройки користувача
Огляд
Іноді ви можете захотіти виконувати перевірку через агент, який не визначений в Zabbix. У цьому випадку вам на допомогу прийдуть параметри користувача.
Ви можете написати команду, яка поверне необхідні вам дані і додати цю команду як параметр користувача у файл конфігурації агента (параметр конфігурації "UserParameter").
Параметр користувача має наступний синтаксис:
UserParameter=<ключ>,<команда>
Як ви можете бачити, параметр користувача також містить ключ. Ключ знадобиться при налаштуванні елемента даних. Введіть ключ на ваш вибір, на який буде легко посилатися (він має бути унікальним у межах вузла мережі). Перезапустіть агента.
У операційні системи UNIX використовується інтерпретатор командного рядка /bin/sh. Параметри користувача підпорядковуються часу очікування перевірок на агента; якщо час очікування буде перевищено, створений за параметрами користувача процес буде завершено.
Дивіться також:
Приклади простих параметрів користувача
Проста команда:
UserParameter=ping,echo 1
Агент завжди повертатиме "1" для елемента даних з ключем "ping".
Більш складний приклад:
UserParameter=mysql.ping,mysqladmin -uroot ping|grep -c alive
Агент повертатиме "1", якщо MySQL сервер доступний, "0" - в іншому випадку.
Гнучкі параметри користувача
Гнучкі параметри користувача допускають параметри із зазначеним ключем. У цьому випадку гнучкі параметри користувача можуть бути основою для створення декількох елементів даних.
Гнучкі параметри користувача мають наступний синтаксис:
UserParameter=ключ[*],команда
| Параметр | Опис |
|---|---|
| Ключ | Унікальний ключ елемент даних. [*] задає, що ключ може приймати параметри зі дужок. Параметри вказуються під час налаштування елемента даних. |
| Команда | Команда, яка виконується для отримання ключа. Тільки для гнучких параметрів користувача: Ви можете використовувати посилання на позиції $1…$9, щоб звернутися до відповідного параметра в ключі елемента даних. Zabbix розбирає параметри укладені ключа елемента даних і замінює $1,…,$9 в команді відповідно. $0 буде замінено на оригінальну команду (до розкриття $0,…,$9) для виконання. Посилання на позиції інтерпретуються Zabbix агентом незалежно від того, чи вони укладені в подвійні (“) або в одинарні (") лапки. Для використання посилань на позиції без зміни вкажіть подвійний символ долара - наприклад, awk "(print $$2)". У цьому випадку $$2 фактично перетвориться на $2 під час виконання команди. |
Посилання на позиції, що починаються зі знака $, шукаються і замінюються Zabbix агентом тільки у разі гнучких параметрів користувача. У разі простих параметрів користувача такі посилання пропускаються і, отже, екранування будь-яких знаків $ не потрібно.
За замовчуванням деякі символи не дозволені в настройках користувача. Дивіться документацію UnsafeUserParameters для отримання повного спискутаких символів.
Приклад 1
Дуже простий приклад:
UserParameter=ping[*],echo $1
Ми можемо створити необмежену кількість елементів даних для спостереження за будь-чим, вказавши в такому форматі ping[що завгодно].
ping - завжди повертатиме '0'
ping - завжди повертатиме 'aaa'
Приклад 2
Давайте додамо більше сенсу!
UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive
Цей параметр можна використовувати для моніторингу доступності баз даних MySQL. Як параметри ми можемо передати ім'я користувача та пароль:
Mysql.ping
Приклад 3
Результат команди
Результуючим значенням команди є стандартний висновок разом із стандартним виводом помилок.
Текстовий елемент даних (символ, журнал або текст типами інформації) не стане непідтримуваним у разі виведення помилки стандартним висновком.
Настройки користувача, які повертають текст (символ, журнал, текстовий типи інформації) можуть повертати пробіл. У разі помилкового результату елемент даних стане непідтримуваним.
) чудово підходять більшості користувачів. При цьому в рішенні ESA можна використовувати також параметри користувача доставки.
Відкрийте консоль керування ESA (ESA Management Console) на головному комп'ютері, перейдіть до вузла домену (у нашому прикладі це acswin2012.com), клацніть Advanced Settings ( Додаткові налаштування), а потім натисніть кнопку Delivery Options (Параметри доставки).
Тут можна вказати шлях до сценарію користувача (або знайти його, натиснувши кнопку ), за допомогою якого ви хочете виконати підготовку або доставку пароля OTP. Натисніть , щоб відобразити список параметрів, які можна надіслати в сценарій користувача. Наприклад, для доставки одноразового пароля (OTP) необхідно використовувати параметр . Крім того, в сценарій можна передати рядок користувача, який для цього потрібно вказати (див. parameter1 на знімку екрана вище).
Зразок сценарію - доставка пароля OTP по електронній пошті
Обов'язкові умови:
потрібно знати параметри SMTP шлюзу електронної пошти, за допомогою якого потрібно відправити електронного листа, Що містить пароль OTP;
потрібен користувальницький сценарій надсилання електронних листів;
потрібен користувальницький сценарій у форматі BAT (.bat), до якого задається шлях у консолі управління ESA (ESA Management Console) (див. знімок екрана вище) і який викликає наш сценарій користувача, що відправляє електронний лист;
для кожного користувача, для якого включена двофакторна автентифікація (2FA) і який отримує одноразові паролі (OTP passwords) електронною поштою, потрібно вказати адресу електронної пошти в полі E-mail (Електронна пошта) на вкладці General (Загальні) під час перегляду відомостей про такі користувачам в інтерфейсі керування Active Directory Users and Computers (Користувачі та комп'ютери Active Directory).
Зразок сценарію Python для надсилання електронної пошти: ми назвали цей файл sendmail.py:
import sys, smtplib
server = smtplib.SMTP(" smtpserver : port" )
server.starttls()
server.login("username", "password")
server.sendmail(sys.argv, sys.argv, "Subject: OTP is "+sys.argv)
server.quit()
ПРИМІТКА. У наведеному вище зразку сценарію Python параметри smtpserver:port , username та password слід замінити відповідними параметрами SMTP.
Зразок сценарію.bat для виклику сценарію sendmail.py та передачі йому необхідних параметрів: ми назвали цей файл CustomMail.bat:
c:\Python\python.exe c:\work\sendmail.py %1 %2
ПРИМІТКА. Для роботи з цим зразком сценарію потрібно встановити бібліотеку Python на основному комп'ютері (на якому встановлено рішення ESA Core component ) та знати шлях до файлу python.exe.
У полі Sending OTP by (Шлях відправки OTP) ми вказуємо шлях, що веде до нашого сценарію CustomMail.bat, вибираємо необхідні параметри, наприклад (Адреса електронної пошти) і , а потім клацаємо Save (Зберегти).
Підготовку (доставку мобільного додатка) можна налаштувати так само за допомогою необхідних параметрів (Телефон) та (URL-адреса).
ПРИМІТКА. : В порівнянні з доставкою SMS (або використанням підготовленої мобільної програми) виконувати розподіл паролів OTP за допомогою електронної пошти не так безпечно, тому що електронний лист можна прочитати на будь-якому пристрої користувача. За допомогою цього способу не можна підтвердити, що цільовий одержувач має зареєстрований телефон (номер телефону).
Параметри користувача та показники дозволяють надсилати в Google Analytics необхідні дані саме під ваші завдання. Наприклад, можна завантажувати в Google Analytics такі важливі показники як або . Можна порівнювати між собою різні сегменти, наприклад користувачів, що авторизувалися на сайті і не вхід, авторів сторінок, отримувати значення при заповненні полів різних форм тощо залежно від специфіки вашого сайту.
Як додати спеціальний параметр чи показник?
- Відкрийте розділ «Адміністратор»та виберете потрібний ресурс.
- У стовпці «Ресурс»натисніть «Призначення користувача»> (або показники).
- Натисніть кнопку "+ Спеціальний параметр"(Або показник).
- Вкажіть його назву.
- При додаванні параметра користувача або показника виберіть «Область дії»з наступних варіантів: "Hit", «Сеанс», «Користувач», «Товар»(Докладніше про область дії).
- Також, при додаванні показника користувача, оберіть "Тип форматування"з наступних варіантів: "Ціле число", «Валюта»або «Час».
- Встановіть прапорець «Активна», щоб почати збір даних і додати параметр або показник до звітів. Якщо ви не бажаєте активувати створений параметр, зніміть цей прапорець.
- Натисніть кнопку «Створити».
Способи відправлення до GA
Надсилання даних через код відстеження
// Відправлення параметра користувача при перегляді сторінки ga("send", "pageview", ("dimension1": "Мій параметр")); // Відправлення показника користувача разом з подією ga("send", "event", "category", "action", ( "metric1": 123 ));
Надсилання даних через GTM
Якщо Google Analytics впроваджено на сайт через GTM (що рекомендується), то під час активації тега, можна передавати параметри користувача або показники. Для цього зайдіть у "Додаткові налаштування", вкажіть індекс та значення.
Надсилання даних через Measurement Protocol
Гайд по використанню Measurement Protocol описаний у статті « » в якій в параметр параметр cd14 передається Client ID користувача.
Обмеження
У кожному ресурсі можна додати 20 параметрів користувача і ще 20 показників.
Видаляти спеціальні параметри чи показники не можна, проте їх можна вимкнути.
Кейс з обходу обмежень у 20 параметрів та показників
Бувають завдання, коли потрібно відстежити заповнення калькулятора або будь-якої анкети на сайті з великою кількістю полів. Заводити під кожне поле окремий параметр не варіант, оскільки можна впертись у ліміт.
Виходом із цієї ситуації буде створення двох параметрів: перший для назви полів форми, а другий для значень, що вводяться в поля.
Відповідно значення полів форми ми передаємо в "Поле калькулятора - значення", а сама назва поля в "Поле калькулятора - ім'я". І коли, припустимо, нам необхідно буде вивести всі значення поля "Місто", просто встановлюємо фільтр для спеціального показника "Поле калькулятора - ім'я" рівним назві поля.
Завантаження...