クイックスタート: 広告プレースメントをセットアップする
リワード広告は、報酬と引き換えに動画広告を視聴するようプレイヤーに動機付けする方法です。関連する報酬を伴う各広告は、広告プレースメントとみなされます。このクイックスタートでは、広告プレースメントをセットアップし、その報酬を構成します。
前提条件
広告プレースメントをセットアップする
Rewarded Ads タブで最初に表示されるのは、広告のメイン ダッシュボードです。ここには、広告の基本的な KPI と、最近の広告イベントを示すグラフが表示されます (これらは PlayStream にも表示されます)。上部で Placements を選択します。
広告プレースメントは、システムの最も基本的な部分です。単一のプレースメントを「広告位置」と考えてください: 表示される広告のタイプ (バナー、動画など) と、プレイヤーがゲーム内でいつそれを目にするか (レベル間の広告、“広告を表示” のクリック結果としてなど) を定義します。
右上隅で New Ad Placement を選択します。プレースメントに任意の名前を付け、広告プロバイダーからのアプリケーション ID と広告ユニット タイプを入力します。特定のプロバイダーのアプリケーション ID と広告ユニット タイプの場所が分からない場合はお知らせください。特定を支援します。
報酬を追加する
次に、具体的な報酬を追加する必要があります。このプレースメントの各報酬候補について、New Reward を選択します。報酬に名前を付け、特定の報酬が付与されたときにクライアントに返したい説明テキストとアセット パッケージ URL を入力します。次に、Actions で Add Action を選択します。通常の PlayStream アクションと同じように、ここではさまざまなアクションを実行できます - Cloud Script ハンドラーの実行、アイテムの付与など。通常はここで仮想通貨またはアイテムを付与しますが、他のアクション タイプを利用したい場合は、通常の PlayStream アクション トリガーと同じ方法で処理されます。
いくつかの報酬を定義したら、ランダム分布を設定するために各報酬に重みを付けます。タイトルに セグメント を定義している場合は、Rewards の下の Segment Assignment ツールでオーバーライドを設定することもできます。たとえば、常に特定の報酬を得たい特定のプレイヤー グループがいる場合、そのセグメントを割り当てリストでその報酬に設定します。セグメント割り当ては優先順位順であり、現在のプレイヤーに一致する最初のセグメントが使用されます。次の例では、無料ジェムを 0% の確率で、ボーナス経験値を 30% の確率で、“key” アイテムを 70% の確率で提供する広告プレースメントを定義しています。
この例では、Segment Assignment を使用して優先度順に報酬を提供しています。プレイヤーが “High XP Players” グループに属している場合、通常のランダム選択が行われます。しかし、プレイヤーが “VIP players” セグメントに属している場合は、そのプレイヤーに “gems” の報酬を付与します。
初めて広告を視聴するプレイヤー向けのセグメントを作成し、より魅力的な報酬の 1 つを付与することを検討してください。これにより、プレイヤーがリワード広告への関与を継続することを促し、全体的なリテンション率の向上につながります。
広告プレースメントを取得する
少なくとも 1 つの広告プレースメントを定義した後、Client/GetAdPlacements を使用して利用可能なプレースメントのリストをクエリできます。呼び出しで Identifier を指定して、指定したプレースメントの情報のみを取得できるようにします。特定のプレースメントでフィルタリングするには、上記で定義した名前、または PlayFab が生成したプレースメントの一意識別子 (上記の例では URL に表示されています) のいずれかを使用できます。それ以外の場合、プレイヤーが有効な報酬を持つ利用可能なすべてのプレースメントが AdPlacementDetails オブジェクトで返され、プレイヤー向けの報酬、現在残っているビュー数、ビュー制限のリセットまでの時間などが含まれます。
クライアント コードで広告プレースメントを選択したら、PlacementId と RewardId を保存してください。これらは次の 2 つの段階で使用します。
広告アクティビティを報告する
広告には 4 つのアクティビティ状態を定義します - “Opened”、“Closed”、“Start”、“End” です。リワード広告を使用する際は、広告 SDK が状態変更を報告するたびに Client/ReportAdActivityRequest を呼び出してアクティビティ状態を更新するようにしてください。
広告アクティビティに報酬を付与する
広告 SDK が広告視聴が正常に完了したことを報告したら、Client/RewardAdActivity を呼び出して報酬をトリガーします。この呼び出しには、Client/GetAdPlacements から返された PlacementId と RewardId が必要です。まず報酬が有効であることを確認し、次にプレイヤーに対して処理します。アイテムは即座に付与され、その後、呼び出しは Grant Item、Grant Virtual Currency、Increment Player Statistic アクションによってプレイヤーに加えられた変更の完全なセットを返します。
最後に、報酬 ID は GetAdPlacements の呼び出しの一部としてプレイヤーにバインドされないことに注意してください。指定した重みに基づいて、GetAdPlacements を複数回呼び出すと報酬が変わる可能性があります。RewardAdActivity の呼び出しでは、報酬がプレイヤーにとって有効であることだけが必要で、GetAdPlacements から最後に返されたものである必要はありません。