アプリ内収益のトラッキング

アプリ内課金（IAP）、サブスクリプション、およびカスタム収益ソースからの収益を追跡して、キャンペーンのパフォーマンスと広告費用対効果（ROAS）を測定します。

収益データは3つのチャネルを通じて流れます：

• インタラクティブレポート： Singularダッシュボードで収益指標を表示
• ログのエクスポート： カスタム分析のための詳細なETLデータへのアクセス
• リアルタイムポストバック： 収益イベントを外部プラットフォームへ送信

収益イベントのガイドライン

収益イベントの制限

収益イベントの送信

シンプルな収益トラッキング

イベント名、通貨コード、トランザクション金額を入力して収益イベントをSingularに送信し、基本的な購入データをトラッキングします。

// Example 1: Basic purchase tracking
USingularSDKBPLibrary::SendRevenue(TEXT("Purchase Completed"), TEXT("USD"), 9.99f);

// Example 2: Subscription purchase
USingularSDKBPLibrary::SendRevenue(TEXT("SubscriptionPurchase"), TEXT("USD"), 29.99f);

// Example 3: In-game currency purchase
USingularSDKBPLibrary::SendRevenue(TEXT("CoinPackagePurchase"), TEXT("EUR"), 4.99f);

// Example 4: Premium item purchase
USingularSDKBPLibrary::SendRevenue(TEXT("PremiumItemPurchase"), TEXT("GBP"), 19.99f);

メソッドの署名 ：

static void SendRevenue(FString eventName, FString currency, float amount);

属性による収益追跡

商品SKU、カテゴリー、プロモコードなどのトランザクションの詳細を取得するために、カスタムパラメータを追加して収益イベントを送信します。

// Example 1: Revenue with product details
TMap<FString, FString> PurchaseArgs;
PurchaseArgs.Add(TEXT("product_id"), TEXT("coin_pack_100"));
PurchaseArgs.Add(TEXT("product_name"), TEXT("100 Coin Pack"));
PurchaseArgs.Add(TEXT("product_category"), TEXT("currency"));
USingularSDKBPLibrary::SendRevenueWithArgs(
    TEXT("Purchase Completed"), 
    TEXT("USD"), 
    4.99f, 
    PurchaseArgs
);

// Example 2: Subscription with billing details
TMap<FString, FString> SubArgs;
SubArgs.Add(TEXT("subscription_tier"), TEXT("premium"));
SubArgs.Add(TEXT("billing_period"), TEXT("monthly"));
SubArgs.Add(TEXT("trial_period"), TEXT("false"));
SubArgs.Add(TEXT("renewal_count"), TEXT("3"));
USingularSDKBPLibrary::SendRevenueWithArgs(
    TEXT("SubscriptionRenewal"), 
    TEXT("USD"), 
    9.99f, 
    SubArgs
);

// Example 3: Purchase with promotional discount
TMap<FString, FString> PromoArgs;
PromoArgs.Add(TEXT("product_id"), TEXT("bundle_mega_001"));
PromoArgs.Add(TEXT("promo_code"), TEXT("SUMMER2025"));
PromoArgs.Add(TEXT("discount_amount"), TEXT("5.00"));
PromoArgs.Add(TEXT("original_price"), TEXT("19.99"));
USingularSDKBPLibrary::SendRevenueWithArgs(
    TEXT("BundlePurchase"), 
    TEXT("USD"), 
    14.99f, 
    PromoArgs
);

// Example 4: IAP with transaction metadata
TMap<FString, FString> IAPArgs;
IAPArgs.Add(TEXT("platform"), TEXT("google_play"));
IAPArgs.Add(TEXT("transaction_id"), TEXT("GPA.1234-5678-90AB"));
IAPArgs.Add(TEXT("item_type"), TEXT("consumable"));
IAPArgs.Add(TEXT("user_level"), TEXT("42"));
USingularSDKBPLibrary::SendRevenueWithArgs(
    TEXT("IAP_Consumable"), 
    TEXT("USD"), 
    2.99f, 
    IAPArgs
);

メソッドの署名

static void SendRevenueWithArgs(FString eventName, FString currency, float amount, TMap<FString, FString> args);

収益追跡のベストプラクティス

推奨属性

包括的なトランザクション追跡のために、収益イベントにこれらの一般的な属性を含めます：

• product_id： 購入商品またはSKUの一意識別子
• product_name: 人間が読める商品名
• product_category（商品カテゴリー product_category：商品のカテゴリーまたはタイプ（例："currency"、"weapons"、"subscription")
• transaction_id： 決済プラットフォームからの一意のトランザクション識別子
• プラットフォーム： 購入プラットフォーム (例: "app_store", "google_play", "steam")
• promo_code： 割引に使用されるプロモーションコード
• user_tier： ユーザーのサブスクリプションまたはメンバーシップの階層
• 数量 購入したアイテムの数

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

最適なアトリビューションのために、アプリに統合されたSingular SDKを通してすべてのイベントと収益を送信します。ただし、Singularは必要に応じて他のソースからイベントを収集することができます。

Singular SDK以外で送信されるイベントは、Singularの Server-to-Server Event documentationに 準拠し、正しいアトリビューションのために一致するデバイス識別子を提供する必要があります。

ハイブリッドイベントトラッキングオプション

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

クライアントサイドのトラッキングが不十分な場合、内部サーバーから収益データを収集し、キャンペーンのパフォーマンスとROIを分析します。

要件

• デバイス識別子の取得 アプリ内登録またはログインイベント中に、デバイス識別子を取得して渡し、このデータをユーザーIDとともにサーバーに保存します。ユーザーが新しいアプリセッションを生成したときに識別子を更新し、正しいアトリビューションを確保します。
• プラットフォーム固有の識別子： プラットフォーム（iOSデバイスのIDFAまたはIDFV、AndroidデバイスのGAIDなど）に一致するデバイス識別子でサーバーサイドのイベントを送信します。
• リアルタイム更新： Singularの内部BIポストバックメカニズムを使用して、エンドポイントにリアルタイムでイベントをプッシュします。 内部BIポストバックのFAQを 参照してください。
• 実装の詳細： サーバー間統合ガイドの 「収益の追跡」 セクションを参照してください。

収益プロバイダからのイベントの送信

RevenueCatやadaptyのようなサードパーティの収益プロバイダーを統合して、購入や購読の収益をSingularに送信します。

サポートしているプロバイダー

• RevenueCat： 詳細は RevenueCatのドキュメントを ご覧ください。
• adapty 詳細は adaptyのドキュメントを ご覧ください。
• Superwall 詳細は Superwallのドキュメントを ご覧ください。
• Xsolla 詳細は Xsollaのドキュメントを ご覧ください。

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

Segmentに "Cloud-Mode "送信先を追加して、Singular SDKと並行してSingularにイベントを送信できるようにします。

詳細な設定方法については、実装ガイドの Singular-Segment Integrationに従って ください。