ゲーム「神弓」で始めよう

まず、デモゲームが含まれたSDKパッケージをダウンロードし、Unityプロジェクトで読み込みます。続けてUnity EditorでTentuPlayに関する設定を行い、プレイヤーの行動データ収集に必要な作業を行います。データ収集はすでに記載されているTentuPlayクラスとメソッドのコードをそのまま利用するか、必要に応じてデモゲームのスクリプトに収集イベントごとに新しいメソッドを追加してください。最後に収集したデータがTentuPlayサーバーに無事アップロードされているかを確認します。

それではゲームをプレイしましょう。イベントが発生すると、それに関連するメソッドが呼び出されます。代表的なイベントにはログイン、ステージ開始、インゲーム財貨の使用などがあります。メソッドを通じてプレイヤーの行動データが収集され、予め指定したアップロードルールに従ってTentuPlayサーバーに送られます。

アップロードされたデータはTentuPlayデータベースに格納され、定期的にデータ分析エンジンによって処理されます。その結果としてオファーに必要なコンテンツが作成され、関連APIを呼び出して取得することができます。TentuPlayにおけるオファーとは一種の購入推薦システムのことで、プレイヤーのゲームパフォーマンスとユーザーエクスペリエンスを向上させる目的で使われます。オファーに必要な主な作業は送信するオファーの種類、オファーメッセージのレイアウト、送信タイミングなどを決め、Unity Editorとコンソールで設定することです。

オファーのテンプレート、メッセージ本文、そしてメッセージの種類を組み合わせてようやくオファーが完成すると、指定したイベントの発生時に（デモゲームの場合はゲームオーバーのとき）そのオファーがゲーム画面に表示されます。

「神弓」のゲームデモはTentuPlay SDKに含まれています。

SDKのインストールはUnity Editor上で行います。

ここからはコーディング作業になりますが、何もない状態から始めるわけではなく、コアなゲームロジックには追加すべき主なメソッドがデモゲームのソーススクリプトにコメント付きで記載されています。ゲームのソースコードの中からTentuPlayサービスに関するソースを確認するには APIドキュメントをご覧ください。手短に言えば2つのネームスペースに3つのクラスがあり(TPStashEvent、TPUploadData、TPPersonalizedOffer)、これらのクラスにはイベントごとにデータ収集、データアップロード、オファーの作成を行うメソッドが含まれています。

特にデータ収集とアップロードにはTPStashEventとTPUploadDataの2つのクラスだけが使われます。TPUploadDataは手動アップロードにのみ使われるため、TentuPlay Settingsの設定でAuto Uploadを選択した場合はTPStashEventとサブメソッドだけが必要になります。

以下はデモゲームで使われたAPIの一部になります。

データ収集に関する詳細はデータの収集をご覧ください。ここでは主にゲーム開始前に発生する登録とログインイベントを収集する2つのメソッド(Join()、LoginApp())を呼び出す方法について説明します。データ収集とアップロードが無事行われたかどうかを確認するには収集したデータのデバッグをご覧ください。

TPPersonalizedOfferはこの2つのオファーで共通的に使われるクラスです。 いくつかのメソッドがこれに含まれますが、中にはオファーの取得または表示を行う `ShowOfferById`と `ShowLatestOffer`があります。

TentuPlayコンソールではTentuPlayサービスのオファー機能を使用するのに必要なすべてのツールを提供しています。コンソールインターフェースを通じていつ、何を、どのように、誰に送信するかを設定することができ、既存のユーザーセグメントを制御することができます。送信するオファーをプレビューしながらオファーをプレイヤーに送る前にテストすることも可能です。さらにプレイヤーに対し、送信したオファーがどのような成果を上げたかをダッシュボードで確認することができます。

詳しくはパーソナライズされたオファーとAIショップをご覧ください。

ここではゲームをプレイしながらどのような変化が生じ、どのメソッドが呼び出されるかを見てみましょう。