Google Cloud Function Destination

Google Cloud Function quick info

Google Cloud Function is in beta, and accepts Page, Alias, Group, Identify, and Track calls. If you reference it in the Integrations object, call it “Google Cloud Function”.

Google Cloud Function accepts cloud-mode data from all Segment source types. It does not offer device-mode connections.

Segment makes it easy to send your data to Google Cloud Function (and lots of other destinations). Once you collect your data using Segment’s open source libraries, Segment translates and routes your data to Google Cloud Function in a format it can use.

Google Cloud Function is a lightweight compute solution for developers to create single-purpose, stand-alone functions that respond to Cloud events without the need to manage a server or runtime environment.

This document is about a destination which is in beta

This means that the Google Cloud Function Destination is in active development, and some functionality may change before it becomes generally available.

Getting Started

Before you start, make sure Google Cloud Function supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.

Web Mobile Server
📱 Device-mode ⬜️ ⬜️ ⬜️
☁️ Cloud-mode

Build a Google Cloud Function to Process Segment Events

Before you can process events from Segment, you must provide a Google Cloud Function that can handle your incoming events.

  1. Go to
  2. Click VIEW CONSOLE.

  3. Select a project.
  5. Enter a name for your function, and choose how much memory the function can use.
  6. In the Trigger field, select HTTP. Save the URL GCP gives you. You’ll use this to configure the Segment destination later.
  7. Choose how you’ll provide the function’s code (in the Source code field) and what language the code is written in (in the Runtime field).
  8. Enter the name of the function as you defined it in your code, in the Function to execute field.
  9. Click Create to save your settings and create the Google Cloud Function.

Configure the Google Cloud Function Destination

Once you create the Google Cloud Function, you can set up a Segment destination that calls the function.

  1. Log in to the Segment app and select the workspace you want to work in.
  2. Click Catalog and search for Google Cloud Function.
  3. Click Configure Google Cloud Function.
  4. Enter the destination settings for this GCF destination.
Setting Description
HTTP Trigger The URL given under the Trigger section when you created the Google Cloud Function.
API Key (optional) A string to identify that a request is coming from Segment, if required by the function.

The API key is injected in the Authorization header as a basic authorization header without password.


You can send computed traits and audiences generated using Segment Personas to this destination as a user property. To learn more about Personas, contact us for a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Personas sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Personas sets that value to false.

When you first create an audience, Personas sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
string. The api key used to identify request performed by Segment.
HTTP Trigger
string. The URL to call the Google Cloud Function.

This page was last modified: 08 Mar 2021

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account