Tenjin連携

Tenjin は、アプリ開発者やマーケター向けのモバイルアトリビューション・分析プラットフォームです。広告ネットワークやアプリストアからデータを集約し、ROI の分析、コンバージョンのトラッキング、主要なパフォーマンス指標のモニタリングを可能にすることで、ユーザー獲得キャンペーンを計測・最適化するためのツールを提供します。透明性が高く柔軟なアプローチにより、チームはアプリのパフォーマンスやユーザー行動に関する詳細なインサイトを得ることができます。

サブスクリプションイベントをTenjinに転送することで、コンバージョンの発生源や、すべてのチャネル・プラットフォーム・デバイスにわたって最も価値をもたらすキャンペーンを正確に把握できます。Tenjinのダッシュボードは、マーケティングキャンペーン向けの高度な分析機能を提供します。

TenjinのアトリビューションをAdaptyに転送することで、Adaptyの分析にコホート分析やコンバージョン分析で使用できる追加のフィルタリング条件を加えることができます。

このインテグレーションは、2つの主要な方法で機能します。

TenjinからのアトリビューションデータをAdaptyが受信する 統合後、AdaptyはTenjinからアトリビューションデータを収集します。この情報は、Adapty ダッシュボードのユーザープロファイルページで確認できます。
サブスクリプションイベントをTenjinに送信する Adatyはリアルタイムで購入イベントをTenjinに送信します。これらのイベントは、Tenjinのダッシュボード上で広告キャンペーンの効果を直接評価するのに役立ちます。

統合の特性	説明
スケジュール	リアルタイム
データの方向	双方向通信： Adapty イベント：Adapty サーバーから Tenjin サーバーへ Tenjin アトリビューション：Tenjin SDK から Adapty サーバーへ
Adapty 統合ポイント	モバイルアプリのコードに組み込まれた Tenjin および Adapty SDK Adapty サーバー

統合の特性

説明

スケジュール

リアルタイム

データの方向

双方向通信：

Adapty イベント：Adapty サーバーから Tenjin サーバーへ
Tenjin アトリビューション：Tenjin SDK から Adapty サーバーへ

Adapty 統合ポイント

モバイルアプリのコードに組み込まれた Tenjin および Adapty SDK
Adapty サーバー

連携のセットアップ

AdaptyをTenjinに接続する

Adapty DashboardのIntegrations -> Tenjinページを開きます。
トグルを有効にして連携をアクティブにします。
Tenjin Dashboardにログインします。
ナビゲーションメニューでConfiguration -> Appsに移動します。
お使いのプラットフォーム（iOSまたはAndroid）のアプリを選択し、App and SDKタブに移動します。
App and SDKタブで、SDK Key列のCopyをクリックします。SDKキーがまだない場合は、Generate SDK Keyボタンをクリックして作成します。
Adapty Dashboardに戻り、コピーしたSDKキーを対応するプラットフォームのフィールドに貼り付けます：
- iOSアプリの場合：iOS SDK KeyまたはiOS Sandbox SDK Keyフィールドに貼り付けます
- Androidアプリの場合：Android SDK KeyまたはAndroid Sandbox SDK Keyフィールドに貼り付けます
Info

Tenjinにはサーバー間連携向けの専用サンドボックスモードはありません。本番環境とサンドボックスイベントの両方に、別のTenjinアプリまたは同じキーを使用してください。
両方のプラットフォームにアプリがある場合は、もう一方のプラットフォームについて手順5〜7を繰り返します。
（任意）必要に応じてHow the revenue data should be sentセクションを調整します。設定の詳細については、連携設定を参照してください。
Saveをクリックしてセットアップを完了します。

これでAdaptyはTenjinに購入イベントを送信し、アトリビューションデータを受信します。Events namesセクションでイベントの共有を調整できます。

イベントとタグを設定する

Tenjinは購入イベントとTrial startedイベントのみを受け付けます。Events namesセクションで、トラッキング目標に合わせてTenjinと共有するイベントを選択します。

アプリをTenjinに接続する

Tenjinからアトリビューションデータを取得してAdaptyに渡すには、Adapty.updateExternalAttribution() SDKメソッド（SDK バージョン4.1より前は updateAttribution() という名前）を使用してください。


func updateTenjinId() {
    guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }

    do {
        try await Adapty.setIntegrationIdentifier(.tenjinAnalyticsInstallationId(tenjinId))
    } catch {
        // handle the error
    }
}

func updateTenjinAttribution() {
    let instance = TenjinSDK.getInstance("<YOUR_TENJIN_API_TOKEN>")
        
    instance?.getAttributionInfo { info, _ in
        guard let info else { return }

        Task {
            do {
                try await Adapty.updateExternalAttribution(info, provider: .tenjin)
            } catch {
                // handle the error
            }
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.analyticsInstallationId) { error ->
    if (error != null) {
        // handle the error
    }
}

tenjinSdk.getAttributionInfo { attribution ->
    if (attribution == null) return@getAttributionInfo

    Adapty.updateAttribution(attribution, "tenjin") { error ->
        if (error != null) {
            // handle the error
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.getAnalyticsInstallationId(), error -> {
    if (error != null) {
        // handle the error
    }
});

tenjinSdk.getAttributionInfo(attribution -> {
    if (attribution == null) return;

    Adapty.updateAttribution(attribution, "tenjin", error -> {
        // handle the error
    });
});

try {
    final tenjinId = await TenjinSDK.instance.getAnalyticsInstallationId();
    
    if (tenjinId != null) {
        await Adapty().setIntegrationIdentifier(
            key: 'tenjin_analytics_installation_id', 
            value: tenjinId,
        );
    }

    final attribution = await TenjinSDK.instance.getAttributionInfo();
    if (attribution != null) {
        await Adapty().updateAttribution(attribution, source: 'tenjin');
    }
} catch (e) {
    // handle the error
}

using AdaptySDK;
using System.Linq;

BaseTenjin instance = Tenjin.getInstance("<SDK_KEY>");
var tenjinId = instance.GetAnalyticsInstallationId();

Adapty.SetIntegrationIdentifier(
    "tenjin_analytics_installation_id",
    tenjinId,
    (error) => {
        // handle the error
    });

instance.GetAttributionInfo((attribution) => {
    var dynamicAttribution = attribution.ToDictionary(
        kvp => kvp.Key,
        kvp => (dynamic)kvp.Value
    );
                
Adapty.UpdateAttribution(
    dynamicAttribution,
    "tenjin",
    (error) => {
        // handle the error
    });
});


// ...
const posthog = usePostHog()

// ...
try {
  await adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", await Tenjin.getAnalyticsInstallationId());
} catch (error) {
  // handle `AdaptyError`
}

イベント構造

AdatyはTenjin Integration pageのEvents namesセクションで設定した選択済みイベントをTenjinに送信します。各イベントの構造は次のとおりです：

{
  "price": 99.0,
  "locale": "en-US",
  "country": "ME",
  "postcut": "false",
  "currency": "USD",
  "platform": "ios",
  "quantity": 1,
  "bundle_id": "com.adapty.adaptydemoapp",
  "ip_address": "127.0.0.1",
  "os_version": "18.1.1",
  "product_id": "month.premium.99",
  "app_version": "3.2.0",
  "sdk_version": "server",
  "device_model": "iPhone 13 Mini",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "os_version_release": "18.1.1",
  "developer_device_id": "00000000-0000-0000-0000-000000000000",
  "analytics_installation_id": "00000000-0000-0000-0000-000000000000"
}

各パラメーターの説明：

パラメータ	型	説明
price	Float	購入アイテムの通貨標準単位での単価（例：USDはドルで報告）。
locale	String	デバイスのロケール。Android: `Locale.getDefault().toString()`。iOS: `[[NSLocale currentLocale] localeIdentifier]`。
country	String	ISO ロケール国コード標準（例：US はアメリカ合衆国）。
postcut	String (Boolean)	プラットフォームの手数料差し引き後に購入が送信されたかどうかを示します。true の場合は 1、false の場合は 0。
currency	String	ISO 通貨コード（例：USD は米ドル）。
platform	String	デバイスのプラットフォーム（例：ios、android、windows、amazon）。
quantity	Integer	購入したユニット数。
bundle_id	String	アプリのバンドル識別子（例：`com.example.app`）。
ip_address	String (IPv4)	ユーザーの IP アドレス。国の特定に使用されます。
os_version	String	デバイスの OS バージョン。Android: `String.valueOf(Build.VERSION.SDK_INT)`。iOS: `[[UIDevice currentDevice] systemVersion]`。
product_id	String	購入したプロダクトの一意の識別子。
app_version	Float, Decimal	アプリのバージョン。Android: `context.getPackageManager().getPackageInfo()`。iOS: `[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"]`。
sdk_version	String	使用中の SDK バージョン。常に `server` に設定されます。
device_model	String	デバイスのモデル。Android: `Build.MODEL`。iOS: `sysctl("hw.machine")`。
advertising_id	UUID	デバイスの広告 ID。Android では必須。iOS では空またはすべてゼロでも可。
os_version_release	String	OS バージョンリリース。Android: `String.valueOf(Build.VERSION.RELEASE)`。iOS: `[[UIDevice currentDevice] systemVersion]`。
developer_device_id	UUID	ベンダー識別子（iOS のみ）。
analytics_installation_id	UUID	アナリティクスインストール ID。詳細は `https://docs.tenjin.com` のドキュメントを参照してください。

トラブルシューティング

イベントフィードで一部のイベントが失敗と表示される

Tenjin はイベントとタグの設定に記載されているイベントのみを受け付けます。それ以外のイベントはイベントフィードに行として表示されますが、「The event type is not supported for integration.」というツールチップとともに配信失敗としてマークされます。access_level_updated もその一つで、Events names セクションには表示されません。これはWebhook インテグレーション専用のイベントだからです。