Signature统一数据实施指南

© 2023 YourCompanyName Ltd. All Rights Reserved.

Signature统一数据实施指南

Avatar
Agathe - Technical Writer
最后编辑：

版本 2.4.4 – 2023年10月

简介

Signature统一数据为使用我们u1 Signature匹配功能的推广者提供交易和付款数据。使用此数据来匹配您的Signature数据与付款信息。要接收这些报告，您必须拥有一个FTP或通过SSH的SFTP服务器，并启用接收Signature统一数据，如这些实施指南中所述。

报告类型

Signature统一数据中包含四种以XML格式发送的报告：每日u1交易报告、两个月度报告和付款报告；点击+以获取特定报告的更多信息：

每日u1交易报告
每日发送，此报告提供所有u1交易的详细交易级报告，这些交易已匹配或确认来自前一天。任何未确认或未匹配的交易将随下一个文件发送。在每月的第四天，报告还包括上个月所有未匹配的交易数据。

 注意

如果此列表中的未匹配交易在我们将其作为未匹配发送后被确认，则相同的交易ID将再次发送。

月度报告

每月发送两份报告：月度u1报告在每月第四天发送，Dailyu1_Monthly在每月第五天发送。这些报告是相同的，包含上个月处理的u1交易。它们显示该月的所有最终数据，并可用于在缺少每日u1报告的情况下对数据进行核对。

推广者付款声明中的调整未反映在这些报告中，但在付款报告中反映。

付款报告
此报告每日发送，包含前一天发出的付款的订单和SKU详细信息。如果一天内没有发出付款，报告仍将发送，但不包含数据。通过其交易级详细信息，广告主付款可以轻松与u1数据核对。如果您无法使用此文件，请每天使用高级报告API提取发出的付款ID、广告主支付的发票号以及每个发票的订单级详细信息。

每日u1交易报告

点击+以获取每日u1交易报告不同方面的更多信息：

文件名

每日u1交易报告的文件名包括您的网站 ID和文件生成的GMT时间。

例如：2574052_Dailyu1_20XXJune01-1649.xml，如果2574052是网站 ID，16:49是时间。

顶级数据结构

主要标签是<XROOT>和</XROOT>。

下一个嵌套标签是<PRJ_LOYALTY_METADATA_HDR>和</PRJ_LOYALTY_METADATA_HDR>。

 注意

关闭标签直接出现在文件底部的</XROOT>上方。

元数据

这是元数据的示例：

<FILENAME>2574052_Dailyu1_20XXJune01-1645.xml</FILENAME>
<SID>2574052</SID>
<START_DATE>20XX-05-31</START_DATE>
<END_DATE>20XX-06-01</END_DATE>
<REPORT_TYPE>u1会员每日数据</REPORT_TYPE>

标签是<FILENAME>、<SID>、<START_DATE>、<END_DATE>和<REPORT_TYPE>。

交易数据

此文件中只有一种记录类型，u1每日数据。其标签是<PRJ_LOYALTY_u1_DAILY>和</PRJ_LOYALTY_u1_DAILY>。每个交易都有一条记录。

这是每日数据记录的示例：

<MEMBER_ID>u1_here</MEMBER_ID>
<MATCH_DATE>20XX-May-31</MATCH_DATE>
<MATCH_TIME>1730</MATCH_TIME>
<MERCHANT_PARTNER_ID>33</MERCHANT_PARTNER_ID>
<MERCHANT_PARTNER_NAME>乐天联盟网络商家</MERCHANT_PARTNER_NAME>
<PRODUCT_SKU_NUMBER>1</PRODUCT_SKU_NUMBER>
<PRODUCT_NAME>耳机</PRODUCT_NAME>
<TRANSACTION_ID>123</TRANSACTION_ID>
<ORDER_ID>21</ORDER_ID>
<TRANSACTION_DATE>20XX-May-30</TRANSACTION_DATE>
<TRANSACTION_TIME>1807</TRANSACTION_TIME>
<SALES_AMOUNT>99.95</SALES_AMOUNT>
<QUANTITY>1</QUANTITY>
<BASELINE_COMMISSION>10</BASELINE_COMMISSION>
<ADJUSTED_COMMISSION>0</ADJUSTED_COMMISSION>
<TOTAL_COMMISSION>10</TOTAL_COMMISSION>
<PROCESS_DUE_DATE>20XX-May-31</PROCESS_DUE_DATE>
<PROCESS_DUE_TIME>1701</PROCESS_DUE_TIME>

标签是：<MEMBER_ID>、<MATCH_DATE>、<MATCH_TIME>、<MERCHANT_PARTNER_ID>、<MERCHANT_PARTNER_NAME>、<PRODUCT_SKU_NUMBER>、<PRODUCT_NAME>、<TRANSACTION_ID>、<ORDER_ID>、<TRANSACTION_DATE>、<TRANSACTION_TIME>、<SALES_AMOUNT>、<QUANTITY>、<BASELINE_COMMISSION>、<ADJUSTED_COMMISSION>、<TOTAL_COMMISSION>、<PROCESS_DUE_DATE>和<PROCESS_DUE_TIME>。

请查阅附录A以获取这些标签的定义。

月度u1报告

点击+以获取月度u1报告不同方面的更多信息：

文件名

第一个月度报告，Monthlyu1 Report，于每月的第四天发送。其文件名包含您的网站 ID 和文件生成的 GMT 时间。

例如：2574052_Monthlyu1_20XXJune04-1645.xml，其中 2574052 是网站 ID，16:45 是时间。

顶级数据结构

主要标签是 <XROOT> 和 </XROOT>。

下一个嵌套标签是 <PRJ_LOYALTY_METADATA_HDR> 和 </PRJ_LOYALTY_METADATA_HDR>。请注意，关闭标签直接位于文件底部的 </XROOT> 之上。

元数据

这是元数据的示例：

<FILENAME>2574052_Monthlyu1_20XXJune04-1645.xml</FILENAME> 
<SID>2574052</SID> 
<START_DATE>20XX-05-01</START_DATE> 
<END_DATE>2011-05-31</END_DATE> 
<REPORT_TYPE>u1 会员月度提要</REPORT_TYPE>

标签是 <FILENAME>、<SID>、<START_DATE>、<END_DATE> 和 <REPORT_TYPE>。

交易数据

此文件中只有一种记录类型：月度调整佣金数据。它由标签 <PRJ_LOYALTY_u1_DAILY> 和 </PRJ_LOYALTY_u1_DAILY> 标识。

这是一个月度数据记录的示例：

<TRANSACTION_ID>E31DACCA3234ECC27253A14FB5C59F38</TRANSACTION_ID> 
<ADJUSTED_COMMISSION>5</ADJUSTED_COMMISSION> 
<TOTAL_COMMISSION>50</TOTAL_COMMISSION>

标签是 <TRANSACTION_ID>、<ADJUSTED_COMMISSION> 和 <TOTAL_COMMISSION>。

请查阅 附录 A 以了解这些标签的定义。

交易 ID 可以与每日 u1 报告匹配以识别交易。

Dailyu1_月度报告

点击 + 以获取有关 Dailyu1_月度报告不同方面的更多信息：

文件名

Dailyu1_月度报告于每月的第五天发送。其文件名包含您的网站 ID 和文件生成的 GMT 时间。

例如：2574052_Dailyu1_Monthly_20XXJune05-1649.xml，其中 2574052 是网站 ID，16:49 是时间。

顶级数据结构
主要标签是 <XROOT> 和 </XROOT>。下一个嵌套标签是 <PRJ_LOYALTY_METADATA_HDR> 和 </PRJ_LOYALTY_METADATA_HDR>。

 注意

关闭标签直接位于文件底部的 </XROOT> 之上。

元数据
这是元数据的示例： 
<FILENAME>2574052_Dailyu1_Monthly_20XXJune01-1645.xml</FILENAME> 
<SID>2574052</SID> 
<START_DATE>20XX-05-01</START_DATE> 
<END_DATE>20XX-05-31</END_DATE> 
<REPORT_TYPE>u1 会员月度提要</REPORT_TYPE>

标签是 <FILENAME>、<SID>、<START_DATE>、<END_DATE> 和 <REPORT_TYPE>。

月度 u1 数据

此文件中只有一种记录类型：月度 u1 数据。它由标签 <PRJ_LOYALTY_u1_DAILY> 和 </PRJ_LOYALTY_u1_DAILY> 标识。

每个交易都有一条记录。

这是一个月度记录的示例：

<MEMBER_ID>u1_here</MEMBER_ID> 
<MATCH_DATE>20XX-May-31</MATCH_DATE> 
<MATCH_TIME>1730</MATCH_TIME> 
<MERCHANT_PARTNER_ID>33</MERCHANT_PARTNER_ID> 
<MERCHANT_PARTNER_NAME>乐天联盟网络商家</MERCHANT_PARTNER_NAME> 
<PRODUCT_SKU_NUMBER>1</PRODUCT_SKU_NUMBER> 
<PRODUCT_NAME>耳机</PRODUCT_NAME> 
<TRANSACTION_ID>123</TRANSACTION_ID> 
<ORDER_ID>21</ORDER_ID> 
<TRANSACTION_DATE>20XX-May-30</TRANSACTION_DATE> 
<TRANSACTION_TIME>1807</TRANSACTION_TIME> 
<SALES_AMOUNT>99.95</SALES_AMOUNT> 
<QUANTITY>1</QUANTITY> 
<BASELINE_COMMISSION>10</BASELINE_COMMISSION> 
<ADJUSTED_COMMISSION>0</ADJUSTED_COMMISSION> 
<TOTAL_COMMISSION>10</TOTAL_COMMISSION> 
<PROCESS_DUE_DATE>20XX-May-31</PROCESS_DUE_DATE> 
<PROCESS_DUE_TIME>1701</PROCESS_DUE_TIME>

这里的标签是：<MEMBER_ID>、<MATCH_DATE>、<MATCH_TIME>、<MERCHANT_PARTNER_ID>、<MERCHANT_PARTNER_NAME>、<PRODUCT_SKU_NUMBER>、<PRODUCT_NAME>、<TRANSACTION_ID>、<ORDER_ID>、<TRANSACTION_DATE>、<TRANSACTION_TIME>、<SALES_AMOUNT>、<QUANTITY>、<BASELINE_COMMISSION>、<ADJUSTED_COMMISSION>、<TOTAL_COMMISSION>、<PROCESS_DUE_DATE> 和 <PROCESS_DUE_TIME>。

请查阅 附录 A 以了解这些标签的定义。

未匹配的月度 u1 交易

此文件包括当月匹配会员 ID 的交易。文件还包括上个月未匹配的交易。这些交易的会员 ID 和匹配日期的值为 null。

付款报告

点击 + 以获取有关付款报告不同方面的更多信息：

文件名

付款对账报告文件名包括您的网站 ID 和文件生成的 GMT 时间。

例如： 2574052_Payment_20XXMay31-1645.xml，其中 2574052 是网站 ID，16:45 是时间。

顶级数据结构

主要标签是 <PRJ_LOYALTY_METADATA_HDR> 和 </PRJ_LOYALTY_METADATA_HDR>。

元数据

这是元数据的一个示例：

<FILENAME>2574052_Payment_20XXMay31-1645.xml</FILENAME> 
<SID>2574052</SID> 
<START_DATE>20XX-05-30</START_DATE> 
<END_DATE>20XX-05-31</END_DATE> 
<REPORT_TYPE>Payment Feed</REPORT_TYPE>

标签是 <FILENAME>、<SID>、<START_DATE>、<END_DATE> 和 <REPORT_TYPE>。

付款摘要

在元数据标签内和元数据之后，数据的顶级是付款摘要。其标签是 <PRJ_LOYALTY_PAYMENT_SUMMARY> 和 </PRJ_LOYALTY_PAYMENT_SUMMARY>。每笔付款有一个付款摘要。它包括数据和一系列付款详情。

这是付款摘要数据的一个示例：

<PAYMENT_ISSUE_DATE>20XXMay31-1120</PAYMENT_ISSUE_DATE> 
<CHECK_ACH_NUMBER>12345</CHECK_ACH_NUMBER> 
<LS_PAYMENT_ID>67890</LS_PAYMENT_ID> 
<PAYMENT_TYPE>Domestic Check</PAYMENT_TYPE> 
<PAYMENT_CURRENCY>Dollar</PAYMENT_CURRENCY> 
<PAY_AMOUNT>10000.00</PAY_AMOUNT>

标签是 <PAYMENT_ISSUE_DATE>、<CHECK_ACH_NUMBER>、<LS_PAYMENT_ID>、<PAYMENT_TYPE>、<PAYMENT_CURRENCY> 和 <PAY_AMOUNT>。

请查阅附录 B以了解这些标签的定义。

付款详情

如上所述，付款摘要除了这些数据外还包括一系列付款详情。

付款详情的标签是 <PRJ_LOYALTY_PAYMENT_DTL> 和 </PRJ_LOYALTY_PAYMENT_DTL>。每张发票有一个付款详情。

记录包括有关付款的数据和一系列交易详情。有关付款的数据格式如下：

<PARTNER_NAME>Rakuten Affiliate Network Merchant</PARTNER_NAME> 
<PARTNER_ID>32</PARTNER_ID> 
<INVOICE_NUMBER>25243</INVOICE_NUMBER> 
<INVOICE_PERIOD_START_DATE>20XXMay01-0000</INVOICE_PERIOD_START_DATE> 
<INVOICE_PERIOD_END_DATE>20XXMay31-0000</INVOICE_PERIOD_END_DATE> 
<COMMISSION_AMT_EARNED>100.00</COMMISSION_AMT_EARNED> 
<FORWARD_BALANCE_AMT>0</FORWARD_BALANCE_AMT> 
<ADJUSTMENT_BONUS_AMT>0</ADJUSTMENT_BONUS_AMT> 
<HOLD_AMT>0</HOLD_AMT> 
<PAYMENT_AMT>100.00</PAYMENT_AMT>

标签是 <PARTNER_NAME>、<PARTNER_ID>、<INVOICE_NUMBER>、<INVOICE_PERIOD_START_DATE>、<INVOICE_PERIOD_END_DATE>、<COMMISSION_AMT_EARNED>、<FORWARD_BALANCE_AMT>、<ADJUSTMENT_BONUS_AMT>、<HOLD_AMT> 和 <PAYMENT_AMT>。

请查阅附录 B以了解这些标签的定义。

交易详情

如上所述，每个付款详情包括一系列交易详情。每张发票所涵盖的每笔交易都有一个交易详情。交易详情的标签是 <PRJ_LOYALTY_TRANSACTION_DTL> 和 </PRJ_LOYALTY_TRANSACTION_DTL>。

每个交易详情都有一个记录。以下是一个交易详情示例：

<MEMBER_ID>u1_here</MEMBER_ID> 
<MATCH_DATE>20XX-May-31</MATCH_DATE> 
<MATCH_TIME>1730</MATCH_TIME> 
<MERCHANT_PARTNER_ID>33</MERCHANT_PARTNER_ID> 
<MERCHANT_PARTNER_NAME>Rakuten Affiliate Network merchant</MERCHANT_PARTNER_NAME> 
<PRODUCT_SKU_NUMBER>1</PRODUCT_SKU_NUMBER> 
<PRODUCT_NAME>HEADPHONES</PRODUCT_NAME> 
<TRANSACTION_ID>123</TRANSACTION_ID> 
<ORDER_ID>21</ORDER_ID> 
<TRANSACTION_DATE>20XX-May-30</TRANSACTION_DATE> 
<TRANSACTION_TIME>1807</TRANSACTION_TIME> 
<SALES_AMOUNT>99.95</SALES_AMOUNT> 
<QUANTITY>1</QUANTITY> 
<BASELINE_COMMISSION>10</BASELINE_COMMISSION> 
<ADJUSTED_COMMISSION>0</ADJUSTED_COMMISSION> 
<TOTAL_COMMISSION>10</TOTAL_COMMISSION> 
<PROCESS_DUE_DATE>20XX-May-31</PROCESS_DUE_DATE> 
<PROCESS_DUE_TIME>1701</PROCESS_DUE_TIME>

标签是：<MEMBER_ID>、<MATCH_DATE>、<MATCH_TIME>、<MERCHANT_PARTNER_ID>、<MERCHANT_PARTNER_NAME>、<PRODUCT_SKU_NUMBER>、<PRODUCT_NAME>、<TRANSACTION_ID>、<ORDER_ID>、<TRANSACTION_DATE>、<TRANSACTION_TIME>、<SALES_AMOUNT>、<QUANTITY>、<BASELINE_COMMISSION>、<ADJUSTED_COMMISSION>、<TOTAL_COMMISSION>、<PROCESS_DUE_DATE> 和 <PROCESS_DUE_TIME>。

请查阅附录 A以了解这些标签的定义。

启用流程

联系客户支持以请求启用 Signature统一数据。客户支持可能会要求您验证该数据与您的业务模型的相关性。

在您请求启用后，客户支持团队将更新您的帐户设置，以便您在报告界面上的新表单中添加您的 FTP/SFTP 服务器凭据。有关添加凭据的说明，请参阅自我管理 Signature统一数据。

自我管理Signature统一数据

一旦客户支持完成您的初始请求，您将在报告界面的右侧看到一个管理Signature统一数据按钮：

报告界面中突出显示的管理Signature统一数据。

点击按钮以打开数据管理模式：

Signature统一数据的FTP设置。

此模式有两个主要部分：

  • 状态：选择启用或禁用Signature统一数据的传送。如果您禁用传送，您将从次日起停止接收数据，直到您再次选择启用传送。
  • 协议：选择一个传送协议并设置传送信息，以便我们发送您的数据。您可以选择FTP、SFTP和SSH传送方法，并且必须提供以下信息以完成启用：
    • FTP位置
    • 端口
    • 用户名
    • FTP和SFTP的密码；SSH的私钥。

我们建议您在保存配置之前测试上传。一个名为test.txt的1KB文件将被发送到配置的位置以确认连接成功。

一旦您的协议设置已配置，设置状态为启用并点击设置传送。您应在次日开始接收文件。

进一步协助

如有关于Signature统一数据的问题，请联系您的渠道经理或客户支持。

附录A：交易定义

请查阅附录A以获取交易定义。

附录B：付款对账报告定义

请查阅附录B以获取付款对账报告定义。

 

 

本网站使用人工智能进行翻译，可能包含不准确或错误。我们不对依赖翻译内容而产生的问题负责；请查阅原始英文版本以获取权威信息。

本文是否有帮助？
0 人中有 0 人觉得有帮助

评论

0 条评论

请登录写评论。