ユーザーに短い動画を見てもらうことで報酬を付与する「リワード広告」について、UnityAdsを例に挙げ、PlayFabに統合する方法について解説した資料です。

1. UnityAdsの
リワード広告を
統合する方法
ねこじょーかー @nekojoker1234
2020.7.26 PlayFab Meetup in Online

2. 自己紹介
普段は SIer として働く C# エンジニア。
PlayFab 専用のブログで情報を発信中。
最近は PlayFab のオンライン書籍を発売しました。
名前 : ねこじょーかー
Twitter：@nekojoker1234
Blog ：playfab-master.com
書籍 ：nekojoker.booth.pm/items/2236684

3. 本日の内容
1. 広告の概要
2. PlayFab で広告を定義する
3. プログラムの実装
4. 回数制限を入れる場合

4. 1 広告の概要

5. 広告の種類は大きく３つ
引用：https://apps.admob.com/ 「広告ユニットの作成」より

6. リワード広告のイメージ
引用：https://unityads.jp/developer.html

7. 2
PlayFab で広告
を定義する

8. Unity Dashboard で ID の確認

9. PlayFab での広告を定義する (1/5)

10. 配置名：好きな名前で OK
AppId ：Unity Dashboard で確認(7桁の数値)
広告ユニット：Unity Dashboard で確認
PlayFab での広告を定義する (2/5)

11. 「新しいリワード」を選択
PlayFab での広告を定義する (3/5)

12. アクションはいろいろあります
PlayFab での広告を定義する (4/5)

13. リワードは１種類だけでなく、複数
を登録しておいてランダムに報酬
を付与することも可能。（加重に応
じて確率が決まる）
ランダムにしたい場合は、「ランダ
ムに選択」を選ぶ。
今回は１つなので、EarnGold 固
定とした。
PlayFab での広告を定義する (5/5)

14. 3
プログラムの
実装

15. Step 1. 登録した広告配置の取得
Step 2. アクティビティの報告
Step 3. 報酬の付与

16. 登録した広告配置の取得
❖ GetAdPlacements を使用する

17. アクティビティとは
❖ アクティビティとは「広告の状態を表すもの」
❖ UnityAds では動画広告に以下のステータスが用意されている
➢ Finished：動画をスキップせず最後まで視聴した
➢ Skipped ：動画がスキップされた
➢ Failed ：動画表示に失敗した
❖ PlayFab 側にもアクティビティとして報告してあげると、
あとで分析ができるようになる

18. アクティビティの報告の定義
❖ ReportAdActivity を使用する
AdActivity というのが、PlayFab で用意
されているステータスの列挙体。

19. アクティビティの報告の呼び出し
UnityAds 側の結果取得メソッド内
で、ステータスに応じて PlayFab の
ReportAdActivity を呼び出す

20. アクティビティの報告結果
❖ アクティビティの報告結果は、ダッシュボードで確認できる

21. 報酬の付与
❖ RewardAdActivity を使用する
❖ GetAdPlacements で保持していた ID を渡す
❖ 成功したら、GetAdPlacements を実行して ID を再取得

22. 報酬の付与のイベントログ

23. 4
回数制限を
入れる場合

24. リワード制限を設定する
リワード制限にチェックを入れること
で、表示できる頻度を制限できる。
画像では、１時間に２回までという制
限をしている。

25. リワード制限を設定する
広告の回数制限の設定がない場合は、
残り回数やリセット時間は null となる。
回数制限がある場合で、残り回数が
残っているか、残り時間が 0 になったタ
イミングで動画広告を表示できるように
する。
再取得しないと残り時間は変わらない
ので、特に Update でやる意味はない
です（笑）

26. リワード制限を設定する
RewardAdAdtivity のタイミングでもエ
ラーになる

27. おまけ

28. 今回のサンプルあります
GitHub でサンプルプログラムを公開
しているので、実装の参考にしてみて
ください。
github.com/nekojoker/UnityAdsWithPlayFab

29. PlayFab 専用のブログ
PlayFab で実際に試した内容を
ブログで発信中です。
こちらも合わせてご覧ください。
▼ 今回の内容に関する記事
playfab-master.com/playfab-reward-ads

30. 「猫でもわかる PlayFab 入
門」好評発売中！
PlayFab の入門編として、オンライン
書籍を執筆しました。
今までの知見を凝縮した自信作と
なっています。
7/29(水) 22:00 までセール価格に
て販売中です。
▼ Booth の販売ページ
nekojoker.booth.pm/items/2236684

31. Thanks!!
contact me at @nekojoker1234