Google Cloud Pub/Sub Connector Setup Guide

Google Cloud Pub/Sub Connector Setup Guide

by akshata_yerdoor on ‎06-27-2017 04:45 PM - edited on ‎07-10-2018 12:45 PM by (1,351 Views)

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 Universal 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 URIshttps://my.tealiumiq.com/oauth/google/callback.html 

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

Google Cloud – API Credentials – Application Restrictions

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 UDH Attribute values to custom Pub/Sub message attributes. Enter the message attribute key in the To drop-down list.
  • Print Attribute Names
    If any UDH 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 UDH 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 UDH 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 UDH 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