クイックスタート: 広告の配置を設定する

  • [アーティクル]

リワード広告は、リワードと引き換えに動画広告を視聴するようプレーヤーを動機付ける方法です。 関連するリワードを含む各広告は、広告の配置と見なされます。 このクイックスタートでは、広告の配置を設定し、そのリワードを設定します。

前提条件

広告の配置を設定する

[リワード広告] タブで最初に表示されるのは、広告のメインダッシュボードです。 ここには、広告の基本的な KPI と、最近の広告イベントを示すグラフがあります (これらは、PlayStream デバッガーにも表示されます)。 上部で、[配置] を選択します。

広告の配置は、システムの最も基本的な部分です。 単一の配置を "広告の位置" と考えてください。表示される広告のタイプ (バナー、ビデオなど) と、ゲームのどの時点でプレーヤーに表示されるか ("広告を見る" をクリックした結果のレベル インタースティシャルなど)。

右上隅で、[新しい広告の配置] を選択します。 配置に好きな名前を付け、広告プロバイダーからのアプリケーション ID と広告ユニット タイプを入力します。 特定のプロバイダーのアプリケーション ID と広告ユニット タイプの場所がわからない場合は、お知らせください。協力してそれらを特定します。

リワードを追加する

次に、特定のリワードを追加する必要があります。 この配置で可能なリワードごとに、[新しいリワード] を選択します。 リワードに名前を付け、特定のリワードが与えられたときにクライアントに返す説明テキストとアセット パッケージの URL を入力します。 次に、[アクション] で、[アクションの追加] を選択します。 通常の PlayStream アクションでできるのと同じように、今すぐさまざまなアクションを実行できます。CloudScript ハンドラーの実行、アイテムの付与などです。通常、ここで仮想通貨またはアイテムを付与しますが、他のアクションの種類を使用する場合は、通常の PlayStream アクション トリガーと同じ方法ですべて処理されます。

いくつかのリワードを定義したら、それぞれに重みを付けてランダムな分布を設定します。 タイトルに [セグメント] を定義した場合は、[リワード] の下の [セグメント割り当て] ツールでオーバーライドを設定することもできます。 たとえば、常に特定のリワードを受け取りたい特定のプレーヤーのグループがある場合は、割り当てリストでそのセグメントをそのリワードに設定します。 セグメントの割り当ては優先順位が高いため、現在のプレーヤーのセグメントと一致する最初のセグメントが使用されます。 次の例では、無料の宝石を 0% の確率で、ボーナス エクスペリエンス ポイントを 30% の確率で、"キー" アイテムを 70% の確率で提供する広告配置を定義しています。

ゲーム マネージャー - ストア - セグメント オーバーライド

この例では、[セグメント割り当て] を使用して、優先順位でリワードを提供します。 プレーヤーが "高 XP プレーヤー" グループに属している場合、通常のランダム選択が行われます。 ただし、プレーヤーが "VIP プレーヤー" セグメントに属している場合は、そのプレーヤーに "宝石" のリワードを与えます。

ヒント

初めて広告を見ているプレーヤーのためにセグメントを作成し、彼らにあなたがより望むリワードの 1 つを与えることを検討してください。 これにより、リワード広告を引き続き利用するようプレーヤーにインセンティブを与えることができ、全体的な保持率が高くなります。

最後に、プレーヤーが広告に対してリワードを受け取ることができる回数を制限するオプションがあります。 例では、これをプレーヤーごとに 1 日 4 回に制限しました (このカウンターでの毎日のリセットは 00:00 UTC に発生します)。 制限は、毎日、1 時間ごと、または 2 時間ごとにリセットできます。

広告配置の取得

少なくとも 1 つの広告配置を定義した後、Client/GetAdPlacements を使用して利用可能な配置のリストをクエリできます。 呼び出しで識別子を指定して、指定された配置に関する情報のみを取得できるようにします。 特定の配置をフィルター処理するには、その配置に定義した名前 (上記)、または PlayFab で生成された配置の一意の識別子 (上記の例の URL で確認できます) のいずれかを使用できます。 それ以外の場合は、プレーヤーのリワード、現在残っているビューの数、ビュー制限をリセットする時間など、プレーヤーが有効なリワードを持っている利用可能なすべての配置が AdPlacementDetails オブジェクトに返されます。 クライアント コードで広告配置を選択したら、必ず PlacementId と RewardId を保存してください。 次の 2 つの段階でそれらを使用します。

広告アクティビティのレポート

広告には、"オープン"、"クローズ"、"開始"、"終了" の 4 つのアクティビティ状態を定義します。 リワード広告を使用するときは、Client/ReportAdActivityRequest を呼び出して、広告 SDK が状態の変化を報告するたびにアクティビティの状態を更新することを確認してください。

広告アクティビティのリワード

広告ビューが正常に完了したことを広告 SDK が報告したら、Client/RewardAdActivity を呼び出してリワードをトリガーします。 この呼び出しには PlacementId と RewardId が必要であり、Client/GetAdPlacements によって返されます。 最初にリワードが有効であることを確認し、次にプレーヤーのためにそれを処理します。 アイテムはすぐに付与され、呼び出しは、Grant Item、Grant Virtual Currency、および Increment Player Statistic アクションによってプレーヤーに加えられた変更の完全なセットを返します。

最後に、GetAdPlacements の呼び出しの一部として、リワード ID がプレーヤーにバインドされていないことに注意することが重要です。 指定した重みに基づいて、GetAdPlacements を複数回呼び出すと、リワードが変更される可能性があります。 RewardAdActivity の呼び出しでは、リワードがプレーヤーに対して有効である必要があり、GetAdPlacements から最後に返されたものである必要はありません。