Platform:

追踪购买

通过消费行为细分用户是Tapjoy SDK最强大的功能之一。例如，您的广告主要是想显示给您的非消费用户，但是事实上却把广告投向了您的高端付费用户。要使用这项功能，必须让Tapjoy了解您的用户的消费活动。

在SDK 11.2.0及更高版本中，Google Play商店和Apple的iTunes商店需要分别调用相关API来传递收据参数，以便Tapjoy在控制面板展示之前可以验证购买是否有效：

1. 实现

A. Google Play 商店:

Tapjoy.TrackPurchaseInGooglePlayStore(skuDetails, purchaseData, dataSignature, campaignId);

参数说明：

skuDetails – 用JSON对象格式的字符串包含产品项目的详细信息（遵循谷歌规范）
purchaseData – JSON格式的字符串，其中包含有关采购订单的详细信息。它将在调用购买之后由操作系统返回。使用空值将不验证。
dataSignature – 字符串包含开发人员用自己的私钥签署了的购买数据签名。它将在调用购买之后由操作系统返回。使用空值将不验证。
campaignId – 发起购买活动PurchaseRequest的campaign ID。如果您不希望跟踪哪些活动发起此次购买可以设置为空值。

为了让购买跟踪的收据验证在Android上正常工作，您必须在应用设置中填入您的应用程序的许可证密钥，具体在应用设置 > 分析 > 收据验证。

您能在Licensing section of the Google Services Documentation找到如何得到您应用的许可密钥。

示例:

if (purchaseData == "" || purchaseData == null) { 
    purchaseData = "DATA_WAS_EMPTY"; 
}

if (dataSignature == "" || dataSignature == null) { 
    dataSignature = "SIGNATURE_WAS_EMPTY"; 
}

Tapjoy.TrackPurchaseInGooglePlayStore(skuDetails, purchaseData, dataSignature, campaignId);

B. iOS App 商店:

Tapjoy.TrackPurchaseInAppleAppStore("SWORD", "USD", 0.99, transactionID, null);

参数说明：

productId — 字符串格式产品标识符。
currencyCode– ISO 4217格式定义的货币代码，例如："USD", "KRW"
price — double格式产品价格。
transactionId — 字符串格式IAP交易标识符（比如完成IAP交易的收据）。如果提供相关信息，我们会做收据验证（iOS 7.0及以上版本可用）。
campaignId — 字符串格式发起购买活动请求的campaign id，可以为null

示例:

if (transactionId == "" || transactionId == null) { 
    transactionId = "ID_WAS_EMPTY"; 
}
TapjoyUnity.Tapjoy.TrackPurchaseInAppleAppStore(productId, currencyCode, productPrice, transactionId, campaignId);

2. 无验证追踪:

SDK 11.2.0及以前版本，追踪调用如下。注意下面示例假设您已经进行了收据验证：

Tapjoy.trackPurchase("SWORD", "USD", 0.99, null);

货币代码遵照了ISO 4217 standard。

第四个参数为campaign ID字符串，用来追踪带来交易的campaign。

一旦购买追踪实现完成，您将可以在控制面板的“IAP Revenue”中看到相关图表。

3. Referrer (Android)

集成Tapjoy InstallReferrerClient到Tapjoy Analytics

在your_project.cs类的start()方法中，调用Tapjoy.ActivateInstallReferrerClient();
下载com.android.installreferrer:installreferrer并且导入到您工程的Assets > Android > Plugins文件夹中

4. 重要提示

您应该在您的Tapjoy IAP跟踪调用中包含IAP购买收据（对于SDK版本11.2.0或更高版本），或者使用Google Play收据验证来验证给定的IAP是否有效（或适合您所使用商店的任何内容）然后将其报告给Tapjoy。如果您不这样做，几乎可以肯定的是，欺诈性购买会影响到您的指标和细分。这将破坏大量的Tapjoy功能，包括“未来价值地图”以及使用某些内容定位（或排除）高消费用户的功能。

IAP在免费增值应用程序中的增长突显了应用程序开发人员验证每次购买并防范欺诈的迫切需求。我们强烈建议您在应用程序中使用收据验证，以防止未经授权的交易污染您的数据。这样，您就可以将有效（且仅有效）的购买合并到您的移动分析数据中。如果您不包含收据参数，我们将假设您自己进行了收据验证，并认为购买有效。

使用IAP收据验证并在Tapjoy控制面板上跟踪数据非常简单，并且对应用程序发布者的工作量很小。

您只需要为用户进行的每次购买进行一次IAP跟踪调用。通过包括收据参数，您将消除显示在控制面板上的欺诈性购买的收入，并确保IAP分析保持准确。您可以将Apple或Google商店收据与Tapjoy IAP跟踪调用一起传递，Tapjoy的服务器会在将交易添加到控制面板数据之前验证该交易是否有效。

完成收据验证后，您可以放心地查看数据集，Tapjoy的“未来价值地图”，并通过IAP促销和广告的非支出者来定位支出者，从而真正从用户中提高LTV。

追踪购买
1. 实现
2. 无验证追踪:
3. Referrer (Android)
4. 重要提示