SDK /SDK
SDK ガイドを使用して、Tapjoy の広告プレースメントを Flutter にリクエストおよび表示する方法を説明します。初期化とコールバックを処理するお勧めの方法も紹介します。
読み終わるまでの所要時間 1 分最終更新 1日前
プレースメントのリクエスト
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();