自動イベントトラッキング
Hive SDKは、以下の4つのイベントを自動的に追跡し、それぞれのアトリビューションに送信できます: インストール、オープン、アップデート、購入(アプリ内購入) ゲームスタジオは、これらの4つのイベントを追跡するためのコードを実装する必要はありません。
Adjustによる自動イベントトラッキング¶
-
各アトリビューションから必要なトークンを取得します。Adjustダッシュボードガイドを参照して、トークンの取得方法を学んでください。
- 購入および更新イベントを自動的に追跡するには、これらのイベントをAdjustダッシュボードに登録し、アプリトークンとイベントトークンを取得します。アプリトークンはダッシュボードのメインページで取得でき、イベントトークンはダッシュボード > すべての設定 > イベントで取得できます。
- インストールおよびオープンイベントの自動追跡には、トークンは必要ありません。
-
hive_config.xmlにトークンを追加します。
- hive_config.xmlにアプリトークン、購入のイベントトークン、および更新のイベントトークンを追加します。詳細については、以下の例コードを参照してください。
- インストールおよびオープンイベントの自動追跡のために、hive_config.xmlの設定は必要ありません。
- Adjustダッシュボードは、アプリのスプーフィングを防ぐためにSDK Signature V3を提供します。SDK Signatureを使用するには、Adjustとの契約条件を確認する必要があります。
Note
ゲーム運営のために、すべての4つのイベントを自動的に追跡することをお勧めします。
SDK署名統合¶
古いバージョンのSDK署名を使用している場合は、署名ライブラリを統合する前にSDK署名の移行を確認してください。
SDK署名を初めて使用する場合は、以下の指示に従ってください。
アンドロイド¶
Android環境でSDK署名を使用するには、これらの指示に従ってください。
- プロジェクトレベルの build.gradle ファイルに Adjust の帰属を追加して、SDK Signature を使用します..
- Adjust ダッシュボードに移動し、Adjust の許可リストにデジタル証明書のフィンガープリントを追加する ページの指示に従ってフィンガープリントを設定します。
各アプリで使用される証明書の方法に応じたフィンガープリント抽出方法を、Adjust Suiteの証明書設定ページを参照して確認できます。
iOS¶
iOS環境でSDK Signatureを使用するには、PodfileにProviderAdjust
サブスペックを追加してください。
ユニティ¶
UnityエンジンでSDK署名を使用したい場合は、Unityエンジンのメニューで簡単に設定できます。
以下の**インスペクタ**メニューでHive - Hive 依存関係 (ExternalDependency)を選択し、調整にチェックを入れると、追加の設定なしでSDK署名を使用できます。
SDK署名統合ステータスの確認¶
SDK署名ライブラリが正しく統合されていることを確認するには、まずHive SDK設定のzone
がsandbox
に設定されていることを確認してください。次に、以下の手順に従ってください。
Note
詳細については、Adjust Documentationを参照してください。
- テストデバイスからアプリを完全にアンインストールして、インストール情報が送信されることを確認します。
- Adjust Dashboard Testing Consoleに移動し、テストデバイスの情報を入力して、デバイスを削除をクリックしてすべてのデバイスを削除します。
- テストデバイスにアプリをインストールし、実行してインストール情報がAdjustに送信されることを確認します。
- テストデバイスの広告IDまたはIDFAをテストコンソールに入力して、インストールイベント情報を取得します。
SignatureVerificationResult
フィールドにはValid Signature
という値が表示されるべきです。SignatureVersion
フィールドの値が3
であることを確認します。
SDK署名の移行¶
最新のSDK署名を使用するには、以前のSDK署名バージョンの設定を削除する必要があります。
Android、iOS¶
secretId
、info1
、info2
、info3
、およびinfo4
に設定されたすべてのキーと値を、hive_config.xmlのAdjust関連設定から削除してください。
<providers>
<!-- (code omitted) -->
<!-- Do not set the Adjust node id field. -->
<!-- The Adjust node name field is fixed as "Adjust". -->
<!-- The event node name field is set arbitrarily by the game company. -->
<!-- Remove secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333" below -->
<Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333">
<events>
<event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
<event name="Update" value="UPDATE_EVENT_TOKEN" />
</events>
</Adjust>
<!-- (code omitted) -->
</providers>
ユニティ¶
メニューからHive - 設定を編集を選択し、AndroidまたはiOSタブをアクティブにします。次に、Adjust > アプリの秘密値に設定されているすべての値をsecretid, info1 ~ info4について削除します。
Airbridgeを使用してイベントを自動的に追跡する¶
- 必要なトークンを取得します。トークンの発行方法についての詳細は、Airbridgeダッシュボードガイドを参照してください。
- ダッシュボード > 設定 > トークン管理からアプリSDKトークンとアプリ名を取得します。
- AndroidとiOSの場合、トークン、アプリ名、更新イベント設定をhive_config.xmlに追加します。以下の hive_config.xmlの例コードを参照してください。
- Windowsの場合、hive_config.xmlの設定の代わりにHive Consoleの設定が必要です。以下のWindows設定を参照してください。
- Windows、Android、iOSを一緒に適用する場合は、事前設定のためにAirbridgeにお問い合わせください。
- Airbridgeはアプリの偽装を防ぐためにSDK署名を提供しています。この機能を使用するには、まずAirbridgeとの契約条件を確認する必要があります。キーを取得し、hive_config.xmlの
secretId
、secret
値として追加します。SDK署名のセキュリティ情報についての詳細は、Airbridgeガイドを参照してください。これはAndroidとiOSでのみサポートされており、Windowsではサポートされていません。
SDK署名統合¶
SDK署名を初めて使用する場合は、以下の指示に従ってください。
hive_config.xml の例コード¶
<providers>
<Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
<events>
<event name="Update" value="Update" />
<event name="Install" value="Install"/>
<event name="Open" value="Open"/>
<event name="PrePurchase" value="airbridge.initiateCheckout"/>
<event name="PurchaseCancel" value="airbridge.ecommerce.order.canceled"/>
<event name="Purchase" value="airbridge.ecommerce.order.completed"/>
</events>
</Airbridge>
</providers>
Android、iOS¶
Airbridgeに関連するsecretId
、secret
キーの値をhive_config.xmlに設定します。
ウィンドウズ¶
-
マーケティングアトリビューションを進める - HiveコンソールのAirbridge設定。
- hive_config.xmlにAirbridgeに関連する
secretId
、secret
キーの値を設定する必要はありません。
- hive_config.xmlにAirbridgeに関連する
-
以下の指示に従って、hive_config.xmlに設定します。*hive_config.xml*の例コードを参照してください。
Airbridgeで定義された値に設定すると、Airbridge標準イベントとして送信できます。
Airbridgeイベントタイプ- インストール: セットアップが必要です。
- オープン: セットアップが必要です。
- 更新: セットアップが必要です。
- プレ購入: セットアップが必要です。値として airbridge.initiateCheckout を持つ標準イベントを送信できます。
- 購入キャンセル: セットアップが必要です。値として airbridge.ecommerce.order.canceled を持つ標準イベントを送信できます。
- 購入: セットアップが必要です。値として airbridge.ecommerce.order.completed を持つ標準イベントを送信できます。
ユニティ¶
メニューからHive - 設定を編集を選択し、AndroidまたはiOSタブをアクティブにします。次に、AirbridgeでsecretId, secretに渡される値を設定します。
自動イベントが発生したときに送信される情報¶
特定のイベントが実行されると、そのイベントは自動的にAirbridgeアプリのアトリビューションに送信されます。この時送信される情報は以下の通りです。
イベント名 | パラメータ | 備考 | |
---|---|---|---|
ログイン | サインイン |
| |
ログアウト | outサインアウト | ||
支払い開始 | チェックアウト開始 |
|
|
購入完了 | 注文完了 |
|
|
購入キャンセル | 注文キャンセル |
|
|
サブスクリプション | サブスクライブ |
|
|
広告インプレッション | 広告インプレッション |
|
|
広告クリック | 広告クリック |
|
|
評価 | レート |
|
|
共有 | 共有 |
Singular、Appsflyer、Firebase Analyticsによる自動イベント追跡¶
- 各アトリビューションダッシュボードから必要なキーを取得します。キーの取得方法については、各アトリビューションダッシュボードのガイドを参照してください。
- Singular: ダッシュボードからSDKキーとSDKシークレットキーを取得します。
- Appsflyer: AppsFlyerの設定 > アプリ設定に移動してDevキーを取得します。
- Firebase Analytics: キーは必要ありません。
-
以下のガイドに従ってhive_config.xmlを設定します。詳細については、以下の例コードを参照してください。
- インストール: 設定は必要ありません。
- オープン: Firebase Analyticsの設定のみが必要です。
- 更新: すべてのアトリビューション(Singular、Appsflyer、Firebase Analytics)の設定が必要です。
- 購入: SingularとFirebase Analyticsの設定が必要です。
- Hive SDK iOS(ネイティブ、Unity、Unreal)でAppsFlyerアトリビューションを使用する場合、Apple AppIDのために
itunseConnectAppId
を設定する必要があります。
<providers> <!-- Singularの設定 --> <!-- Singularノードのnameフィールドは「Singular」に固定されています。 --> <!-- eventノードのnameとvalueフィールドは各ゲームスタジオによって定義されます。 --> <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY"> <events> <event name="Purchase" value="purchase"/> <event name="Update" value="update"/> </events> </Singular> <!-- AppsFlyerの設定 --> <!-- AppsFlyerノードのnameフィールドは「AppsFlyer」に固定されています。 --> <!-- AppsFlyerノードのidフィールドは設定しないでください。 --> <!-- イベントノードのnameフィールドとvalueフィールドは各ゲームスタジオによって定義されます。 --> <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112"> <events> <event name="Update" value="Update"/> </events> </AppsFlyer> <!-- Firebase Analyticsの設定 --> <!-- イベントノードの名前と値のフィールドは各ゲームスタジオによって定義されます。 --> <firebase> <events> <event name="Purchase" value="purchase"/> <event name="Open" value="open"/> <event name="Update" value="update"/> </events> </firebase> </providers>
Note
ゲーム運営のために、すべての4つのイベントを自動的に追跡することをお勧めします。
購入イベントで送信される情報¶
あなたのゲームの課金をHive IAPで実装すると、Hive SDKは自動的に購入イベントをサードパーティのモバイルアプリのアトリビューションに送信します。各イベントで送信される情報は以下の通りです。
イベント名 | パラメータ | 備考 | |
---|---|---|---|
調整 | 購入 |
|
|
Airbridge | 注文完了 |
|
|
Singular | __iap__ |
|
|
AppsFlyer | 購入 |
|
|
Firebase Analytics | 購入 |
|
|