Как настроить интеграцию Salesforce Sales Cloud с Google Аналитикой

Эта функция доступна только в Аналитике 360, входящей в Google Платформу для маркетинга. Подробнее о Google Платформе для маркетинга…

У вас должна быть роль редактора ресурса Аналитики, который будет использоваться для этой интеграции.

Примеры кода в этой статье носят справочный характер. Вам может потребоваться добавить дополнительный код или использовать совершенно другой подход (в зависимости от особенностей вашего решения).

Содержание

• Выбор способа идентификации пользователей
• Обязательные объекты и поля Salesforce Sales Cloud
• Создание специальных полей в Salesforce Sales Cloud
• Изменение формы для потенциальных клиентов
• Связывание аккаунтов Google Аналитики и Salesforce Sales Cloud
• Настройка импортируемых контрольных точек из аккаунта Salesforce
• Настройка данных об атрибутах и товарах (необязательный шаг)
• Расписание источника данных
• Проверка конфигурации
• Примечания и ограничения

Выбор способа идентификации пользователей

В Google Аналитике доступны два способа программной идентификации пользователей: с помощью Client-ID и User-ID. Чтобы можно было импортировать данные Salesforce Sales Cloud, необходимо реализовать Client-ID. При желании можно также использовать User-ID.

Client-ID – это псевдоанонимный идентификатор экземпляра браузера. Он создается автоматически, когда пользователь впервые заходит на сайт, где реализовано отслеживание с помощью Google Аналитики (вход в аккаунт при этом необязателен), и сохраняется с помощью файла cookie. Решения на основе Client-ID оптимальны для компаний, заинтересованных прежде всего в привлечении новых клиентов. Как правило, приложения и сайты таких компаний имеют низкий процент пользователей, входящих в аккаунты, и низкие показатели удержания клиентов.

User-ID – это уникальный постоянный номер, который присваивается пользователю и позволяет анонимно идентифицировать его на разных устройствах и в разных сеансах. Решения на его основе подходят для компаний с высоким процентом пользователей, входящих в аккаунты. Чтобы реализовать User-ID, необходимо задать дополнительные настройки и добавить код на сайт:

1. Включите функцию User-ID для ресурса Google Аналитики.
2. Добавьте User-ID на страницу с формой для потенциальных клиентов, а также на все остальные страницы, где нужно собирать данные. Это можно сделать с помощью Google Менеджера тегов или переменной JavaScript.

Подробнее о файлах cookie и идентификации пользователей рассказывается в Руководстве для разработчиков Google Аналитики.

Использование функции User-ID регулируется правилами Measurement Protocol, SDK и User-ID.

Обязательные объекты и поля Salesforce Sales Cloud

Для настройки интеграции между Google Аналитикой и Salesforce Sales Cloud у вас должен быть полный доступ к перечисленным ниже объектам и полям Salesforce. Аккаунт пользователя Salesforce с уровнем доступа System Administrator (Системный администратор) может по умолчанию иметь доступ к этим полям.

Кроме того, пользователю, который будет связывать аккаунты Salesforce и Google Аналитики, требуется разрешение Modify All Data (Изменение всех данных). Это необходимо, чтобы Salesforce Metadata API позволил серверам Google получать данные о настройках конверсий потенциальных клиентов. Эта интеграция не вносит изменений в аккаунт Salesforce. Metadata API используется только для чтения.

Аккаунты пользователей с ограниченным доступом к данным о потенциальных клиентах и возможностях могут иметь недостаточно привилегий для импорта нужных данных. Например, аккаунт представителя отдела продаж может иметь доступ только к данным о некоторых странах и возможностях. Такой аккаунт не рекомендуется использовать для связывания Google Аналитики и Salesforce.

Показать список обязательных полей

Объект	Обязательные поля
LeadStatus	ID MasterLabel SortOrder
OpportunityStage	ID MasterLabel SortOrder IsActive
LeadHistory	CreatedDate OldValue NewValue Field
Lead	Status GACLIENTID* GAUSERID* GATRACKID*
OpportunityFieldHistory	CreatedDate OldValue NewValue Field
Opportunity	Amount StageName GACLIENTID* GAUSERID* GATRACKID*
OpportunityLineItem	Все поля
Product2 (продукты)	Все поля
Pricebook2 (каталоги цен)	Все поля

*Специальные поля, которые необходимо будет создать (см. шаг 3).

Если вы используете Salesforce Group Edition или Professional Edition, то доступ к полям предоставляется при добавлении нужных полей на макеты страниц Lead (Потенциальный клиент) и Opportunity (Возможность). Подробнее о настройке макетов страниц и привилегиях доступа к полям в Salesforce…

Создание специальных полей в Salesforce Sales Cloud

Следуя этим инструкциям, создайте три специальных поля в Salesforce, чтобы хранить в них коды отслеживания Google Аналитики.

Этим полям можно присвоить любые названия. Приведенные ниже названия являются примерами.

Название поля	Название API	Длина поля
GACLIENTID	GACLIENTID__c	255
GAUSERID	GAUSERID__c	255
GATRACKID	GATRACKID__c	255

 

Создание всех трех полей является обязательным требованием (независимо от того, какой метод вы выбрали на шаге 1).

Названия полей должны быть написаны заглавными буквами. Метки (ярлыки) полей могут быть любыми.

Сделайте эти поля доступными только для чтения, чтобы предотвратить нежелательные изменения.

Эти поля необходимо создать в обоих объектах: Lead и Opportunity.

Настройка объектов Lead и Opportunity

В настройках объекта Lead включите отслеживание истории полей для поля Lead status. В настройках объекта Opportunity включите отслеживание истории полей для поля Stage. Тогда при каждом обновлении этих полей будет создаваться событие обращения.

Сопоставьте поля каждого объекта с соответствующими полями другого объекта:

• поле Lead.GACLIENTID с полем Opportunity.GACLIENTID;
• поле Lead.GAUSERID с полем Opportunity.GAUSERID;
• поле Lead.GATRACKID с полем Opportunity.GATRACKID.

Изменение формы для потенциальных клиентов

На этом шаге нужно изменить форму для потенциальных клиентов, чтобы она получала и сохраняла необходимую для отслеживания информацию. Для этого требуется знать свой идентификатор отслеживания Google Аналитики.

Почему необходим идентификатор отслеживания?

Идентификатор отслеживания Google Аналитики позволяет системе различать данные, поступающие в один аккаунт Salesforce Sales Cloud из нескольких источников, то есть импортируемые из разных форм для потенциальных клиентов и с разных сайтов, которые отслеживаются через разные аккаунты Google Аналитики. Это невозможно реализовать только с помощью Client-ID и User-ID.

Добавление специальных полей отслеживания

В следующих примерах показано, как добавить созданные ранее специальные поля в форму для потенциальных клиентов с помощью JavaScript:

<form action="" name="myForm">
    Телефон: <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="GATRACKID" name="GATRACKID" value="UA-XXXXX-YY">
    <input type="submit">
</form>

В приведенном выше примере показано, как добавить оба идентификатора (Client-ID и User-ID). Если вы используете только Client-ID, то строку GAUSERID можно удалить.

Чтобы задать свой идентификатор отслеживания Google Аналитики статическим способом, укажите его вместо строки UA-XXXXX-YY. Чтобы получать этот идентификатор динамически, используйте следующий код:

<script type=”text/javascript”> 
    ga(function() { 
      var tracker = ga.getAll()[0];
      var trackingId = tracker.get('trackingId');
    });
</script>

 

Тогда статический идентификатор отслеживания (UA-XXXXX-YY) можно будет заменить на переменную trackingId:

    <input type="hidden" id="GATRACKID" name="GATRACKID" value=trackingID>

Присваивание значений специальным полям

Добавьте следующий код в форму для потенциальных клиентов, чтобы задавать значение идентификаторов 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>

Связывание аккаунтов Google Аналитики и Salesforce Sales Cloud

На этом шаге необходимо связать аккаунты Google Аналитики и Salesforce Sales Cloud, создав новый набор данных для импорта и разрешив доступ к аккаунту Salesforce Sales Cloud.

Как создать набор данных Salesforce Sales Cloud

1. Войдите в аккаунт Google Аналитики.
2. В левой нижней части страницы нажмите Администратор и перейдите к ресурсу, с которым нужно установить связь. Вам потребуется роль редактора ресурса.
3. В столбце Ресурс выберите Импорт данных.
4. Нажмите Создать.
5. В разделе Данные системы управления взаимодействием с клиентами в пункте Тип набора данных выберите Salesforce.
6. Прочитайте и примите Дополнительные условия импорта данных из Salesforce Sales Cloud в Google Аналитику.
7. В разделе Сведения о наборе данных задайте название набора данных и нажмите Продолжить. Появится панель "Сведения об источнике данных".

Нажмите на текущие учетные данные. Появится список всех ваших учетных данных, созданных в аккаунте Salesforce. Если какие-либо из них нужно удалить, нажмите на крестик X справа от них. Чтобы удалить учетные данные, которые используются в настоящий момент, их необходимо сначала отключить.

Как авторизоваться в Salesforce Sales Cloud

1. На панели Сведения об источнике данных в пункте Учетные данные Salesforce выберите Создать авторизацию.
2. Заполните поле Название для повторного использования учетных данных.
3. Нажмите Вход в Salesforce.
4. В открывшемся окне Salesforce войдите в свой аккаунт Salesforce Sales Cloud. После авторизации будет создана связь с Google Аналитикой. В раскрывающемся меню Учетные данные Salesforce появится имя из новых учетных данных.

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

Как настроить поля для отслеживания

На панели "Настройка полей для отслеживания" можно связать поля, настроенные в Salesforce, с нужными идентификаторами отслеживания Google Аналитики. Для каждого идентификатора отслеживания, который вы хотите использовать, выберите специальные поля Salesforce.

Если в списке нет нужного специального поля, проверьте, правильно ли оно настроено. Кроме того, оно должно быть правильно связано с объектами Lead и Opportunity в аккаунте Salesforce.

Если выбранные поля Salesforce уже содержат данные, нажмите кнопку "Посмотреть значения", чтобы проверить их. Так вы узнаете, правильно ли настроена конфигурация. Например, вы увидите, отображаются ли идентификаторы отслеживания в правильном формате.

Завершив настройку полей для отслеживания, нажмите Продолжить.

Настройка импортируемых контрольных точек из аккаунта Salesforce

На этом шаге нужно выбрать контрольные точки для потенциальных клиентов и возможностей, импортируемые из аккаунта Salesforce. Также нужно настроить периодичность импорта.

Контрольные точки импортируются в качестве событий Google Аналитики. Можно импортировать как стандартные, так и специальные статусы потенциальных клиентов и этапы возможностей.

1. На панели Сведения об источнике данных в разделе Выбор контрольных точек в раскрывающемся меню укажите контрольные точки, которые нужно импортировать.
2. Нажмите Продолжить.

Настройка данных об атрибутах и товарах (необязательный шаг)

Импорт данных об атрибутах позволяет импортировать атрибуты пользователей из специальных полей и выбранных стандартных полей объектов Lead и Opportunity из Salesforce. При этом вы выбираете специальные параметры и показатели Google Аналитики, в которых будут храниться эти данные.

Импорт данных о товарах позволяет импортировать сведения о товарах из аккаунта Salesforce. Эти данные при импорте передаются в тех же обращениях Measurement Protocol, что и данные о контрольных точках.

Выполнять импорт данных об атрибутах и товарах необязательно, но мы рекомендуем это сделать, поскольку это позволит настроить таргетинг на новые аудитории и анализировать примеры использования.

Поддерживаемые стандартные поля

Атрибуты можно импортировать из следующих стандартных полей объектов 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

Чтобы импортировать атрибуты, выполните следующие действия:

1. Выберите специальные параметры и показатели Google Аналитики, в которые нужно импортировать данные атрибутов.
2. Убедитесь, что у выбранных специальных параметров правильная область действия. В большинстве случаев это область действия "пользователь".
3. С помощью раскрывающегося меню в столбце с названиями полей Salesforce свяжите поля Google Аналитики с нужными полями Salesforce.

Если выбранные поля Salesforce уже содержат данные, то с помощью кнопки Посмотреть значения можно их проверить. Так вы узнаете, правильно ли настроена конфигурация.

Пример конфигурации

Ниже приведен пример связывания полей Salesforce со специальными полями Google Аналитики.

Специальное поле Аналитики | область действия	Название поля в Salesforce
Параметр | сеанс ИЛИ пользователь	Lead: Lead ID (идентификатор потенциального клиента)
Параметр | сеанс ИЛИ пользователь	Lead: Lead Score (оценка потенциального клиента по прогнозу Salesforce Einstein)
Параметр | пользователь	Lead: Industry (отрасль потенциального клиента)
Параметр | сеанс ИЛИ пользователь	Lead: Rating (рейтинг потенциального клиента)
Параметр | сеанс ИЛИ пользователь	Opportunity: Opportunity ID (идентификатор возможности)
Показатель | обращение	Opportunity: Amount (сумма, связанная с возможностью)
Параметр | сеанс ИЛИ пользователь	Opportunity: Probability (вероятность в процентах, связанная с возможностью)
Показатель | обращение	Opportunity: Expected Amount (ожидаемая сумма, связанная с возможностью)
Параметр | сеанс ИЛИ пользователь	Opportunity: Order Number (номер заказа, связанный с возможностью)

Как выбрать область действия?

Выбор области действия ("сеанс" или "пользователь") для специальных параметров зависит от бизнес-модели вашей компании. Например, если вы продаете разные типы товаров и один пользователь может заполнить несколько форм для потенциальных клиентов, имеет создать специальный параметр на уровне сеанса, а не пользователя, поскольку параметр, заданный на уровне пользователя, будет перезаписываться при каждом заполнении формы.

 

Этот подход нужно использовать для полей Salesforce, перечисленных в примере выше, а также для всех специальных полей, которые вы хотите импортировать.

 

Также учтите, что значения специальных показателей агрегируются по мере того, как поступают новые обращения, связанные с определенным идентификатором пользователя.

Как включить импорт данных о товарах

Чтобы можно было включить импорт данных о товарах, должны выполняться оба следующих условия:

• В аккаунте Salesforce должны быть настроены данные о товарах.
• Хотя бы для одного представления в текущем ресурсе Google Аналитики должна быть включена расширенная электронная торговля.

Прежде чем включить импорт данных о товарах из Salesforce в Google Аналитику, убедитесь, что в аккаунте Salesforce правильно настроены данные о товарах. Для импорта этих данных нельзя задавать настройки. Если импорт работает неправильно, внимательно проверьте настройки данных о товарах в Salesforce.

Чтобы включить импорт данных о товарах, выполните следующие действия:

1. Нажмите Включить импорт данных о товарах под таблицей импорта атрибутов.
2. Вы сможете проверить связи между полями данных о товарах Salesforce и полями расширенной электронной торговли Google Аналитики.

Расписание источника данных

С помощью этого параметра можно указать, как часто должен выполняться импорт.

Ежечасный импорт позволяет получать наиболее точные и актуальные данные.

1. Нажмите Продолжить.
2. Нажмите Готово.

Проверка конфигурации

Теперь можно проверить правильность настроек. Для этого импортируйте данные и просмотрите их в отчете Google Аналитики.

Импорт данных

1. При необходимости вернитесь на страницу списка наборов данных, выполнив следующие действия:
   1. Войдите в аккаунт Google Аналитики.
   2. Нажмите Администратор в левой нижней части страницы и перейдите в ресурс, содержащий источник данных Salesforce Sales Cloud.
   3. В столбце Ресурс выберите Импорт данных.
   4. Появится страница со списком наборов данных.
2. Найдите набор данных, созданный ранее согласно инструкциям в этом руководстве.
3. Нажмите Управление загрузками в правой части страницы.
4. На странице Загрузки для офлайн-конверсий Salesforce нажмите Ещё > Получить.

Будет выполнена попытка импорта данных Salesforce в Google Аналитику. Если загрузка пройдут успешно, то в столбце "Статус" появится значение "Завершено". В противном случае будет указан статус "Ошибка" и появится ссылка на подробные сведения.

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

Просмотр импортированных данных о товарах

После импорта офлайн-обращений данные появятся в отчетах в течение 26 часов.

Как посмотреть импортированные данные в отчете

1. Откройте отчет Поведение > События > Лучшие события.
2. Выберите временной интервал, охватывающий загруженные данные.
3. Добавьте дополнительный параметр Ярлык события.

Если данные о контрольных точках из Salesforce импортированы, они должны появиться в отчете.

По значениям параметра Источник данных можно отличить импортированные обращения от стандартных обращений Google Аналитики. Для обращений, импортированных из Salesforce Sales Cloud, указывается значение sfsc.

Просмотр импортированных атрибутов

Чтобы добавить импортированные атрибуты в любой отчет Google Аналитики, добавьте в него специальные параметры, которые вы связали с полями Salesforce согласно приведенным выше инструкциям, в качестве дополнительных параметров.

Как посмотреть импортированные данные о товарах

Чтобы увидеть импортированные данные о товарах, откройте отчет Конверсии > Электронная торговля > Эффективность продаж или Конверсии > Электронная торговля > Эффективность товаров. Выберите период времени, за который нужно проверить импортированные данные. Например, если вы начали импорт сегодня, то диапазон дат в отчете должен включать сегодняшний день.

Данные о товарах импортируются через события "Возможность", связанные с контрольными точками. Может пройти некоторое время, прежде чем информация о потенциальном клиенте будет преобразована в информацию о возможности в аккаунте Salesforce.

Примечания и ограничения

• Соблюдайте Условия использования Google Аналитики и требования Политики конфиденциальности.
• Не импортируйте информацию, позволяющую идентифицировать личность.
• Если импортированные данные содержат денежные суммы, то они указываются в валюте, выбранной в аккаунте Salesforce (или в нескольких валютах, если в Salesforce включена поддержка нескольких валют).
• Данные о товарах из Salesforce импортируются в объект Opportunity, а не Lead.
• Из обращений Measurement Protocol в момент импорта удаляются пустые поля. Такие поля не импортируются в соответствующие специальные параметры и показатели.
• Размер обращения Measurement Protocol не может превышать 8192 байт (это стандартное ограничение Google Аналитики на размер обращений).
• В импортированных данных не должны содержаться запятые. Дело в том, что обращения Measurement Protocol с информацией о событиях импортируются как файл с разделителями-запятыми (CSV), поэтому запятые в импортируемых значениях будут интерпретироваться как разделители. Это может привести к непредсказуемым результатам.
• В расширенной электронной торговле действует ограничение на количество уникальных индексов товаров – не более 200.
• Агрегированные ресурсы поддерживаются в той же степени, что и обращения Measurement Protocol.