[Beta]{class="badge informative"}
Talon.One
With Talon.One, you can easily create, manage, and optimize personalized marketing campaigns tailored to your customers. Use this powerful platform to run discounts, distribute coupons, launch referral programs, set up loyalty programs, and offer gamified incentives—all from one scalable system designed to help you engage and reward your audience.
You can use the Talon.One sources in the Adobe Experience Platform sources catalog to ingest both batch and streaming loyalty data from your Talon.One account.
Prerequisites prerequisites
Provide values for the following credentials to authenticate and connect the Talon.One Batch Source Connector.
acmetalonone.us-east4The Management API Key is a credential used to authenticate and authorize access to Talon.One’s Management API. This handles operations such as:
- Importing coupons
- Retrieving campaign data
- Managing applications and endpoints
ManagementKey-v1 {YOUR_MANAGEMENT_KEY}Mapping mapping
To help you map each effect object based on its unique effectType value, you can use the data prep array_to_map function. This allows you to easily convert an unordered array of effects into key-value pairs that match your requirements. See the example below for guidance.
You can also use the standardized loyalty field groups that Adobe provides to model your loyalty-program concepts in a consistent way.
This is a standard XDM field group for XDM Individual Profile, used to describe the loyalty membership status of a person by capturing their record attributes, rather than event data. Use this field group in your Profile schemas to capture:
-
Who the member is in the program (
loyaltyID,program,status,tier) -
Their current & lifetime balances (
points,lifetimePoints,expiredPoints, etc.) -
Key membership dates (
joinDate,upgradeDate,tierExpiryDate)
The Loyalty Event Details field group is designed to capture loyalty activity at the event level, such as points earned or redeemed in a specific transaction. This field group includes fields like xdm:points, xdm:pointsRedeemed, xdm:pointsAsOfDate, and xdm:program. Use this event-level field group in your Experience Event schemas to capture:
-
Per‑event movements in points (gained, redeemed, expired)
-
Discounts that were driven by loyalty coupons or referrals
-
Program IDs and transaction IDs for reconciliation with the loyalty provider.
array_to_map(data.effects, "effectType").addLoyaltyPoints.campaignId_{TENANT_ID}.loyalty.pointsGained[0].promotionIdarray_to_map(data.effects, "effectType").addLoyaltyPoints.props.value_{TENANT_ID}.loyalty.pointsGained[0].valuearray_to_map(data.effects, "effectType").deductLoyaltyPoints.campaignId_{TENANT_ID}.loyalty.pointsRedemption[0].promotionIdarray_to_map(data.effects, "effectType").acceptCoupon.campaignId_{TENANT_ID}.loyalty.couponRedemption[0].campaignIdarray_to_map(data.effects, "effectType").deductLoyaltyPoints.props.value_{TENANT_ID}.loyalty.pointsRedemption[0].valuearray_to_map(data.effects, "effectType").acceptCoupon.props.value_{TENANT_ID}.loyalty.couponRedemption[0].idarray_to_map(data.effects, "effectType").setDiscount.campaignId_{TENANT_ID}.loyalty.discounts[0].promotionIdarray_to_map(data.effects, "effectType").setDiscount.props.value_{TENANT_ID}.loyalty.discounts[0].valuedata.createdtimestampdata.attributes.params.profileIdpersonIDdata.attributes.integrationId_iddata.attributes.params.cartItems[*].nameproductListItems[*].namedata.attributes.params.cartItems[*].categoryproductListItems[*].productCategories[0].categoryIDdata.attributes.params.cartItems[*].skuproductListItems[*].SKUNext steps
Read the following documentation to learn how you can connect your Talon.One account to Experience Platform and ingest both batch and streaming loyalty data.