文档

支持

Offerwall

开始使用 Monetization（变现）

开始使用 User Acquisition

Unity SDK 集成

Offerwall

Offerwall 迁移指南

迁移 Offerwall 逻辑，包括将现有 ironSource 回调映射到等效的 Tapjoy 回调（如 onContentReady 和 onContentDismiss）。
阅读时间3 分钟最后更新于 5 天前
  1. 集成 ironSource Tapjoy 适配器。您可以将以下示例所示的代码添加到 gradle 文件中：
maven { url "https://sdk.tapjoy.com/"}implementation 'com.ironsource.adapters:tapjoyadapter:4.1.23'implementation 'com.tapjoy:tapjoy-android-sdk:12.11.1'
您可以在此处找到最新版的适配器。
  1. 如上所示，除了适配器，我们添加了 Offerwall SDK，因此您可以直接调用 Offerwall SDK 函数。我们需要这样做才能显示 Tapjoy Offerwall。首先，需要将 Tapjoy 导入您的类：
import com.tapjoy.Tapjoy;
  1. 初始化 Offerwall SDK。初始化成功（或失败）时，您将收到回调，在收到成功回调之前，不要进行任何 Offerwall SDK 调用。
Hashtable<String, Object> connectFlags = new Hashtable<String, Object>();Tapjoy.connect(getApplicationContext(), "TJ_SDK_KEY", connectFlags, new TJConnectListener() {  @Override  public void onConnectSuccess() {  }         @Override  public void onConnectFailure() {  }});
  1. 定义两个新的类变量：
private TJPlacementListener placementListener = this;private TJPlacement placement;
  1. 配置广告位对象。广告位在 Tapjoy 后台上进行配置，其中包含 Offerwall 内容卡片。在以下示例中，假设您已将广告位命名为“Offerwall”。实际上，您可以将其命名为任何名称，但此处在代码中使用的名称必须与后台上的名称匹配。
placement = Tapjoy.getPlacement("Offerwall", placementListener);
  1. 您现在可以请求广告位了。通过以下调用来加载广告位，以便在需要显示广告位时广告位准备就绪。Offerwall 广告位应该会快速加载，但最好在显示 Offerwall 之前进行此调用。
placement.requestContent();
  1. 我们提供了一系列可供您实现的回调。
public void onRequestSuccess(TJPlacement placement); public void onRequestFailure(TJPlacement placement, TJError error);public void onContentReady(TJPlacement placement); public void onContentShow(TJPlacement placement);public void onContentDismiss(TJPlacement placement);public void onPurchaseRequest(TJPlacement placement, TJActionRequest request, String productId);public void onRewardRequest(TJPlacement placement, TJActionRequest request, String itemId, int quantity);public void onClick(TJPlacement placement);
以上有一些回调可以替换您可能已经实现的 ironSource 回调（实现 
OfferwallListener
即可获得这些回调）。下表显示了相应的回调，便于您将自定义逻辑移到相应的 Tapjoy 回调中：

ironSource 回调

Tapjoy 回调

onOfferwallOpenedonContentShow
onOfferwallClosedonContentDismiss
onOfferwallAvailableonContentReady
从 Tapjoy 服务器返回内容请求时，将调用 
onRequestSuccess
。当内容 (Offerwall) 准备好显示时，将调用 
onContentReady
。此时，您可以显示 Offerwall，或设置某种标志，以便在需要时知道其已准备好显示。
  1. 要显示 Offerwall 广告位，请检查内容是否已准备就绪，然后调用 
    showContent
    ：
if(placement.isContentReady()) {  placement.showContent();}
此调用将替换您现有的 ironSource 调用： 
IronSource.showOfferwall();
  1. 用户关闭 Offerwall 后，您必须再次请求内容。您不能多次显示广告位。建议您在 
    onContentDismiss
    回调中请求广告位，以便下次用户请求时准备好再次显示。
  2. 现在可以移除所有剩余的 ironSource Offerwall 代码。例如，您不再需要设置 ironSource Offerwall 监听器，如果您的类实现了“OfferwallListener”，请移除该引用。

隐私

如果您使用 Unity LevelPlay，则可以使用 LevelPlay API 与 Tapjoy 共享以下隐私标志：
  1. GDPR 同意。
  2. 根据美国各州隐私法律，选择不出售或共享个人信息。
  3. 将特定终端用户标记为儿童。请注意，如果您的应用主要面向 COPPA 规定的儿童用户，必须将所有终端用户标记为儿童。
此外，如果您的应用加入了 Google Play 的 Designed for Families（亲子同乐）计划，或出现在 Google Play 的“Family（家庭）”类别中，请将应用的所有用户标记为儿童，并使用 Offerwall SDK 的此 API，这样我们就不会收集用户的 GAID。 如果您不使用 Unity LevelPlay，或者希望单独配置 Offerwall SDK，请按照这些准则与 Tapjoy 共享相关的隐私标志。