Branch
Branch を使うと、さまざまなデバイス・チャネル・プラットフォームをまたいでユーザーへのリーチ、エンゲージメント、効果測定ができます。あらゆるデバイス・チャネル・プラットフォームで機能する専用リンクを通じて、モバイル収益を高めるために設計された使いやすいプラットフォームです。
Adapty は、ストアからのサブスクリプションイベントを一か所で追跡できる完全なデータセットを提供します。Adapty を使えば、サブスクライバーの行動を簡単に把握し、好みを理解した上で、ターゲットを絞った効果的なコミュニケーションに役立てることができます。
Adapty と Branch の連携は、主に 2 つの方法で動作します。
-
Branch からアトリビューションデータを受信する
Branch 連携を設定すると、Adapty は Branch からアトリビューションデータを受信し始めます。このデータはユーザーのプロファイルページで簡単に確認できます。
-
サブスクリプションイベントを Branch に送信する
Adapty は、連携で設定されたすべてのサブスクリプションイベントを Branch に送信できます。これにより、Branch ダッシュボード内でこれらのイベントを追跡し、獲得キャンペーンと紐付けることができます。
連携のセットアップ
Adapty を Branch に接続する
Branch を連携するには、Adapty ダッシュボードの Integrations > Branch に移動し、トグルをオンにして各フィールドに入力してください。
Branch Key の値を取得するには、Branch の Account Settings を開き、Branch Key フィールドを確認してください。Adapty ダッシュボードの Key test(サンドボックス用)または Key live(本番用)フィールドに使用します。Branch 側では、Live と Test の環境を切り替えて適切なキーを取得してください。
イベントとタグを設定する
認証情報の下には、Adapty から Branch に送信できるイベントが 3 つのグループに分かれています。必要なものをオンにするだけです。Adapty が提供するイベントの全一覧はこちらで確認できます。
収益(Apple/Google の手数料差し引き後)または売上金額のみでイベントを送信できます。また、ユーザーの通貨でレポートするチェックボックスもあります。
Adapty が提供するデフォルトのイベント名を使用することを推奨します。ただし、必要に応じてイベント名を変更することも可能です。
Adapty はサーバー間連携を使って Branch にサブスクリプションイベントを送信するため、Branch ダッシュボードですべてのサブスクリプションイベントを確認し、獲得キャンペーンと紐付けることができます。
アプリを Branch に接続する
.setIntegrationIdentifier()SDK メソッドを呼び出して接続を初期化します。Branch の Identity ID をcustomerUserIdパラメータに渡すことができます。
サードパーティSDKはユーザーIDを非同期で生成します。Adapty.activate() の実行時にIDがまだ準備できていない場合があります。Customer User ID がこれらのSDKのいずれかから取得される場合は、IDなしで Adapty.activate() を呼び出してください。IDが取得できたら、setIntegrationIdentifier() を呼び出し、次にCUIDで identify() を呼び出してください。
.updateAttribution()メソッドを使用してアトリビューションデータを保存します。前のステップで Branch のユーザー ID を指定しなかった場合は、ここでnetworkUserIdパラメータに渡してください。
イベント構造
Adapty は、Branch Integration ページの Events names セクションで設定された内容に従って、選択したイベントを Branch に送信します。各イベントは次のような構造になっています:
{
"branch_key": "key_live_kaFuWw8WvY7n1ss7...",
"name": "PURCHASE",
"user_data": {
"os": "iOS",
"developer_identity": "user_12345",
"country": "US",
"ip": "192.168.100.1",
"idfa": "00000000-0000-0000-0000-000000000000",
"idfv": "00000000-0000-0000-0000-000000000000",
"aaid": "00000000-0000-0000-0000-000000000000"
},
"event_data": {
"transaction_id": "GPA.3383-4699-1373-07113",
"revenue": 9.99,
"currency": "USD"
},
"custom_data": {
"vendor_product_id": "yearly.premium.6999",
"original_transaction_id": "GPA.3383-4699-1373-07113",
"store": "play_store",
"environment": "production"
}
}
各パラメータの説明:
| パラメータ | 型 | 説明 |
|---|---|---|
branch_key | String | Branch Key。 |
name | String | Branch イベント名(Adapty イベントからマッピングされたもの。例:“PURCHASE”)。 |
user_data | Object | ユーザー情報。 |
user_data.os | String | ”Android” または “iOS”。 |
user_data.developer_identity | String | ユーザーの Customer User ID。 |
user_data.country | String | ユーザーの IP に基づく国コード。 |
user_data.ip | String | ユーザーの IP アドレス。 |
user_data.idfa | String | iOS のみ。広告主向け識別子(ID for Advertisers)。 |
user_data.idfv | String | iOS のみ。ベンダー向け識別子(ID for Vendors)。 |
user_data.aaid | String | Android のみ。Google 広告 ID。 |
event_data | Object | 標準イベント指標(PURCHASE など該当イベントにのみ含まれます)。 |
event_data.transaction_id | String | ストアのトランザクション ID。 |
event_data.revenue | Float | 収益額。 |
event_data.currency | String | 通貨コード(例:“USD”)。 |
custom_data | Object | 詳細なイベント属性(利用可能なすべてのイベントフィールドを含みます)。 |