文档Experience Platform源连接器指南

[Beta 版]{class="badge informative"}

Talon.One

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
AVAILABILITY
Talon.One源处于Beta版。 有关使用测试版标记源的更多信息，请阅读源概述中的条款和条件。

通过Talon.One，您可以轻松创建、管理和优化针对客户的个性化营销活动。 使用这个强大的平台运行折扣、分发优惠券、启动反向链接计划、设置忠诚度计划并提供游戏化激励 — 所有这些都通过一个可扩展的系统来帮助您吸引和奖励您的受众。

您可以使用Adobe Experience Platform源目录中的Talon.One源从Talon.One帐户中摄取批次和流式会员数据。

TIP
忠诚度数据是指最终用户的忠诚度计划信息，如忠诚度积分、花费的忠诚度积分、当前级别、授予的优惠券、推荐和成就。

先决条件 prerequisites

为以下凭据提供值以验证和连接Talon.One Batch Source Connector。

凭据
描述
示例
域
与您的Talon.One应用程序环境关联的唯一URL。 确保输入域时不包含协议或路径。
acmetalonone.us-east4
Talon.One管理API密钥

管理API密钥是用于验证和授权访问Talon.One的管理API的凭据。 这将处理如下操作：

  • 正在导入优惠券
  • 检索营销活动数据
  • 管理应用程序和端点
ManagementKey-v1 {YOUR_MANAGEMENT_KEY}

映射 mapping

为了帮助您根据每个效果对象的唯一effectType值来映射该对象，您可以使用数据准备array_to_map函数。 这允许您轻松地将无序效果数组转换为符合要求的键值对。 有关指导，请参阅以下示例。

您还可以使用Adobe提供的标准化忠诚度字段组，以一致的方式对您的忠诚度计划概念进行建模。

忠诚度详细信息

这是XDM Individual Profile的标准XDM字段组，用于通过捕获人员的记录属性而不是事件数据来描述他们的忠诚度会员资格状态。 在您的配置文件架构中使用此字段组捕获：

  • 成员​在计划中(loyaltyID， program， status， tier)

  • 他们的​当前和生命周期余额 （points、lifetimePoints、expiredPoints等）

  • 密钥​成员资格日期 (joinDate，upgradeDate，tierExpiryDate)

忠诚度事件详细信息

“忠诚度事件详细信息”字段组旨在捕获事件级别的忠诚度活动，如在特定交易中挣得或兑换的积分。 此字段组包括xdm:points、xdm:pointsRedeemed、xdm:pointsAsOfDate和xdm:program等字段。 在体验事件架构中使用此事件级别字段组来捕获：

  • 每个事件的移动​点（已获得、已兑换、已过期）

  • 由忠诚度优惠券或推荐带来的​折扣

  • 计划ID​和交易ID，用于与忠诚度提供商进行协调。

来源
目标
array_to_map(data.effects, "effectType").addLoyaltyPoints.campaignId
_{TENANT_ID}.loyalty.pointsGained[0].promotionId
array_to_map(data.effects, "effectType").addLoyaltyPoints.props.value
_{TENANT_ID}.loyalty.pointsGained[0].value
array_to_map(data.effects, "effectType").deductLoyaltyPoints.campaignId
_{TENANT_ID}.loyalty.pointsRedemption[0].promotionId
array_to_map(data.effects, "effectType").acceptCoupon.campaignId
_{TENANT_ID}.loyalty.couponRedemption[0].campaignId
array_to_map(data.effects, "effectType").deductLoyaltyPoints.props.value
_{TENANT_ID}.loyalty.pointsRedemption[0].value
array_to_map(data.effects, "effectType").acceptCoupon.props.value
_{TENANT_ID}.loyalty.couponRedemption[0].id
array_to_map(data.effects, "effectType").setDiscount.campaignId
_{TENANT_ID}.loyalty.discounts[0].promotionId
array_to_map(data.effects, "effectType").setDiscount.props.value
_{TENANT_ID}.loyalty.discounts[0].value
data.created
timestamp
data.attributes.params.profileId
personID
data.attributes.integrationId
_id
data.attributes.params.cartItems[*].name
productListItems[*].name
data.attributes.params.cartItems[*].category
productListItems[*].productCategories[0].categoryID
data.attributes.params.cartItems[*].sku
productListItems[*].SKU

后续步骤

请阅读以下文档，了解如何将Talon.One帐户连接到Experience Platform并摄取批次和流式处理忠诚度数据。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089