This article describes how to configure a webhook to send custom request actions using template variables for the Talon.One API.

In this article:

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:

  1. Configure Talon.One.
  2. 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

  1. Open the Talon.One Application in the Campaign Manager and click Settings > Developer settings.
  2. Click Create API Key.
    For more information, see Managing API Keys in the Talon.One documentation.
  3. For Do you want to use this API Key with a 3rd party service?, select Yes.
  4. Select Customer Data Platform from the dropdown.
  5. Enter an expiry date and click Create API Key.
  6. 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:

For example:

HTTPRequestRequiredPs.png

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 to ID
    • Map tealium_firstparty_visitor_id to Cookieidvalue
    • Map Last event timestamp to time
  • Templates:
    • Name: data
Public