Google Cloud Pub/Sub Connector Setup Guide

[#1]

The Google Cloud Pub/Sub Connector provides secure and asynchronous messaging capability between independently-written applications, allowing developers to integrate systems hosted on the Google Cloud platform with external systems. This article describes how to set up the Connector in the Customer Data Hub.

Table of Contents Placeholder

Connector Requirements

• Google Cloud Platform Project Id
• Client ID
• Client Secret

Supported Actions

Action Name	Trigger on Audience	Trigger on Streams
Publish Event Data Message	✗	✓
Publish Visitor Data Message	✓	✗
Publish Message	✓	✓

Google Cloud – Web Application Credentials

For this connector to work correctly, an update to the Google Cloud web application Restrictions settings needs to be made to whitelist Tealium servers and provide the required callback upon successful connection.

In the Google Cloud console, edit the Restrictions under your Client Credentials to the following values

Authorized JavaScript origins: https://my.tealiumiq.com

Authorized redirect URIs: https://my.tealiumiq.com/oauth/google/callback.html 

The following image shows the Restriction settings with the required fields highlighted:

Configure Settings

Go to the Connector Marketplace and add a new Google Cloud Pub/Sub Connector. Read the Connector Overview article for general instructions on how to add a Connector.

Use the following steps to configure your vendor:

1. From the Configure tab, provide a title for the connector instance.
2. Enter the Google Cloud Platform Project Id.
3. Enter the Client ID (OAuth 2.0 Web Application Client ID with access to Pub/Sub API).
4. Enter the Client Secret (OAuth 2.0 Web Application Client Secret).
5. Provide additional notes about your implementation.
6. Click Establish Connection.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. From here, you will set up Actions and trigger them.

The following sections describe how to set up Parameters and Options for each Action.

Action - Publish Event Data Message

Parameters

• Project Topic (REQUIRED)
  Select the topic in your Pub/Sub project to publish the message to.
• Message Attributes (OPTIONAL)
  Map your Customer Data Hub Attribute values to custom Pub/Sub message attributes. Enter the message attribute key in the To drop-down list.
• Print Attribute Names
  If any Customer Data Hub Attribute name gets updated, checking this box will automatically reflect the updated name in the published message.

Action - Publish Visitor Data Message

Parameters

• Project Topic (REQUIRED)
  Select the topic in Pub/Sub project to publish the message to.
• Message Attributes (OPTIONAL)
  Map your Customer Data Hub Attribute values to custom Pub/Sub message attributes. Enter the message attribute key in the To drop-down list.
• Include Current Visit Data
  Checking this box will include both visitor data and current visit data in the published message.
• Print Attribute Names
  If any Customer Data Hub Attribute name gets updated, checking this box will automatically reflect the updated name in the published message.

Action - Publish Message

Parameters

• Project Topic (REQUIRED)
  Select the topic in Pub/Sub project to publish the message to.
• Message Attributes (OPTIONAL)
  Map your Customer Data Hub Attribute values to custom Pub/Sub message attributes. Enter the message attribute key in the To drop-down list.
• Publish Message Data (REQUIRED)
  Provide data to construct the message body. Use custom name values to create a message that is a list of key value pairs.
• Publish Message Template Variables
  Map Attribute(s) to template variable names. Template variables are available for substitution and rendering of all templates. Refer to our Template Variables Guide for details.
• Publish Message Templates
  Provide one or more templates to render. Typically, a single template is used to construct a message data. Refer to our Templates Guide for common syntax and extensions.

Options - Publish Message Data

Option	Description
Custom Message Definition	The raw message body or template name of a template defined under Publish Message Templates

Vendor Documentation

• Quickstarts
• Setting Up Authentication for Server to Server Production Applications
• Topics and Messages