ドキュメント

SingularとBrazeの統合は、モバイルアトリビューションデータを貴社の顧客エンゲージメントプラットフォームに直接取り込むことで、貴社のマーケティング能力を強化します。このシームレスな接続により、よりターゲットを絞った効果的なライフサイクルマーケティングキャンペーンの実施が可能になります。

重要

データ共有制限のある広告ネットワークでは、サードパーティパートナーへのポストバック送信を防止するため、設定されたポストバック設定が上書きされます。サードパーティとのデータ共有が制限されているメディアソースについては、こちらをご覧ください。

前提条件

必要条件	説明
iOSまたはAndroidアプリ	この統合はiOSとAndroidアプリをサポートしています。プラットフォームによっては、アプリケーションにコードスニペットが必要な場合があります。これらの要件の詳細は、統合プロセスのステップ1に記載されています。
Singular SDKとBraze SDK	必要なBraze SDKに加えて、Singular SDKをインストールする必要があります。

インテグレーション

Brazeインテグレーションを完了するには、Singular SDKインテグレーションをアップデートし、SingularのGlobal Properties経由でBrazeデバイスIDを渡す必要があります。Global Propertiesに関するSDKドキュメント（Android SDKドキュメントおよびiOS SDKドキュメント）を参照してください。

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

Android

Androidアプリをお持ちの場合は、Singularに一意のBrazeユーザーIDを渡す以下のコードスニペットを含める必要があります。

// Retrieve the Braze deviceId

val brazeDeviceID = Braze.getInstance(context).deviceId

// Set the Singular Global Property in the Singular Config

val config = SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true)

// Retrieve the Braze deviceId

String brazeDeviceID = Braze.getInstance(context).getDeviceId();

// Set the Singular Global Property in the Singular Config

SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true);

iOS

重要：

2023年2月以前のSingularアトリビューション統合では、iOSアトリビューションデータを照合するための主要な識別子としてIDFVを使用していました。Objective-Cを使用しているBrazeのお客様は、インストール時にBrazeのdevice_idを取得してSingularに送信する必要はありません。

Swift SDK v5.7.0+を使用している場合、相互識別子としてIDFVを引き続き使用する場合は、useUUIDAsDeviceId フィールドがfalse に設定されていることを確認する必要があります。

true に設定されている場合は、BrazeがiOSの属性と適切に一致するように、アプリインストール時にBrazeのdevice_idをSingularに渡すために、Swift用のiOSdevice ID マッピングを実装する必要があります。

// Retrieve the Braze deviceId

let brazeDeviceId = AppDelegate.braze?.deviceId

// Set the Singular Global Property in the Singular Config

config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)

// Retrieve the Braze deviceId

NSString *brazeDeviceId = ((AppDelegate *)[UIApplication sharedApplication].delegate).braze.deviceId;

// Set the Singular Global Property in the Singular Config

[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId overrideExisting:YES];

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

Brazeで、Partner Integrations > Technology Partners に移動し、Singularを選択します。

注：古いナビゲーションをお使いの場合は、Integrationsの下にTechnology Partnersがあります。

ここでRESTエンドポイントを見つけ、Brazeデータインポートキーを生成します。キーが生成されたら、新しいキーを作成するか、既存のキーを無効にすることができます。

統合を完了するには、データインポートキーとRESTエンドポイントをSingularアカウントマネージャーに提供する必要があります。

ステップ3：Brazeポストバックを有効にする

Singularの左メニューからAttribution > Partner Configurationに移動します。

Add Partner"ボタンをクリックし、"Braze"を検索します。
アプリを選択します。
前のステップで受け取ったBrazeデータインポートキーを入力します。
Brazeドメイン名を選択します。
保存をクリックします。

ステップ4：統合の確認

BrazeがSingularからアトリビューションデータを受信すると、BrazeのSingularテクノロジーパートナーページのステータス接続インジケータが「未接続」から「接続済み」に変わります。最後に成功したリクエストのタイムスタンプも表示されます。

これは、帰属するインストールに関するデータを受け取るまで起こらないことに注意してください。Singularのポストバックから除外されるべきオーガニックインストールは、APIによって無視され、接続が成功したかどうかを判断する際にカウントされません。