Singular Unreal Engine SDK
ダウンロード	Singular Unreal Engine SDK バージョン 2.4.0
互換性	アンリアルエンジン 4.23+
インテグレーションガイド	基本的なインテグレーションイベントと収益のトラッキングディープリンクの実装 SKAdNetwork サポートの追加高度なオプション

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

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

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

アプリからSingularにイベントを送信するには、SendEventとSendEventWithArgs メソッドを使用します。

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

SingularSDK SendEvent メソッド
説明	トラッキング用のユーザーイベントをカスタムイベント名で Singular に送信します。
シグネチャ	`public static void SendEvent(FString eventName)`
使用例	`// パラメータを指定せずに名前だけを指定してイベントを送信します 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)` 注意:通貨は ISO 4217 の 3 文字の通貨コード、たとえば"USD", "EUR", "INR" で渡します。
使用例	`// 製品の詳細を含む収益イベントを送信する 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 イベントリクエストで使用されるデバイス識別子が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を追加する必要があります。こちらのガイドに従ってください。

Singular Unreal Engine SDK
統合ガイド	基本的な統合イベントと収益のトラッキングディープリンクの実装 SKAdNetwork サポートの追加高度なオプション

Unreal Engine SDK：追跡イベントと収益

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

収益のトラッキング

ハイブリッドイベントトラッキング（上級者向け）

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