Branch

Branch を使うと、さまざまなデバイス・チャネル・プラットフォームをまたいでユーザーへのリーチ、エンゲージメント、効果測定ができます。あらゆるデバイス・チャネル・プラットフォームで機能する専用リンクを通じて、モバイル収益を高めるために設計された使いやすいプラットフォームです。

Adapty は、ストアからのサブスクリプションイベントを一か所で追跡できる完全なデータセットを提供します。Adapty を使えば、サブスクライバーの行動を簡単に把握し、好みを理解した上で、ターゲットを絞った効果的なコミュニケーションに役立てることができます。

Adapty と Branch の連携は、主に 2 つの方法で動作します。

  1. Branch からアトリビューションデータを受信する
    Branch 連携を設定すると、Adapty は Branch からアトリビューションデータを受信し始めます。このデータはユーザーのプロファイルページで簡単に確認できます。

    49f4aa7-CleanShot_2023-08-11_at_17.36.072x.webp
  2. サブスクリプションイベントを Branch に送信する
    Adapty は、連携で設定されたすべてのサブスクリプションイベントを Branch に送信できます。これにより、Branch ダッシュボード内でこれらのイベントを追跡し、獲得キャンペーンと紐付けることができます。

連携のセットアップ

Adapty を Branch に接続する

Branch を連携するには、Adapty ダッシュボードの Integrations > Branch に移動し、トグルをオンにして各フィールドに入力してください。

817a051-CleanShot_2023-08-11_at_15.54.372x.webp

Branch Key の値を取得するには、Branch の Account Settings を開き、Branch Key フィールドを確認してください。Adapty ダッシュボードの Key test(サンドボックス用)または Key live(本番用)フィールドに使用します。Branch 側では、Live と Test の環境を切り替えて適切なキーを取得してください。

130e58b-CleanShot_2023-08-11_at_15.24.162x.webp

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

認証情報の下には、Adapty から Branch に送信できるイベントが 3 つのグループに分かれています。必要なものをオンにするだけです。Adapty が提供するイベントの全一覧はこちらで確認できます。

収益(Apple/Google の手数料差し引き後)または売上金額のみでイベントを送信できます。また、ユーザーの通貨でレポートするチェックボックスもあります。

a645cf8-CleanShot_2023-08-11_at_15.18.282x.webp

Adapty が提供するデフォルトのイベント名を使用することを推奨します。ただし、必要に応じてイベント名を変更することも可能です。

Adapty はサーバー間連携を使って Branch にサブスクリプションイベントを送信するため、Branch ダッシュボードですべてのサブスクリプションイベントを確認し、獲得キャンペーンと紐付けることができます。

アプリを Branch に接続する

  1. .setIntegrationIdentifier() SDK メソッドを呼び出して接続を初期化します。Branch の Identity ID を customerUserId パラメータに渡すことができます。

サードパーティSDKはユーザーIDを非同期で生成します。Adapty.activate() の実行時にIDがまだ準備できていない場合があります。Customer User ID がこれらのSDKのいずれかから取得される場合は、IDなしで Adapty.activate() を呼び出してください。IDが取得できたら、setIntegrationIdentifier() を呼び出し、次にCUIDで identify() を呼び出してください。

  1. .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_keyStringBranch Key。
nameStringBranch イベント名(Adapty イベントからマッピングされたもの。例:“PURCHASE”)。
user_dataObjectユーザー情報。
user_data.osString”Android” または “iOS”。
user_data.developer_identityStringユーザーの Customer User ID。
user_data.countryStringユーザーの IP に基づく国コード。
user_data.ipStringユーザーの IP アドレス。
user_data.idfaStringiOS のみ。広告主向け識別子(ID for Advertisers)。
user_data.idfvStringiOS のみ。ベンダー向け識別子(ID for Vendors)。
user_data.aaidStringAndroid のみ。Google 広告 ID。
event_dataObject標準イベント指標(PURCHASE など該当イベントにのみ含まれます)。
event_data.transaction_idStringストアのトランザクション ID。
event_data.revenueFloat収益額。
event_data.currencyString通貨コード(例:“USD”)。
custom_dataObject詳細なイベント属性(利用可能なすべてのイベントフィールドを含みます)。