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:
- From the Configure tab, provide a title for the connector instance.
- Enter the Google Cloud Platform Project Id.
- Enter the Client ID (OAuth 2.0 Web Application Client ID with access to Pub/Sub API).
- Enter the Client Secret (OAuth 2.0 Web Application Client Secret).
- Provide additional notes about your implementation.
- 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