イベントと収益の追跡

フォローする
Avatar
Eyal Rabinovich
Updated
ドキュメント

Unreal Engine SDK 統合ガイド

開発者向けガイド 開発者向けガイド変更履歴
前提条件
互換性 アンリアル エンジン 4.23 以上
インテグレーション ガイド
  1. 基本的なインテグレーション
  2. イベントと収益のトラッキング
  3. ディープリンクの実装
  4. SKAdNetwork サポートの追加
  5. 高度なオプション

イベントのトラッキング（非収益）

Singularは、キャンペーンのパフォーマンスを分析し、KPIを測定するために、アプリ内イベントのデータを収集することができます。

例えば、ゲームアプリでユーザーのログイン、登録、チュートリアルの完了、レベルアップなどのデータを収集したい場合があります。

SendEvent とSendEventWithArgs メソッドを使って、アプリからSingularにイベントを送信できます。

注意： サードパーティのパートナーや分析ソリューションを使用する予定がある場合は、互換性を保証するためにイベント名と属性を英語で渡すことを強く推奨します。

SingularSDK SendEvent メソッド
説明 トラッキング用のユーザーイベントをカスタムイベント名で Singular に送信します。
シグネチャ 
public static void SendEvent(FString eventName)

使用例

 
// Send an event without any parameters, just a name

  USingularSDKBPLibrary::SendEvent("Login");
SingularSDK SendEventWithArgs メソッド
説明 カスタムイベント名と追加のカスタムパラメータを指定して、トラッキング用のユーザーイベントを Singular に送信します。
シグネチャ 
public static void SendEventWithArgs(FString eventName, 
  TMap<FString, FString> args)

使用例

 
TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendEventWithArgs("Login", args);

収益のトラッキング

Singularは、キャンペーンのパフォーマンスとROIを分析するために、アプリを通して得た収益に関するデータを収集することができます。Singularはレポート、ログエクスポート、ポストバックでデータを利用できるようにします。

注意事項 異なる通貨で報告された収益は、Singularアカウントで設定されたお客様の組織の優先通貨に自動変換されます。

カスタムイベント名、取引通貨、取引金額など、購入に関する情報をSingularに渡すにはSendRevenueを使用します。SendRevenueWithArgsもよく似ていますが、カスタムパラメータを追加できます。

SingularSDK SendRevenue メソッド
説明 収益イベントを Singular に送信します。
シグネチャ 
public static void SendRevenue(FString eventName,
 FString currency, float amount)
注意:通貨は ISO 4217 の 3 文字の通貨コード、たとえば"USD", "EUR", "INR" を渡します。
使用例 
USingularSDKBPLibrary::SendRevenue("Purchase Completed", "USD", 9.99);
SingularSDK SendRevenueWithArgs メソッド
説明 カスタムパラメータを追加して収益イベントを Singular に送信します。
署名 
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
注意:通貨を、"USD", "EUR", "INR" のような ISO 4217 の 3 文字の通貨コードで渡します。
使用例 
// Send a revenue event with product details

  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
  "USD", 9.99, args);

ハイブリッドイベント追跡（上級者向け）

Singularは、アプリに統合されたSingular SDKを通してすべてのイベントと収益を送信することを推奨します。しかし、Singularは他のソースからイベントと収益を収集することができます。

Singular SDKから送信されないイベントは、SingularのServer-to-Server Event documentation requirementsに準拠し、イベントの属性を正しく設定するために一致するデバイス識別子を提供する必要があります。

重要です：

Server-to-Server イベントリクエストで使用されるデバイス識別子がSingularで一致しない場合、不一致が発生します。以下の可能性に注意してください：

  • イベントリクエストがSingular SDKがアプリセッションからデバイス識別子を記録する「前」に受信された場合、そのイベントリクエストは未知のデバイスの「最初のセッション」とみなされ、Singularはそのデバイスをオーガニックアトリビューションとしてアトリビュートします。
  • Singular SDKがデバイス識別子を記録していたとしても、Singular SDKの識別子がServer-to-Server Eventリクエストで指定されたデバイス識別子と異なる場合、イベントの帰属は正しくありません。

ハイブリッドイベント追跡ガイド

内部サーバーからのイベント送信

Singularはお客様のサーバーから収益に関するデータを収集し、キャンペーンのパフォーマンスやROIの分析に役立てることができます。

要件

  • アプリ内登録またはログインイベントから、デバイス識別子を取得して渡し、このデータをユーザーIDと共にサーバーに保存します。デバイス識別子はユーザーによって変更される可能性があるため、ユーザーがアプリセッションを生成する際には必ず識別子を更新してください。これにより、サーバー側イベントが正しいデバイスに帰属することが保証されます。
  • サーバー側イベントはプラットフォーム固有であるため、デバイスプラットフォームに一致するデバイス識別子（iOSデバイスのIDFAまたはIDFVなど）のみを使用して送信する必要があります。
  • Singular 内部 BI ポストバック メカニズムを使用して、内部エンドポイントにリアルタイムでイベントをプッシュすると、サーバー側でデータセットを更新できます。内部 BI ポストバック FAQ を参照してください。
  • 詳細については、『サーバー間統合』ガイドの「収益の追跡」セクションを参照してください。
収益プロバイダからのイベントの送信
RevenueCatや adaptyのようなサードパーティプロバイダーは、Singularに購入収益や購読収益を提供することができます。

これらのパートナーを有効にする方法の詳細については、以下のリンクを参照してください。

セグメントからのイベント送信

SingularSDKと並行してSegmentからSingularにイベントを送信するには、Segmentに"Cloud-Mode "Destinationを追加する必要があります。こちらのガイドに従ってください。

Unreal Engine SDKインテグレーションガイド

統合ガイド
  1. 基本的な統合
  2. イベントと収益のトラッキング
  3. ディープリンクの実装
  4. SKAdNetwork サポートの追加
  5. 高度なオプション