Talon.One Webhook Connector Setup Guide
This article describes how to configure a webhook to send custom request actions using template variables for the Talon.One API.
Overview
Talon.One is a powerful promotion engine that enables you to create targeted and customized marketing promotions built around your visitor and session data. Create, manage, and track discounts, coupon codes, referral, loyalty, and product bundles all in one holistic platform.
The Talon.One integration allows you to stream visitor data (standardized, unified, and enriched) in real-time from Tealium to Talon.One to create personalized promotions in your marketing campaigns.
Prerequisites
- Set up Talon.One Promotions Platform
- Set up Tealium EventStream API Hub or Tealium AudienceStream CDP
How it works
The Tealium for Talon.One outgoing webhook enables integrations with Talon.One’s powerful promotion engine. You can use Tealium’s robust real-time data collection to send more relevant personalized data to Talon.One to identify and target individual customers with highly relevant campaigns.
To get started, do the following:
- Configure Talon.One
- In Tealium, configure a webhook to send data to Talon.One.
You can now submit HTTP requests to send first-party personalized data (event data from Tealium EventStream API Hub) or user data (from Tealium AudienceStream CDP) to Talon.One. Talon.One supports webhook configurations that use basic authentication. For more information, see the Webhook Connector Setup Guide.
Configure Talon.One
- Open the Talon.One Application in the Campaign Manager and click Settings > Developer settings.
- Click Create API Key.
For more information, see Managing API Keys in the Talon.One documentation. - For Do you want to use this API Key with a 3rd party service?, select Yes.
- Select Customer Data Platform from the dropdown.
- Enter an expiry date and click Create API Key.
- Copy the API Key, which will be used to configure a webhook in Tealium.
For more information on setting up this integration, see the Talon.One documentation.
Configure an Outgoing Webhook for Talon.One
The following data mappings are required for the webhook:
- Set Method to
POST
. - Set URL to
https://integration.talon.one/cdp/audiences
For example:
To send data to Talon.One, you also need to configure mappings for the following:
Body Data
Body Content Type
- The variables you want to send to Talon.One.
Example Webhook Configuration
In this example, the request body is a JSON message with a customizable body template. For more information on configuring a webhook connector, see the Webhook Template Variables Guide.
This example webhook sends a PageView
request with parameters to identify the user, as follows:
-
Method:
POST
-
URL:
Https://integration.talon.one/cdp/audiences
-
Body Content Type:
application/json
-
Body Data:
Map {{data}} To Body
-
Template Variables:
- Map “PageView” to
Intent
- Map
customer_id
toID
- Map
tealium_firstparty_visitor_id
toCookieidvalue
- Map
Last event timestamp
totime
- Map “PageView” to
-
Templates:
- Name:
data
- Name:
This page was last updated: October 4, 2022