Источник данных – это контейнер, в котором хранятся данные, которые вы загружаете в Аналитику. Он содержит базу данных, сервис или загруженный вами файл CSV и сопоставление полей Аналитики с полями этой базы, сервиса или файла. Источники данных определяют, как загруженная информация объединяется с существующей. Источники настраиваются на уровне ресурса.
Чтобы перейти к управлению источниками данных определенного ресурса, откройте страницу Администратор и в разделе Сбор и редактирование данных выберите Импорт данных.
Типы источников данных
Тип источника данных соответствует типу данных, которые требуется импортировать. Например, есть источники:
Для каждого типа доступны разные параметры и показатели, которые можно загрузить (то есть различные схемы). В зависимости от источника данных вы можете:
- загрузить CSV;
- использовать SFTP;
- подключиться к Salesforce (подробнее…).
Этот раздел предназначен для пользователей, которые хотят импортировать данные об офлайн-событиях Salesforce в Google Аналитику 4.
- У вас должна быть роль редактора ресурса Аналитики, который будет использоваться для импорта данных.
- Примеры кода в этом разделе носят справочный характер. Вам может потребоваться добавить дополнительный код или использовать другой подход (в зависимости от вашего решения).
Шаг 1. Выберите способ идентификации пользователей
В Google Аналитике доступны два способа программной идентификации пользователей: с помощью Client-ID и User-ID. Чтобы можно было импортировать данные Salesforce, необходимо реализовать решение с использованием Client-ID. При желании можно также использовать User-ID.
Client-ID – это псевдоанонимный идентификатор экземпляра браузера. Он создается автоматически, когда пользователь впервые заходит на сайт, где реализовано отслеживание с помощью Google Аналитики (вход в аккаунт при этом необязателен), и сохраняется с помощью файла cookie.
User-ID – это уникальный постоянный номер, который присваивается пользователю и позволяет анонимно идентифицировать его на разных устройствах и в разных сеансах.
Client-ID и при необходимости User-ID необходимо добавить на страницу формы для потенциальных клиентов и другие страницы, которые вы хотите отслеживать. Это можно сделать с помощью Google Менеджера тегов или переменной JavaScript.
Шаг 2. Настройте доступ к объектам и полям Salesforce
Чтобы настроить интеграцию Аналитики с Salesforce, нужно иметь полный доступ к указанным ниже объектам и полям Salesforce. Обычно системные администраторы Salesforce имеют нужный доступ по умолчанию.
Кроме того, пользователю, который будет связывать аккаунты Salesforce и Google Аналитики, требуется разрешение Modify All Data (Изменение всех данных). Это необходимо, чтобы Salesforce Metadata API позволил серверам Google получать данные о настройках конверсий в лиды. Эта интеграция не вносит изменений в аккаунт Salesforce. Metadata API используется только для чтения.
Показать список обязательных полей
Объект | Обязательные поля | |
---|---|---|
LeadStatus |
ID MasterLabel SortOrder |
|
OpportunityStage |
ID MasterLabel SortOrder IsActive |
|
LeadHistory |
CreatedDate OldValue NewValue Field |
|
Lead |
Status GACLIENTID* GAUSERID* GAMEASUREMENTID* |
|
OpportunityFieldHistory |
CreatedDate OldValue NewValue Field |
|
Opportunity |
Amount StageName GACLIENTID* GAUSERID* GAMEASUREMENTID* |
|
OpportunityLineItem | Все поля | |
Product2 (продукты) | Все поля | |
Pricebook2 (каталоги цен) | Все поля |
*Специальные поля, которые необходимо будет создать (см. шаг 3).
Если вы используете Salesforce Group Edition или Professional Edition, то доступ к полям предоставляется при добавлении нужных полей на макеты страниц Lead (Потенциальный клиент) и Opportunity (Возможность). Подробнее о настройке макетов страниц и привилегиях доступа к полям в Salesforce…
Шаг 3. Создайте специальные поля в Salesforce
Следуя этим инструкциям, создайте три специальных поля в Salesforce, чтобы хранить в них данные Аналитики. Этим полям можно присвоить любые названия. Нижеследующие названия являются лишь рекомендациями, но мы советуем использовать именно их, поскольку они могут понадобится для внедрения и отладки (при необходимости).
Название поля | Название API | Длина поля |
---|---|---|
GACLIENTID | GACLIENTID__c |
255 |
GAUSERID | GAUSERID__c |
255 |
GAMEASUREMENTID | GAMEASUREMENTID__c |
255 |
- Вы должны обязательно добавить Client-ID и по желанию – User-ID.
- Названия полей должны быть написаны заглавными буквами. Метки (ярлыки) полей могут быть любыми.
- Сделайте эти поля доступными только для чтения, чтобы предотвратить нежелательные изменения.
- Эти поля необходимо создать в обоих объектах: Lead и Opportunity.
Шаг 4. Настройте объекты Lead и Opportunity
В настройках объекта Lead включите отслеживание истории полей для поля Lead status. В настройках объекта Opportunity включите отслеживание истории полей для поля Stage. Тогда при каждом обновлении этих полей будет создаваться событие.
Сопоставьте поля каждого объекта с соответствующими полями другого объекта:
- поле Lead.GACLIENTID с полем Opportunity.GACLIENTID;
- поле Lead.GAUSERID с полем Opportunity.GAUSERID;
- поле Lead.GAMEASUREMENTID с полем Opportunity.GAMEASUREMENTID.
Шаг 5. Измените форму для потенциальных клиентов
Измените форму для потенциальных клиентов, чтобы она получала и сохраняла необходимую для отслеживания информацию. Для этого понадобится идентификатор потока данных.
Для чего необходим идентификатор потока данных?
Добавление специальных полей отслеживания
В следующих примерах показано, как добавить созданные ранее специальные поля в форму для потенциальных клиентов с помощью JavaScript:
<form action="" name="myForm">
Phone: <input type="text" name="phone_number">
<input type="hidden" id="GACLIENTID" name="GACLIENTID" value="">
<input type="hidden" id="GAUSERID" name="GAUSERID" value="">
<input type="hidden" id="GAMEASUREMENTID" name="GAMEASUREMENTID" value="i-gno/re-dXXXXX">
<input type="submit">
</form>
i-gno/re-dXXXXX
идентификатором потока данных.Как присвоить значения специальным полям
Добавьте следующий код в форму для потенциальных клиентов, чтобы задавать значение идентификаторов Client-ID и User-ID:
<script type="text/javascript">
document.getElementById('FORM_ID').addEventListener(
'submit', function(event) {
ga(function() {
var tracker = ga.getAll()[0];
var clientId = tracker.get('clientId');
document.getElementById('GACLIENTID').value = clientId;
var userId = tracker.get('userId');
document.getElementById('GAUSERID').value = userId;
});
});
</script>
Шаг 6. Свяжите Аналитику с аккаунтом Salesforce
Чтобы связать Google Аналитику с аккаунтом Salesforce, создайте новую конфигурацию для импорта данных и разрешите доступ к аккаунту Salesforce.
Тип источника данных соответствует типу данных, которые требуется импортировать, например, данные о расходах, данные о товарах, пользовательские данные и данные об офлайн-событиях. Для каждого типа доступны разные параметры и показатели, которые можно загрузить (то есть различные схемы). В Salesforce используется импорт данных об офлайн-событиях. Подробнее о данных об офлайн-событиях…
Как импортировать данные Salesforce
Чтобы импортировать офлайн-данные Salesforce о лидах и возможностях с помощью функции импорта, выполните следующие действия:
- На странице Администратор и в разделе Сбор и редактирование данных выберите Импорт данных.
Ссылка "Назад" ведет на ресурс Аналитики, который вы открывали последним. Вы можете выбрать другой ресурс с помощью селектора.
- Нажмите Создать источник данных.
- Укажите название источника данных.
- Выберите Данные об офлайн-событиях в качестве типа данных.
- Если появится запрос, нажмите Ознакомиться с условиями и примите Условия сбора пользовательских данных. Это необходимое требование для загрузки офлайн-событий и/или пользовательских данных.
- В разделе Загрузка данных для импорта выберите Salesforce как Источник импорта.
- В появившемся всплывающем окне войдите в аккаунт Salesforce.
- Выберите Расписание импорта. Обратите внимание, что стандартные ресурсы поддерживают ежедневный импорт, а ресурсы Аналитики 360 – ежечасный.
- Нажмите Далее.
- Выберите основные этапы и поля Salesforce, которые нужно учитывать как события Аналитики. Посмотрите шаги 7, 8 и 9 ниже.
- Нажмите Импортировать. После инициирования процесса данные будут импортированы по графику.
Шаг 7. Настройте лидов
Выберите ключи, этапы и поля параметров для лидов, которые необходимо регистрировать как события.
Шаг 8. Настройте возможности
Выберите ключи, этапы и необязательные поля для возможностей, которые вы хотите регистрировать как события.
Если вы хотите, чтобы события-конверсии возможностей влияли на данные о доходе и общей ценности, рекомендуем:
- Сопоставить этап последней конверсии (реализованной возможности) с событием покупки (purchase). Это нужно, чтобы правильно учитывать доход для событий, которые его приносят.
- Сопоставить поле amount (сумма), в котором указана сумма дохода от реализованной возможности с параметром value (ценность), который содержит данные GA4 о доходе.
- Сопоставить поле Id (идентификатор) любое другое поле, содержащее идентификатор транзакции, с полем GA4 transaction id (идентификатор транзакции).
Поддерживаемые стандартные поля
Атрибуты можно импортировать из следующих стандартных полей объектов Lead из Salesforce:
- Id
- Industry
- NumberOfEmployees
- Rating
- ScoreIntelligenceId (если это поле доступно в вашей версии Salesforce)
Также можно импортировать следующие стандартные поля объектов Opportunity:
- Amount
- CampaignId
- ContractId
- ExpectedRevenue
- Id
- LeadSource
- Name
- Probability
- TotalOpportunityQuantity
Поддерживаемые форматы
Кроме перечисленных выше стандартных полей, можно импортировать все поля настраиваемых атрибутов Salesforce, содержащие данные в следующих форматах:
- boolean
- currency
- date
- datetime
- dateTime (camelCase)
- double
- int
- percent
- picklist
- string
- textarea
- time
Чтобы импортировать атрибуты, выполните следующие действия:
- Выберите специальные параметры и показатели Google Аналитики, в которые нужно импортировать данные атрибутов.
- Убедитесь, что у выбранных специальных параметров правильная область действия. В большинстве случаев это свойства пользователей. Подробнее об областях действия параметров GA4…
- С помощью раскрывающегося меню в столбце с названиями полей Salesforce свяжите поля Google Аналитики с нужными полями Salesforce.
Пример конфигурации
Ниже приведен пример связывания полей Salesforce со специальными полями Google Аналитики.
Специальное поле Аналитики | область действия | Название поля в Salesforce |
---|---|
Параметр: событие ИЛИ пользователь | Lead: Lead ID |
Параметр: событие ИЛИ пользователь | Lead: Lead Score |
Параметр | пользователь | Lead: Industry |
Параметр: событие ИЛИ пользователь | Lead: Rating |
Параметр: событие ИЛИ пользователь | Opportunity: Opportunity ID |
Показатель: событие | Opportunity: Amount |
Параметр: событие ИЛИ пользователь | Opportunity: Probability |
Показатель: событие | Opportunity: Expected Amount |
Параметр: событие ИЛИ пользователь | Opportunity: Order Number |
Как выбрать область действия?
Шаг 9. Проверьте созданную конфигурацию
Проверьте настройки: убедитесь, что импортированные данные Salesforce показываются в отчетах Аналитики (например, в отчете События или В реальном времени) и в разделе Исследования.
Чтобы проверить статус последнего импорта, перейдите на страницу Администратор и в разделе Сбор и редактирование данных нажмите Импорт данных.
Примечания и ограничения
- Соблюдайте Условия использования Google Аналитики и требования Политики конфиденциальности.
- Не импортируйте информацию, позволяющую идентифицировать личность.
- Если импортированные данные содержат денежные суммы, то они указываются в валюте, выбранной в аккаунте Salesforce (или в нескольких валютах, если в Salesforce включена поддержка нескольких валют).
- Данные о товарах из Salesforce импортируются в объект Opportunity, а не Lead.
- Пустые поля удаляются при импорте.
- Максимальное количество уникальных индексов: 200.
Схема источника данных
При создании источника вы определяете схему, по которой существующие данные событий Аналитики будут объединяться с загружаемыми. Простая схема состоит из ключа соединения и импортируемых параметров или показателей. Чтобы импортировать данные, Google Аналитика ищет соответствия между парами "ключ-значение" в данных о событиях и загружаемых данных. Когда соответствие найдено, связанные с этим ключом значения параметров и показателей добавляются к существующим данным событий или заменяют их, если такие данные уже собраны. В некоторых типах источников данных можно задать несколько параметров для определения ключа. При этом почти во всех можно использовать различные параметры и показатели для полей импорта.
Ключ соединения может содержать от одного до трех параметров Аналитики.
Ключевые параметры меняются в зависимости от выбранного набора данных.
Доступные параметры будут перечислены в раскрывающемся меню при настройке схемы источника данных.
Загружать данные из одного и того же источника можно многократно, просто добавляя значения в существующие поля. После сохранения источника данных изменить сопоставление полей Аналитики с полями импортируемых данных нельзя. Если понадобится добавить поля в имеющийся источник данных, нужно будет удалить его и создать новый. Или же можно импортировать дополнительный источник данных с новыми полями, которые требуется включить. Подробнее о лимитах для разных типов импортируемых данных…
При повторном импорте данных в имеющийся источник данных ранее импортированные данные сохраняются до тех пор, пока не будут импортированы новые данные. Если у импортированных данных тот же набор ключей, что и у предыдущих, старые данные будут перезаписаны.