Brazeの設定
BrazeはAdjustと連携しているアナリティクスパートナーです。Adjustとの連携により、 Brazeは自動コールバックを通じてデータを受信します。このデータをパートナーのツールで使用して、分析データとインサイトを得ることができます。
ここでは、Brazeとアプリ計測を設定する方法を説明します。 連携を有効化し、AdjustがBrazeと共有できるデータを選択する方法をご確認ください。
事前準備
要件
- Adjustアカウントの管理者、編集者またはカスタム編集者のアクセス権限。
- Adjust SDK v4.0.0以降を実装することで、SDKパラメーターをBrazeパラメーターにマッピングできます。この機能を使用するには、以下のリンク先のガイドに従ってください。
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
認証情報
INSTALL API KEY、EVENT API KEY、およびENDPOINT
- 認証情報を確認するには、Brazeの担当者にお問い合わせください。
Campaign LabでBrazeとアプリを選択
- Campaign Labにて、 パートナー(Partner) を選択します。
- 新規パートナー(New partner) > Braze を選択します。 次へ(Next) を選択して、次の画面に移動します。
- アプリの選択(App selection) 画面で、リンクを作成したいアプリを選択し、 Brazeのデータ共有をするため連携を有効化します。
- 次(NEXT) を選択します。
データ共有を有効化
データ共有を有効化すると、Brazeとの連携が有効化されます。データ共有を有効化する方法は以下のとおりです:
- INSTALL API KEY、EVENT API KEY、およびENDPOINTを入力します。
Brazeとのデータ共有を有効化すると、デフォルトでは、Brazeに以下のデータが自動送信されます:
- インストール
- イベント
データ共有オプションの設定
マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です:
- プラットフォーム固有の設定を使用(Use platform-specific settings) を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
- グローバル設定を使用(Use global settings) を選択して、複数のプラットフォームに同じデータ共有設定を行います。
デフォルトで共有するデータ(What will be shared by default?) にて、Adjustがデフォルトで Brazeと共有するアクティビティを確認してください。
- インストール
- イベント
追加データの送信
コールバックによりBrazeと共有するデータ量とタイプを選択します。 Brazeはこの情報を使用して、パフォーマンスを最適化することができます。
追加データを送信するには、以下を確認またはカスタマイズしてください:
アプリ内収益(アプリ内購入由来)
アプリ内収益を共有すると、 Brazeは収益イベントデータと収益額を受信することができます。このデータを共有するには、収益が発生するイベントをマッピングしてください。
パラメーターのマッピング
通常、カスタムデータをBrazeと共有するには、パラメーターをマッピングする必要があります。
パートナーパラメーター(Adjust SDKバージョン4.0以降で使用可能)によって、Adjustはアプリからカスタムデータポイントを収集し、Brazeに送信することができます。 これにより、Brazeは連携しているイベントごとにカスタムイベントの詳細を受信するようになります。
Adjust SDKに新しいパートナーパラメーターを追加する前に、要件に合うパートナーパラメーターが存在していないことを確認してください。
パートナーパラメーターをBrazeに共有するには、以下の手順に従って設定してください。
AdjustのSDKでパートナーパラメーターを実装します。
- 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください
データ共有オプションの設定(Set your data sharing option) で、 パラメーターを選択します。
パラメーターのマッピング(Map parameters)では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。
- パラメーターのマッピング(Map parameters)を選択します。
- SDKパラメーター(SDK parameter)フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
- パートナーパラメーター(Partner parameter)フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。
Adjust SDK内でパートナーパラメーターを設定し、ダッシュボードでパラメーター共有を設定しない場合、AdjustはAdjust SDKで指定されているパラメーターを転送します。
アプリでBrazeを有効化
設定のレビュー(Setup review) 画面では 、選択した内容を確認できます。前に戻って、以下の変更も行えます:
- 選択したアプリ
- データ共有オプション
パートナーを有効化(Enable partner) を選択して、アプリで Braze を有効化します。アナリティクスパートナーはキャンペーンのリンクを処理しません。一度有効にすると、アトリビューションおよびアプリ内イベントデータが自動コールバックで送信されます。
パートナー固有の設定手順
Note-- the Endpoint protocol should not be entered; so please ensure that you do not include _https://_
in the activation field. Last but not least, be aware that Braze requires specific parameters in order to receive callback data.
Predefined parameters
Braze allows you to send a set of predefined parameters. If you attach any of these parameters to an event in your adjust SDK, these will be forwarded to Braze. You can find out more about attaching partner parameters in the SDK readme specific to the SDK or SDKs you are working with. Below is a list of the defined parameters that Braze accepts:
Parameter key > Value
- external_id > mandatory for sending events to Braze
- braze_device_id > mandatory for sending any Android data to Braze
- product_id > mandatory for sending revenue events to Braze
To send event callbacks to Braze, you must implement "external_id" as an event partner parameter within the Adjust SDK. For revenue event forwarding, you should also set up product_id as a partner parameter for events.
For Android apps, you must also implement "braze_device_id" as both a session and event partner parameter. Finally, for revenue event forwarding, you must also set up "product_id" as a partner parameter for revenue events. Please note that Braze does not support Organic, Facebook, or Twitter data so callbacks for these trackers will not be sent.
Callbacks
Currently Adjust don't forward Organic, Facebook and Twitter campaign data to Braze.
If you would like to find out more about how to leverage this integration for your use cases, check out our one pager with Braze . In case of any questions related to the information provided on the one pager, please reach out to partners@adjust.com .
Brazeに転送されるパラメーター一覧
Adjustは、Brazeに以下のパラメーター(データポイント)をコールバック送信するよう要求されています。
プレースホルダー | 情報 |
{currency} | Adjust SDKから送信されたオリジナルのISO 4217通貨コード |
{idfa} | 広告ID(iOSのみ) |
{partner_parameters} | Adjust SDK あるいは S2S のリクエストにより、ポストバックを通じてサードパーティプロバイダに送信されるカスタムパートナーパラメーター |
{revenue} | Adjust SDKから送信された収益(セント) |
{win_adid} | Windowsの広告ID |
{adgroup_name} | トラッカーから取得したアドグループ名 |
{app_id} | アプリID(Store App ID)あるいはGoogle Playストア |
{campaign_name} | トラッカーから取得したキャンペーン名 |
{created_at} | アクティビティのタイムスタンプ |
{creative_name} | トラッカーから取得したクリエイティブ名 |
{network_name} | トラッカーから取得したネットワーク名 |