このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

Kochava

Kochavaは、モバイルのアトリビューションと分析を提供し、成長のためのデータ活用を支援します。Kochava Audience Platformでは、アプリキャンペーンの計画、ターゲティング、アクティベーション、測定、最適化を実施できます。

この統合はKochavaによって管理されています。

連携について

BrazeとKochavaの連携は、アトリビューションデータをBrazeに送信することで、キャンペーンのより包括的な理解を促進します。これにより、どのキャンペーンがインストール、アプリ内アクティビティなどを促進しているかをより的確に把握できます。

前提条件

要件	説明
Braze SDK	この連携にはBraze モバイルSDKが必要です。BrazeはBraze SDKが作成・登録するデバイス識別子を使用して、Kochavaのアトリビューションポストバックをユーザープロファイルに照合します。Brazeから`device_id`の値をエクスポートしてオフラインでKochavaに渡すことは、Braze SDKの連携の代替手段としてサポートされていません。
Kochavaアカウント	このパートナーシップを活用するには、Kochavaアカウントが必要です。
iOSまたはAndroidアプリ	この連携はiOSおよびAndroidアプリをサポートしています。プラットフォームに応じて、アプリケーションにコードスニペットが必要になる場合があります。これらの要件の詳細については、連携プロセスのステップ1を参照してください。
Kochava SDK	Braze SDKに加えて、Kochava SDKをインストールする必要があります。

連携

ステップ1:ユーザー IDのマッピング

このステップでは、アプリにBraze SDKが必要です。プラットフォームに応じて、アプリはBraze SDKからBrazeデバイス識別子（device_id）をKochavaに渡す必要がある場合があります。これにより、Kochavaがアトリビューションデータを Brazeに送り返す際に、Brazeがそのデータを正しいユーザープロファイルに照合できるようになります。マッピングが必要なタイミングについては、AndroidとiOSのセクションを参照してください。

Android

Braze SDKはデバイス識別子（device_id）を生成します。アプリはこの識別子を取得し、KochavaのIdentityLinkメソッドに渡す必要があります。これにより、KochavaがBrazeに送り返すアトリビューションデータにdevice_idを含めることができ、Brazeがアトリビューションイベントを正しいユーザープロファイルに照合できるようになります。

Brazeのdevice_idを次のメソッドで取得します:

Braze.getInstance(context).getDeviceId();

iOS

重要

2023年2月以前、Kochavaアトリビューション連携では、iOSアトリビューションデータを照合するための主要な識別子としてIdentifier for Vendor（IDFV）を使用していました。Objective-Cを使用しているBraze顧客は、サービスの中断がないため、インストール時にBrazeのdevice_idを取得してKochavaに送信する必要はありません。

Swift SDK v5.7.0以降では、BrazeがデバイスIDとしてIDFVを使用するか、ランダムに生成されたUUIDを使用するかを設定できます。Swift SDK v7.0.0以降では、useUUIDAsDeviceIdはデフォルトでtrueになっているため、このフィールドをfalseに設定しない限り、新規ユーザーにはUUIDのdevice_idが割り当てられます。詳細については、IDFVの収集を参照してください。

KochavaとのIDFVを共通の識別子として維持するには、useUUIDAsDeviceIdをfalseに設定します。
useUUIDAsDeviceIdがtrue（v7.0.0以降のデフォルト）の場合は、アプリインストール時にBrazeのdevice_idをKochavaに渡して、BrazeがiOSアトリビューションを照合できるようにします。

以下のノンブロッキングAPIのいずれかを使用してBrazeのdevice_idを取得し、KochavaのiOS SDKの手順に従って、その値をKochavaに渡します。追加のサポートが必要な場合は、Kochavaサポートにお問い合わせください。

コンプリーションハンドラ

AppDelegate.braze?.getDeviceId { deviceId in
  // Pass `deviceId` to Kochava
}

Swift Concurrency

let deviceId = await AppDelegate.braze?.getDeviceId()

ステップ2:Brazeデータインポートキーの取得

Brazeで、パートナー連携 > テクノロジーパートナーに移動し、Kochavaを選択します。

ここでRESTエンドポイントを確認し、Brazeデータインポートキーを生成できます。キーが生成されたら、新しいキーを作成するか、既存のキーを無効にできます。データインポートキーとRESTエンドポイントは、次のステップでKochavaのダッシュボードでポストバックを設定する際に使用されます。

Kochavaテクノロジーページにある「インストールアトリビューションのデータインポート」ボックスを示す画像。このボックスには、データインポートキーとRESTエンドポイントが表示されています。

ステップ3:Kochavaからのポストバックの設定

Kochavaダッシュボードでポストバックを追加します。Brazeダッシュボードで確認したデータインポートキーとRESTエンドポイントの入力を求められます。

ステップ4:連携の確認

BrazeのKochavaテクノロジーパートナーページでは、ステップ2でデータインポートAPIキーを生成するまで、接続インジケーターにNot Connectedと表示されます。キーを生成すると、インジケーターはConnectedに変わり、タイムスタンプが表示されます。このタイムスタンプは、Kochavaが最後にポストバックを送信した時点ではなく、Brazeで連携が最初に設定された時点（データインポートキーが作成された時点）を示します。

Kochavaからインストールアトリビューションデータが正しく送信されているか確認するには、Brazeのセグメントフィルターに非オーガニックインストールデータが表示されているかを確認します。Brazeは、アトリビューションソースがorganicの場合、Kochavaポストバックからのオーガニックインストールを無視し、アトリビューションインストールデータとして保存しません。

FacebookおよびX（旧Twitter）のアトリビューションデータ

FacebookおよびX（旧Twitter）キャンペーンのアトリビューションデータは、パートナーを通じて取得することができません。これらのメディアソースは、パートナーがアトリビューションデータを第三者と共有することを許可していないため、パートナーはそのデータをBrazeに送信することができません。

Braze での Kochava クリックトラッキング URL（オプション）

Braze キャンペーンのクリックトラッキングリンクを使用すると、どのキャンペーンがアプリのインストールやリエンゲージメントを促進しているかを確認できます。これにより、マーケティング活動をより効果的に測定し、最大の ROI を得るためにどこにリソースを投資すべきかデータドリブン型の意思決定ができます。

Kochava のクリックトラッキングリンクを使い始めるには、Kochava のドキュメントをご覧ください。Kochava のクリックトラッキングリンクは、Braze キャンペーンに直接挿入できます。その後、Kochava は確率的アトリビューション手法を使用して、リンクをクリックしたユーザーをアトリビューションします。Braze キャンペーンからのアトリビューションの精度を向上させるため、Kochava トラッキングリンクにデバイス識別子を追加することをお勧めします。これにより、リンクをクリックしたユーザーを確定的にアトリビューションできます。

android
ios

Android の場合、Braze ではGoogle 広告 ID（GAID）の収集にオプトインできます。GAID は Kochava SDKの連携を通じてもネイティブに収集されます。以下の Liquid ロジックを使用して、Kochava のクリックトラッキングリンクに GAID を含めることができます。

{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

iOS の場合、確定的アトリビューションを改善するために Braze デバイス識別子を追加します。Liquid では、most_recently_used_device.${id} は Braze デバイス ID であり、Swift SDKの useUUIDAsDeviceId 設定に応じて IDFV または UUID になります。Kochava のクリックトラッキング URL では、通常この値に idfv クエリパラメーターを使用します。

{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}

注

この推奨事項は完全にオプションです
現在、クリックトラッキングリンクで Braze デバイス ID や GAID などのデバイス識別子を使用していない場合、または今後使用する予定がない場合でも、Kochava は確率的モデリングを通じてこれらのクリックをアトリビューションできます。

New Stuff!