Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • onClicked

    • 定義

      • 広告がユーザーによってクリックされる (=clickableViewsで指定したcomponentがクリックされた状態)

        • 静止画バナー/動画広告のいずれにおいてもonClickEvent/shouldClickAd (AOS/iOS)を通じたclickイベントの受け取りが可能(아래 참조下記参照)

        • この時静止画バナー広告の場合はLPへの遷移を開始し、動画広告の場合はサーバーから動画のアセットを取得し、再生を開始する

    • 重複呼び出しの有無

      • 1つの広告あたり重複しての呼び出しが可能。(ユーザーが広告をクリックしてLPに遷移後アプリに戻ってきてから再度クリックしたり、下記のように動画の一時停止/再生ボタンが行われたり、インラインで再生中に全画面表示に切り替えたりする場合等)

    • 注意

      • 動画広告の場合、mediaView内の再生/全画面再生/リプレイ/ランディングボタンがユーザーに表示されており、(Appendix 이미지 Appendix画像 参照) これらのボタンをクリックしたときに全く反応がないのはUX上不自然なため、mediaViewを clickableViewsに指定していなくても該当の4か所のボタンはクリックが可能になっており、クリック時に onClicked コールバックが呼び出される

      • また、動画再生中に一時停止/再開動作のため、上にある再生ボタンが複数回押されることがあるが、この場合にも毎回 onClicked コールバックが呼び出される

    • 推奨設定

      • XXっk


  • onRewardRequested (新規追加)

    • 定義

      • 広告についてのリワード付与条件を満たし、リワード付与リクエストが行われたことを示す

        • 静止画広告の場合クリック後にしてLPに遷移後すぐに(1秒) 戻るボタンが押されなかった時、した場合動画広告の場合、最小再生時間を経過

    • 重複呼び出しの有無

      • 通常1回呼び出されるが、下の onRewardedの Failure条件を満たす場合呼び出されなかったり(リワード付与対象ではない場合) 重複して呼び出されたりすることがある (サーバーにてエラーにより付与が正しく行われずユーザーが再試行する場合)

    • 注意

      • 該当のコールバックは省略可能(リワード付与条件を満たさない場合リワードが付与されないのですが、このときはonRewarded コールバックにFailureとして送信される)

    • 推奨設定

      • リワード付与完了についてのレスポンスを受け取るまでの間にローディング画像等を表示

        • 動画の場合最小再生時間まで再生後リワードが付与されonClicked コールバックが複数回呼び出されるためonClicked コールバックではないonRewardRequested コールバックでローディング画像を表示することを推奨

...