SDK
了解如何根据 SDK 指南在 Flutter 中请求和显示 Tapjoy 广告位,包括建议的初始化和回调处理做法。
阅读时间2 分钟最后更新于 5 天前
请求广告位
创建 TJPlacement 的一个实例,并使用广告位名称对其进行初始化。确保代码中的广告位名称字符串与后台中的广告位名称完全匹配。还可以实现委托来接收回调(下文对此进行了说明)。现在可以请求内容。TJPlacement placement = await TJPlacement.getPlacement();
在请求内容之前,请确保 Tapjoy connect 调用已成功。在收到 onConnectSuccess 回调之前,不要发起请求。placement.requestContent();
预缓存内容
为了提供最佳用户体验,请在向用户显示内容之前提前请求内容。例如,如果广告位是主菜单上的按钮,您可能需要在应用程序启动时(就在 Tapjoy Connect 调用成功后)为其请求内容。如果等到最后一刻才请求内容,用户很可能需要等待内容加载并看着加载图标旋转。对于广告,这种情况会导致用户不太可能与广告互动,因此不太可能给您带来收入。回调
要获取有关内容请求状态的反馈,请实现以下回调:TJPlacement placement = await TJPlacement.getPlacement(placementName: 'placementName', onRequestSuccess: (placement) {}, onRequestFailure: (placement, error) {}, onContentReady: (placement) {}, onContentShow: (placement) {}, onContentDismiss: (placement) {});
显示广告位
要显示内容,请使用placement.showContent();showContent()最好是在显示可能包含视频的广告位的内容之前先将应用的音频静音,否则视频的音频与应用的音频可能会发生冲突。 通常,最好等到if (await placement.isContentReady()) { placement.showContent();}
onContentReadyp.isContentReady()重新请求内容
成功向用户显示广告位中的内容后,必须再次请求内容(例如,再次调用placement.requestContent();placement.showContent();设置入口点
(可选)您可以将每个广告位的“入口点”告诉 Tapjoy。有多种预设值可供选择:在创建广告位对象之后但在请求内容之前设置入口点:TJEntryPoint.entryPointUnknown;TJEntryPoint.entryPointOtherTJEntryPoint.entryPointMainMenuTJEntryPoint.entryPointHUDTJEntryPoint.entryPointExitTJEntryPoint.entryPointFailTJEntryPoint.entryPointCompleteTJEntryPoint.entryPointInboxTJEntryPoint.entryPointInitTJEntryPoint.entryPointStore
TJPlacement placement = await TJPlacement.getPlacement("myPlacement");placement.setEntryPoint(TJEntryPoint.entryPointMainMenu);placement.requestContent();