Как подключить сервисный аккаунт Google к stape

С помощью сервисного аккаунта Google, подключенного к stape, вы интегрируете серверный Google Tag Manager с BigQuery и Firestore. В этой статье блога будет показано, как создать сервисный аккаунт Google и подключить его к контейнеру stape.

Что такое сервисный аккаунт Google и какие возможности он открывает для sGTM?

Сервисные аккаунты Google могут использоваться приложениями для осуществления авторизованных вызовов API. С помощью сервисного аккаунта Google, подключенного к контейнеру sGTM, можно интегрировать BigQuery и Firestore с серверным GTM.

Для создания сервисного аккаунта Google необходимо иметь учетную запись Google Cloud Platform и сгенерировать ключ доступа. JSON-файл ключа учетной записи сервиса должен быть добавлен к power-up (функции) контейнера sGTM в app.stape.io для аутентификации в этих сервисах.

Firestore - это база данных, которая может записывать/читать или синхронизировать данные. Ее можно использовать для обогащения данных, отправленных с помощью тегов на стороне сервера. Например, с помощью идентификатора пользователя можно извлечь дополнительные данные пользователя из Firestore и отправить больше параметров пользователя в Facebook CAPI, что повысит оценку качества совпадения событий FB.

Чтобы упростить интеграцию, Google выпустил переменную Firestore Lookup. С помощью этой переменной вы можете извлекать определенные значения из документа Firestore. Единственным недостатком является то, что Firestore не является бесплатным сервисом - узнать цену можно здесь.

Используя серверный Google Tag Manager, можно записывать данные непосредственно в BigQuery из sGTM Tag или Client. Ранее интеграция с BigQuery была доступна только для пользователей 360. С выходом sGTM и GA4 все пользователи могут отправлять данные в BigQuery бесплатно или дешевле, чем раньше. BigQuery также не является бесплатным - ознакомиться с его ценами можно здесь.

Как подключить сервисный аккаунт Google к stape?

1. Создайте или войдите в веб-консоль Google Cloud Platform.

2. Выберите IAM & Admin -> Service Accounts -> Нажмите Create service account.

3. Добавьте аккаунт -> Нажмите Далее -> Выберите роль Roles BigQuery Data Editor для доступа к BigQuery или роль Cloud Datastore User для Firestore.

Если вы хотите использовать Google Service Account только для BigQuery, выберите только роль BigQuery Data Editor. То же самое для Firestore.

Когда вы дойдете до 3-го шага, просто нажмите кнопку Готово.

4. Создайте закрытый ключ -> Выберите JSON -> выберите Создать -> JSON будет загружен на ваш компьютер. 

5. Откройте свой аккаунт stape.io -> откройте контейнер sGTM -> откройте вкладку Power-ups -> Нажмите на Google Service account -> Загрузите файл JSON, который вы скачали из Google Cloud -> Нажмите Сохранить.