Generic CDP integration
You can integrate with any customer data platform, or CDP, using the following endpoints designed for 3rd-party tools, rather than your own integration layer.
The following endpoints are available:
- Update customer profile
- Update audiences in multiple customer profiles
- Create audience
- Update audience
- Delete audience
See API Docs
These endpoints are for general use with any platform. If you use a partner listed in the Customer data platforms section, do not follow this tutorial. Instead, refer to a tutorial specific to your platform.
Authenticating
All these endpoints rely on Talon.One's 3rd-party API keys of type Customer Data Platform
.
To generate one:
- In your Talon.One Application, click Settings > Developer settings.
- Click Create API Key.
- For Do you want to use this API Key with a 3rd party service?, select Yes.
- From Platform, select Customer Data Platform.
- Select an expiration date, and click Create API Key.
- Copy the key for later use.
Use the key in the Authorization
header of each of the endpoints. For example:
Authorization: ApiKey-v1 dbc644d33aa74d582bd9479c59e16f970fe13bf3
Updating a customer profile
To update a customer profile and change the audiences it is part of, use the following endpoint:
https://integration.talon.one/cdp/customer_profile/{customerProfileId}
See API Docs
You can edit the default format of the coupon codes in the campaign's Settings section.
Updating audiences in multiple customer profiles
To update the specified audiences for the specified customer profiles, use the following endpoint:
https://integration.talon.one/cdp/customer_profile/audiences
See API Docs
Creating an audience
To create an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences
See API Docs
Updating an audience
To update an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences/{audienceId}
See API Docs
Deleting an audience
To delete an audience in Talon.One from a CDP, use the following endpoint:
https://integration.talon.one/cdp/audiences/{audienceId}
See API Docs