Инструкция по установке счетчика Яндекс Метрики на сайт для пользователей Нубекса
Яндекс.Метрика — это бесплатный сервис веб-аналитики, который помогает получать наглядные отчеты о действиях посетителей сайта. С ее помощью можно оценить динамику посещаемости, источники трафика, узнать информацию о целевых визитах, конверсиях и многое другое.
Чтобы начать использовать эти возможности, нужно установить счетчик Яндекс Метрики на свой сайт.
Как получить код счетчика Яндекс Метрики
Чтобы создать счетчик, выполните следующие действия:
1. Перейдите на сервис Яндекс.Метрики и авторизуйтесь (если у Вас нет учетной записи на Яндексе, зарегистрируйтесь).
2. Нажмите кнопку «Добавить счетчик».
3. Укажите необходимую информацию. Обязательным к заполнению является только поле «Адрес сайта»: укажите в нем основной домен своего сайта без префикса схемы/протокола (http://, https://).
Активируйте галочку «Я принимаю условия пользовательского соглашения» и нажмите кнопку «Создать счетчик».
4. Вы попадете в раздел настроек, где сможете изменить некоторые свойства кода перед его установкой на страницы сайта. Подробнее о настройках счетчика можно узнать в службе поддержки Яндекса.
5. После выполнения необходимых настроек прокрутите страницу до поля с кодом счетчика и нажмите кнопку «Скопировать».
Отлично: счетчик создан, код получен, осталось только вставить его на Ваш сайт.
Как вставить код счетчика на сайт
Зайдите в админку сайта в «Нубексе», на панели управления (слева) выберите раздел «Настройки» и перейдите к пункту «Счетчики».
Вставьте полученный код счетчика в поле и сохраните изменения.
Если одновременно Вы используете несколько сервисов для сбора статистики (например, Яндекс.
Метрику и Google Analytics), просто вставляйте их коды в поле счетчиков по очереди, разделив Enter`ом для удобства.
Метрику и Google Analytics), просто вставляйте их коды в поле счетчиков по очереди, разделив Enter`ом для удобства.Вот и все: счетчик Яндекс Метрики установлен и готов к работе. Можете обновить страницу Вашего сайта и убедиться, что никаких визуальных изменений на нем не произошло: работа счетчика останется незамеченной для Ваших пользователей. Исключение составляет только тот случай, если в настройках счетчика Вы поставили галочку у режима «Информер»: тогда в подвале (нижней части страницы) появится иконка от Яндекс.Метрики с данными за сегодня (просмотрами, визитами и количеством уникальных посетителей).
Чтобы проверить статус счетчика, Вы можете снова обратиться к Яндекс.Метрике. Некоторое время после создания иконка рядом со счетчиком будет отображаться в желтом цвете: идет проверка.
Затем ее цвет должен измениться на зеленый: счетчик найден, установка прошла успешно.
Если же цвет иконки изменился на красный, что-то пошло не так: счетчик не найден, сайт недоступен или заражен.
Проверьте, что Вы правильно установили код на сайте, а в настройках счетчика указали верный адрес.
Как установить счетчик Яндекс Метрики на сайт: подробная видеоинструкция
Также для получения сведений о посещаемости сайта Вы можете использовать сервис Google Universal.
- Как создать сайт самостоятельно
- Работа со страницами
- Наполнение страниц
- Работа с изображениями и файлами
- Фотогалереи
- Новости
- Каталог товаров
- Интернет-магазин
- Формы обратной связи
- Виджеты
- Доступ в систему управления
- Внешние сервисы
- Дизайн
Как установить счетчик Яндекс.
Метрики на сайтИспользуя стандартные возможности системы управления UralCMS Вы можете добавить код счетчика Яндекс.Метрика на свой сайт для сбора статистики посещаемости.
Видео: как подключить Яндекс.Метрику на сайт
Создать счетчик Яндекс.Метрики
1. Перейдите на страницу https://metrika.yandex.ru/. Авторизуйтесь, используя свой логин и пароль для создания счетчика Яндекс.Метрики и его дальнейшей настройки для вашего сайта.
2. На главной странице Яндекс.Метрики, вам необходимо создать счётчик. Нажмите — Добавить счетчик.
3. Далее, вам потребуется указать: имя счетчика, адрес сайта, выбрать часовой пояс и ознакомиться с условиями пользовательского соглашения. После внесения данных, нажмите «Создать счетчик«.
4. На следующей странице настроек счетчика Яндекс.Метрики Вам будет предложено выбрать способ установки. Выберите HTML (выбран по умолчанию).
5. По умолчанию, счетчик Яндекс.Метрики добавляется на сайт без «информера». «Информер» — небольшая иконка счетка с общими данными о посещаемости сайта видимая всем посетитлям сайта в футере.
Внимание! Если Вы хотите добавить «информер» в код счетчика, на этой же странице раскройте дополнительные настройки и установите галочку напротив соответсвующего параметра. После чего Вам станут доступны визуальные настройки «информера».
6. После завершения настройки, вы можеет добавить счетчик Яндекс.Метрики непосредственно на сайт — для этого нажмите на кнопку «Скопировать код» или скопируйте код счетчика из текстового поля.
7. Для того, чтобы установить код Яндекс.Метрики на сайте, в основном меню системы управления перейдите в раздел «Настройки и оформление» -«Настройки поисковых систем» — «Общие настройки и счетчики«.
8. На открывшейся странице необходимо вставить код Яндекс.Метрики в поле «Скрипты в футере сайта».
Внимание! Если Вы сформировали код счетчика Метрики без «информера», можете разместить его в поле «Скрипты в шапке сайта» для более быстрой загрузки. Счетчик с «информером» размещается только в поле «Скрипты в футере сайта».
После размещения кода нажмите на кнопку «Сохранить».
9. Вернитесь на вкладку браузера с Яндекс.Метрикой и нажмите на кнопку «Начать пользоваться» в левом нижнем углу страницы.
10. В списке счетчиков Яндекс.Метрики появится Ваш счетчик. Необходимо осуществить проверку его работы, для этого нажмите по иконке «…» справа и выберите пункт «Проверить счетчик».
11. Открывшейся странице нажмите на кнопку «Проверить».
12. Во всплывающем окне нажмите «Перейти к результатам проверки».
После нажатия на кнопку, Ваш сайт откроется в новой вкладке браузера, а в шапке отобразится всплывающее окно с результатом проверки.
Сообщение о том, что счетчик Яндекс.Метрики найден на странице, говорит о том, что вся процедура выполненна верно, и счетчик функционирует.
ПРОСМОТР ДЕТАЛЬНОЙ СТАТИСТИКИ ВАШЕГО САЙТА
Сервис Яндекс.Метрика позволяет подробно изучить статистику посещаемости вашего ресурса.
Если у Вас возникли вопросы по работе с Яндекс.Метрикой или необходима консультационная поддержка — обратитесь в службу технической поддержки .
Как работает Яндекс.Метрика — Яндекс.Метрика. Справка
Чтобы начать работу с Яндекс.Метрикой, создайте тег — фрагмент кода, встроенный в контент веб-страницы. При создании тега Яндекс.Метрика одновременно создает связанное с ним хранилище данных.
Пользователи взаимодействуют с веб-страницами сайта, на котором установлен тег. Код тега выполняется и передает в Яндекс.
Метрику данные о самой странице и событиях, произошедших при взаимодействии с ней пользователя.
- Сбор и передача данных
- Квоты
- Обработка и хранение данных
- Получение и отображение данных. Метрика
Для обеспечения максимальной доступности сервиса Яндекс.Метрика накладывает ограничения на количество запросов данных от пользователей (квоты). Квоты используются в API Яндекс.Метрики. Веб-интерфейс, в свою очередь, может использовать методы API, то есть исчерпать ту же квоту. При превышении квоты в Яндекс.Метрике появляется предупреждение об этом:
На странице Dashboard при отображении виджетов. Например, если виджеты одновременно открыты на нескольких вкладках браузера или с ними работают несколько пользователей тегов.
При отображении отчетов. Например, если несколько тегов одновременно просматривают отчеты или работают с одним и тем же отчетом.
Аналогичная ситуация может возникнуть, если вы одновременно отправляете запросы к API Яндекс.
Метрики и работаете с веб-интерфейсом.
Квота также может быть превышена из-за надстроек браузера или активности вредоносных программ. В этом случае рекомендуем отключить надстройки браузера и проверить ОС на наличие вирусов.
Если вы подозреваете, что кто-то еще делал запросы, используя ваше имя пользователя:
Перейдите в настройки своей учетной записи.
В разделе Вход и журнал устройств щелкните Выйти на всех устройствах.
Снова зайдите в настройки своей учетной записи и измените пароль. Затем снова нажмите «Выйти» на всех устройствах.
Собранные данные обрабатываются службой. На основе этих данных формируются статистические объекты в хранилище тега.
Yandex.Metrica works with several data levels and operates with the following types of statistical objects:
| Object | Level |
|---|---|
pageview page load file download ИСТОЧНАЯ ЛИКАКА КЛИЧНАЯ | Основная |
| Сессия | Второй |
| Пользователь | Третий |
Статистический объект определяется на подбор .
Некоторые атрибуты являются общими для всех типов статистических объектов. Например, для любого типа объекта может быть определена операционная система и страна пользователя, если эта информация была обнаружена.
Некоторые атрибуты специфичны для определенных типов статистических объектов. Например, определяющим атрибутом просмотра страницы является URL-адрес страницы клика (реферер), атрибутом сеанса является продолжительность сеанса, а атрибутом пользователя является дата первого сеанса пользователя.
Эти уровни можно представить в виде диаграммы:
Вы можете передавать дополнительные параметры в Яндекс.Метрику во время взаимодействия пользователей с сайтом. Однако важно различать параметры сеанса или просмотра страницы и параметры пользователя. Пользовательские параметры отличаются от параметров сеанса или просмотра страницы тем, что они не привязаны к определенному времени сеанса сайта.
Например, событие «отправить отзыв» относится к определенному сеансу, поскольку пользователь мог отправить отзыв только один раз за всю историю сеансов.
Нет никакого смысла делать это событие атрибутом пользователя, потому что отчеты будут выглядеть так, как будто этот пользователь отправил один и тот же отзыв один раз в течение каждого сеанса.
Чтобы сравнить поведение пользователей, оставивших отзыв хотя бы один раз, с теми, кто ни разу не оставлял отзыв, необходимо настроить отправку этого события через параметры сеанса, а затем создать соответствующие сегменты. Пользовательские параметры должны передавать только те атрибуты, которые не меняются от сеанса к сеансу и не содержат личной информации пользователя. Например, можно передать тип клиента — «розничный» или «оптовый».
Каждый объект определяется временем начала соответствующего события (или последовательности событий).
Таким образом, мы можем выбрать статистические объекты определенного типа в течение определенного периода времени. Затем мы можем использовать значения атрибутов для вычисления различных абсолютных или средних чисел. Эти числа называются метриками .
Примерами являются общее количество просмотров страниц или количество сеансов с глубиной больше 5.
Показатели всегда рассчитываются для одного и того же типа статистических объектов.
Типичная задача при анализе метрик — определить, какой вклад в общую сумму вносит одна из групп. Например, вы можете узнать, сколько пользователей сайта составляют мужчины и сколько женщин. В Яндекс.Метрике можно определять группы объектов с помощью условий, накладываемых на значения атрибутов, и вычислять значения метрик для каждой группы. Этот процесс разбиения целого на части называется 9.0049 размеры .
Часто нужны не все объекты, а только те, которые соответствуют заданным критериям. Например, вы хотите проанализировать поведение пользователей, которые переходят по объявлениям. В Яндекс.Метрике можно сформировать выборку искомых объектов с помощью условий, накладываемых на значения атрибутов. Этот процесс называется сегментацией , а выбранный набор объектов представляет собой сегмент .
Сегментацию и размеры можно использовать вместе. Например, вы можете выбрать сегмент сеансов, пришедших из поисковых систем, и сгруппировать сеансы по ключевым словам.
Для просмотра и анализа метрик используются отчеты и виджеты. Для изучения поведения пользователей доступны Session Replay , карты и сервис анализа форм.
Яндекс | Customer.io Docs
PremiumЭта функция доступна в наших планах Premium и Enterprise.Отправлять данные Customer.io о сообщениях, людях, метриках и т. д. в Яндекс. Отсюда вы можете загрузить свои данные в хранилище данных по вашему выбору. Эта интеграция синхронизируется каждые 15 минут, помогая вам быть в курсе активности сообщений вашей аудитории.
Как это работает
Экс -интеграция экспортирует отдельные файлы паркетов для поставки , метрики , субъектов , Выходы , Содержание , , , , .
Каждый файл паркета содержит данные, которые изменились с момента последнего экспорта.
После того, как файлы паркета окажутся в вашем сегменте хранилища, вы сможете импортировать их на платформы данных, такие как Fivetran, или в хранилища данных, такие как Redshift, BigQuery и Snowflake.
Обратите внимание, что эта интеграция только публикует файлы паркета в вашем сегменте хранилища. Вы должны настроить хранилище данных для приема этих данных. Существует множество подходов к приему данных, но обычно для загрузки файлов паркета из корзины требуется команда COPY. После того, как вы загрузите файлы паркета, вы должны установить срок их действия, чтобы они автоматически удалялись.
Мы пытаемся экспортировать файлы паркета каждые 15 минут, хотя фактические интервалы синхронизации и время обработки могут отличаться. При синхронизации больших наборов данных или при большом объеме одновременных операций синхронизации на Customer.io обработка и экспорт данных может занять до нескольких часов.
Диаграмма последовательности
участник a как Customer.io
участник b как Storage Bucket
участник c от имени Яндекс
зацикливаться каждые 15 минут
a->>b: экспортировать файлы паркета
b->>c: проглотить
c->>b: срок действия/удаление файлов
перед следующей синхронизацией
end
Первоначальный экспорт и добавочный экспорт
Ваша первоначальная синхронизация представляет собой набор файлов, содержащих исторические данные для представления текущего состояния вашей рабочей области. Последующие файлы синхронизации содержат наборы изменений.
- Показатели : Первоначальная синхронизация метрик разбита на файлы с двумя порядковыми номерами, как показано ниже.
<имя>_v3_<идентификатор_рабочей_области>_<последовательность1>_<последовательность2>. - Атрибуты : Первоначальный экспорт атрибутов включает список профилей и их текущие атрибуты. Последующие файлы будут содержать только изменения атрибутов , по одному изменению на строку.
Последующие файлы будут содержать только изменения атрибутов , по одному изменению на строку.блок-схема LR a{это первоначальная синхронизация?} —>
уже включен?} c—>|yes|d[отправить изменения с момента последней синхронизации] c—>|no|e{был ли когда-либо включен файл
?} e—>|yes|f[отправить набор изменений, так как файл
был отключен] e—>|no|g[отправить всю историю]
Настройка интеграции вывода данных Amazon S3
Прежде чем начать, убедитесь, что вы готовы принимать соответствующие файлы паркета из Customer.io. Для S3 вам нужно настроить корзину с ListBucketVersions , ListBucket , GetObject и PutObject , прежде чем вы сможете синхронизировать данные с Customer.io.
- Создайте ключ доступа и служебный ключ с правами на чтение/запись для вашей корзины S3 или Яндекса.
- Перейдите к Integrations и выберите Яндекс, а затем нажмите Sync Bucket .
- Введите информацию о своем сегменте и нажмите Выберите данные .
- Введите Имя своего сегмента.
- Введите путь к вашей корзине.
- Вставьте ключи Access и Secret в соответствующие поля.
- Выберите регион , в котором находится ваша корзина.
- Выберите типы данных, которые вы хотите экспортировать из Customer.io в вашу корзину. По умолчанию мы экспортируем все типы данных, но вы можете отключить ненужные вам типы.
- Нажмите Создать и синхронизировать данные .
Приостановка и возобновление синхронизации
Вы можете отключить файлы, которые больше не хотите получать, или временно приостановить их при обновлении интеграции, а затем снова включить. Когда вы включаете файловую схему, мы отправляем файлы, чтобы наверстать упущенное с момента последнего экспорта. Если вы не экспортировали какой-либо файл раньше (файл никогда не был «включен»), первоначальная синхронизация содержит ваши исторические данные.
Вы также можете полностью отключить синхронизацию, и в этом случае мы прекратим отправку файлов. Когда вы снова включаете синхронизацию, мы отправляем все ваши исторические данные, как будто вы начинаете новую интеграцию. Прежде чем отключить синхронизацию, подумайте, хотите ли вы просто отключить отдельные файлы и возобновить их позже.
Удалите старые файлы синхронизации перед повторным включением синхронизации
Прежде чем возобновить синхронизацию, которую вы ранее отключили, вы должны удалить все старые файлы из своего сегмента хранилища, чтобы не было путаницы между вашими старыми файлами и файлами, которые мы отправляем с помощью повторно включенная синхронизация.
Отключение и включение отдельных файлов экспорта
- Перейдите в Данные и интеграции > Интеграции и выберите Яндекс .
- Выберите файлы, которые вы хотите включить или выключить.
Когда вы включаете файл , следующая синхронизация будет содержать базовые исторические данные, догоняющие вашу предыдущую синхронизацию, или полную историю, если вы не синхронизировали файл раньше; последующие синхронизации будут содержать наборы изменений.
Отключение синхронизации
Если синхронизация уже отключена, вы можете снова включить ее с помощью этих инструкций. Но перед повторным включением синхронизации следует сначала удалить предыдущие файлы синхронизации из корзины хранилища данных. Дополнительные сведения см. в разделе Приостановка и возобновление синхронизации.
- Перейдите на Данные и интеграции > Интеграции и выберите Яндекс .
- Нажмите Отключить синхронизацию .
Управление конфигурацией
Вы можете изменить настройки корзины, если ваш путь изменится или вам нужно поменять местами ключи в целях безопасности.
- Перейдите на Данные и интеграции > Интеграции и выберите Яндекс .
- Щелкните Управление конфигурацией для своего сегмента.
- Внесите изменения. Независимо от ваших изменений, вы должны снова ввести ключ сервисной учетной записи (GCS) или секретный ключ (S3, Яндекс).
- Нажмите Обновление конфигурации . При последующих синхронизациях будет использоваться ваша новая конфигурация.
Обновите версию схемы синхронизации
Перед подготовкой к обновлению версии синхронизации хранилища данных просмотрите журнал изменений. Вам потребуется обновить схемы, чтобы перейти на последнюю версию (v4).
- Перейдите на Данные и интеграции > Интеграции и выберите Яндекс .
- Щелкните Обновить версию схемы .
- Следуйте инструкциям, чтобы убедиться, что ваша логика приема обновлена соответствующим образом.
- Подтвердите создание соответствующих страниц и нажмите Обновить синхронизацию . Следующая синхронизация использует обновленную версию схемы.
Схемы файлов Parquet
В этом разделе описываются различные типы файлов, которые вы можете экспортировать из наших интеграций с выходом из базы данных.
Многие схемы включают internal_customer_id — это идентификатор cio_idAn для человека, который автоматически генерируется Customer.io и не может быть изменен. Этот идентификатор обеспечивает полную, непрерывную запись человека при изменении его других идентификаторов (идентификатор, адрес электронной почты и т. д.).
Эти схемы представляют собой последние доступные версии. Ознакомьтесь с нашим журналом изменений для получения информации о более ранних версиях.
Доставки
Доставки — это отдельные записи электронной почты, push-уведомлений, SMS, Slack и веб-перехватчиков, отправленные из вашей рабочей области. Первый файл экспорта поставок включает базовые исторические данные. Последующие файлы содержат строки для данных, которые изменились с момента последнего экспорта.
| Имя поля | Первичный ключ | Внешний ключ | Описание |
|---|---|---|---|
| workspace_id | 90). Идентификатор рабочей области Customer.io, связанной с записью о доставке. | ||
| delivery_id | ✅ | STRING (обязательно). Идентификатор записи о доставке. | |
| internal_customer_id | Люди | STRING (можно обнулить). people , чтобы преобразовать этот идентификатор во внешний customer_id или адрес электронной почты. | |
| subject_id | Темы | STRING (Обнуляется). Если доставка была создана как часть рабочего процесса Campaign или API Trigger Broadcast, это идентификатор пути, по которому человек прошел в рабочем процессе. Примечание. Это значение относится к имя_субъекта 9 и совпадает с ним.0179 в таблице предметов. | |
| event_id | Метрики | STRING (можно обнулить). Если доставка была создана как часть кампании, инициируемой событием, это идентификатор уникального события, которое инициировало рабочий процесс. | |
| delivery_type | STRING (обязательно). Тип доставки: email, push, in-app, sms, slack или webhook. | ||
| id_кампании | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если доставка была создана как часть рабочего процесса Кампания или Инициируемая API широковещательная рассылка, это идентификатор для Кампании или Инициируемой API широковещательной рассылки. | ||
| action_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если доставка была создана как часть рабочего процесса Campaign или API Triggered Broadcast, это идентификатор уникального элемента рабочего процесса, вызвавшего создание доставки. | ||
| информационный бюллетень_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если доставка была создана как часть информационного бюллетеня, это уникальный идентификатор этого информационного бюллетеня. | ||
| content_id | INTEGER (можно обнулить). Если рассылка была создана в рамках сплит-теста рассылки, это уникальный идентификатор варианта рассылки. | ||
| trigger_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если доставка была создана как часть широковещательной рассылки, инициируемой API, это уникальный идентификатор триггера, связанный с вызовом API, который инициировал широковещательную рассылку. | ||
| created_at | TIMESTAMP (обязательно). Отметка времени, в которой была создана доставка. | ||
| transactional_message_id | ЦЕЛОЕ ЧИСЛО (может принимать значение NULL). Если доставка произошла как часть транзакционного сообщения, это уникальный идентификатор вызова API, который инициировал сообщение. | ||
| seq_num | INTEGER (Обязательное) Монотонно возрастающее число, указывающее относительную давность каждой записи: чем больше число, тем новее запись. |
Содержимое доставки
Схема delivery_content представляет содержимое сообщения; каждая строка соответствует отдельной доставке.
Используйте delivery_id для получения дополнительной информации о содержимом сообщения или получателя , чтобы найти информацию о человеке, получившем сообщение.
Если ваша рассылка была произведена в рамках кампании, она будет включать идентификаторы кампании и действия, а идентификаторы информационного бюллетеня и контента будут нулевыми. Если ваша доставка пришла из информационного бюллетеня, строка будет содержать идентификаторы информационного бюллетеня и контента, а идентификаторы кампании и действия будут нулевыми.
Содержимое доставки может отставать от других таблиц на 15-30 минут (или примерно на 1 операцию синхронизации). Мы упаковываем содержимое доставки с 15-минутным интервалом и можем экспортировать в ваше хранилище данных каждые 15 минут. Если эти операции не совпадают, мы можем время от времени экспортировать delivery_content после других таблиц.
Доставляемый контент может представлять собой очень большой набор данных.
Рабочие области, в которых отправлено много сообщений, могут содержать сотни или тысячи ГБ данных.
| Название поля | Первичный ключ | Иностранный ключ | Описание | |
|---|---|---|---|---|
| Доставка_D | ✅ | Доставки | 9079✅ | . Идентификатор этой доставки, связанной с содержимым сообщения. |
| workspace_id | ЦЕЛОЕ ЧИСЛО (обязательно). Идентификатор рабочей области Customer.io, связанной с выходной записью. | |||
| тип | STRING (обязательно). Тип доставки — электронная почта, sms, push, in-app или webhook. | |||
| id_кампании | ЦЕЛОЕ ЧИСЛО (можно обнулить). Идентификатор кампании, создавшей контент (если применимо). | |||
| action_id | ЦЕЛОЕ ЧИСЛО (Обнуляется). Идентификатор элемента рабочего процесса кампании, создавшего контент. | информационный бюллетень_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Идентификатор информационного бюллетеня, из которого был создан контент. | content_id | INTEGER (можно обнулить). Идентификатор элемента тестирования A/B информационного бюллетеня, в результате которого было создано содержимое, 0 проиндексировано. Если ваш информационный бюллетень не включал A/B-тест, это значение равно 0. | из | STRING (можно обнулить). Адрес отправителя для электронной почты, если содержимое представляет собой электронную почту. | answer_to | STRING (можно обнулить). Адрес для ответа на электронное письмо, если содержимое связано с электронным письмом. |
| скрытая копия | STRING (можно обнулить). Адрес слепой копии (BCC) для электронного письма, если содержимое связано с электронным письмом. | |||
| получатель | STRING (обязательно). Лицо, получившее сообщение, зависит от типа. Для электронной почты это адрес электронной почты; для SMS это номер телефона; для push-уведомления это идентификатор устройства. | |||
| тема | STRING (можно обнулить). Тема сообщения, если применимо; требуется, если сообщение представляет собой электронное письмо | body | STRING (обязательно). Тело сообщения, включая всю HTML-разметку для электронного письма. | |
| body_amp | STRING (Обнуляемый). HTML-текст сообщения электронной почты, включая любой код JavaScript с поддержкой AMP, включенный в сообщение. | |||
| body_plain | СТРОКА (обязательно). Простой текст вашего сообщения. Если тип контента — электронная почта, это текст сообщения без HTML-тегов и AMP-контента. | |||
| предварительный заголовок | STRING (можно обнулить). «Также известный как «текст для предварительного просмотра», это блок текста, который пользователи видят рядом или под строкой темы в своем почтовом ящике. исходящий веб-перехватчик, это URL-адрес веб-перехватчика.0079 | |||
| метод | STRING (Обнуляемый). Если доставкой является исходящий веб-перехватчик, используется HTTP-метод — POST, PUT, GET и т. д. Если доставка является исходящим веб-перехватчиком, это заголовки, включенные в веб-перехватчик. |
Метрики
Метрики экспортируют подробные сведения о событиях, связанных с доставкой (например, сообщения отправлены, открыты и т. д.). Ваш первоначальный экспорт метрик содержит базовые исторические данные, разбитые на файлы с двумя порядковыми номерами следующим образом: <имя>_v3_<идентификатор_рабочей_области>_<последовательность1>_последовательность2> .
Последующие файлы содержат строки для данных, которые изменились с момента последнего экспорта.
| Название поля | Первичный ключ | Иностранный ключ | Описание |
|---|---|---|---|
| Event_ID | ✅ | String). Уникальный идентификатор события метрики. Это может быть полезно для целей дедупликации. | |
| workspace_id | ЦЕЛОЕ ЧИСЛО (обязательно). Идентификатор рабочей области Customer.io, связанной с записью метрики. | ||
| delivery_id | Доставки | STRING (обязательно). Идентификатор записи о доставке. | |
| метрическая система | STRING (обязательно). Тип метрики (например, отправлено, доставлено, открыто, кликнуло). | ||
| причина | STRING (можно обнулить). Для определенных метрик (например, попытка) причина действия. | ||
| link_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Для метрик "clicked" уникальный идентификатор ссылки, на которую нажали. | ||
| link_url | STRING (можно обнулить). Для метрик "нажатий" URL-адрес ссылки, на которую нажали. (Усечено до 1000 байт.) | ||
| created_at | TIMESTAMP (обязательно). Отметка времени, в которой была создана метрика. | ||
| seq_num | INTEGER (Обязательно) Монотонно возрастающее число, указывающее относительную давность каждой записи: чем больше число, тем новее запись. |
Выходы
Выходы — это уникальные этапы каждого пути рабочего процесса. Первый выходной файл включает исторические данные. Последующие файлы содержат строки для данных, которые изменились с момента последнего экспорта.
| Имя поля | Первичный ключ | Внешний ключ | Описание |
|---|---|---|---|
| workspace_id | 30EGER88. Идентификатор рабочей области Customer.io, связанной с выходной записью.|||
| output_id | ✅ | STRING (обязательно). Идентификатор этапа уникального пути, который прошел человек в рабочем процессе Campaign или API Trigger Broadcast. | |
| имя_субъекта | Темы | STRING (обязательно). Дополнительный уникальный идентификатор для пути, который человек прошел через кампанию или рабочий процесс трансляции. | |
| output_type | STRING (обязательно). Тип шага, который прошел человек в рабочем процессе Campaign или API Trigger Broadcast. Обратите внимание, что output_type "delay" охватывает множество вариантов использования: элемент рабочего процесса Time Delay или Time Window, "льготный период" или триггер кампании на основе даты. | ||
| action_id | ЦЕЛОЕ ЧИСЛО (обязательно). Идентификатор уникального элемента рабочего процесса, связанного с выходными данными. | ||
| объяснение | СТРОКА (обязательно). Пояснение к выходу. | ||
| delivery_id | Доставки | STRING (можно обнулить). Если на этом шаге рабочего процесса произошла доставка, это идентификатор этой доставки. | |
| проект | BOOLEAN (Обнуляемый). Если на этом шаге рабочего процесса была получена поставка, это указывает, была ли поставка создана как черновик. | ||
| link_tracked | BOOLEAN (Обнуляемый). Если в результате этого шага рабочего процесса была доставлена доставка, это указывает, настроены ли ссылки в доставке для отслеживания. | ||
| split_test_index | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если этапом рабочего процесса был сплит-тест, это указывает на вариант сплит-теста. | ||
| delay_ends_at | TIMESTAMP (Обнуляемый). Если шаг рабочего процесса включает задержку, это отметка времени окончания задержки. | ||
| branch_index | INTEGER (можно обнулить). Если этапом рабочего процесса была ветвь T/F, ветвь с несколькими разделениями или ветвь случайной когорты, это указывает на ветвь, которой следовали. | ||
| manual_segment_id | ЦЕЛОЕ ЧИСЛО (можно обнулить). Если этап рабочего процесса был ручным обновлением сегмента, это идентификатор вовлеченного ручного сегмента. | ||
| add_to_manual_segment | BOOLEAN (Обнуляемый). Если этапом рабочего процесса было обновление сегмента вручную, это указывает, был ли человек добавлен или удален из задействованного сегмента вручную. | ||
| created_at | TIMESTAMP (обязательно). Временная метка, в которой был создан вывод. | ||
| seq_num | INTEGER (Обязательно) Монотонно возрастающее число, указывающее относительную давность каждой записи: чем больше число, тем новее запись. |
Люди
Первый файл экспорта «Люди» включает список текущих людей на момент первой синхронизации (удаленные или подавленные люди не включаются в первый файл). Последующие экспорты включают людей, которые были созданы, удалены или подавлены с момента последнего экспорта.
Начиная с v3, экспорт людей осуществляется в два разных файла:
-
people_v3_: Содержит новых людей._ .parquet -
people_v3_chngs_: Содержит изменения людей с момента предыдущей синхронизации._ .parquet
Эти файлы имеют идентичную структуру и часть одного и того же набора данных. Вы должны импортировать их в ту же таблицу.
| Имя поля | Первичный ключ | Внешний ключ | Описание |
|---|---|---|---|
| workspace_id | 30EGER88. Идентификатор рабочей области Customer.io, связанной с человеком.|||
| customer_id | STRING (обязательно). Идентификатор человека, о котором идет речь. Это будет соответствовать идентификатору, который вы видите в пользовательском интерфейсе Customer.io. | ||
| internal_customer_id | ✅ | STRING (обязательно). cio_id рассматриваемого лица. Используйте файл паркета people , чтобы преобразовать этот идентификатор во внешний customer_id или адрес электронной почты. | |
| удалено | BOOLEAN (Обнуляемый). Это указывает, был ли человек удален. | ||
| подавлен | BOOLEAN (Обнуляемый). Это указывает на то, был ли человек подавлен. | ||
| created_at | TIMESTAMP (обязательно). Отметка времени, в которой был создан профиль. Обратите внимание, что это отметка времени создания профиля в базе данных Customer.io, которая может не совпадать с атрибутом профиля created_at . | ||
| updated_at | TIMESTAMP (обязательно) Дата-время, когда человек был обновлен. Используйте самое последнее значение updated_at для customer_id, чтобы устранить неоднозначность между несколькими записями. | ||
| email_addr | STRING (Необязательно) Адрес электронной почты человека. Для рабочих областей, использующих электронную почту в качестве уникального идентификатора, это значение может совпадать с customer_id . |
Субъекты
Субъекты — это уникальные этапы рабочего процесса, которые люди проходят через кампании и широковещательные трансляции, запускаемые API. Первый файл экспорта субъектов включает базовые исторические данные. Последующие файлы содержат строки для данных, которые изменились с момента последнего экспорта.
| Имя поля | Первичный ключ | Внешний ключ | Описание |
|---|---|---|---|
| workspace_id | 8workspace_id | 737INTER8. Идентификатор рабочей области Customer.io, связанной с записью субъекта. | |
| subject_name | ✅ | STRING (обязательно). Уникальный идентификатор пути, который человек прошел через кампанию или рабочий процесс трансляции. | |
| internal_customer_id | Люди | STRING (Обнуляемый). cio_id рассматриваемого лица. Используйте файл паркета people , чтобы преобразовать этот идентификатор во внешний customer_id или адрес электронной почты. | |
| кампания_тип | STRING (обязательно). Тип кампании (сегмент, событие или триггерная_трансляция) | ||
| id_кампании | ЦЕЛОЕ ЧИСЛО (обязательно). Идентификатор кампании или широковещательной рассылки, запускаемой API. | ||
| event_id | Метрики | STRING (можно обнулить). Идентификатор уникального события, запустившего рабочий процесс. | |
| trigger_id | ЦЕЛОЕ ЧИСЛО (необязательно). Если доставка была создана как часть широковещательной рассылки, инициируемой API, это уникальный идентификатор триггера, связанный с вызовом API, который инициировал широковещательную рассылку. | ||
| start_campaign_at | TIMESTAMP (обязательно). Отметка времени, когда человек впервые совпал с триггером кампании. Для кампаний, инициируемых событием, это временная метка триггерного события. Для кампаний, инициируемых сегментом, это время входа пользователя в сегмент. | ||
| created_at | TIMESTAMP (обязательно). Отметка времени, в которой была создана тема. | ||
| seq_num | INTEGER (Обязательно) Монотонно возрастающее число, указывающее относительную давность каждой записи: чем больше число, тем новее запись. |
Атрибуты
Экспорт атрибутов представляет изменения людей (в виде значений их атрибутов) с течением времени. Первоначальный экспорт атрибутов включает список профилей и их текущие атрибуты. Последующие файлы содержат атрибут изменяется на , по одному изменению на строку.
| Имя поля | Первичный ключ | Внешний ключ | Описание |
|---|---|---|---|
| workspace_id | 30EGER88.
