Currentsの設定

このページでは、Braze Currents の連携と設定を行う一般的なプロセスを概説します。

要件

弊社のパートナーと連携して Currents を使用するには、同じ基本パラメーターと接続方法が必要です。

各パートナーは Braze がデータファイルを書き込んでパートナーに送信する権限を有することを要求し、Braze は、それらのファイルをパートナーが書き込む場所、具体的にはバケット名またはキーを尋ねます。

以下の要件は、ほとんどのパートナーと連携するための基本的な最小要件です。パートナーによっては、追加のパラメーターが必要になります。それらのパラメーターは、これらの基本要件とのわずかな違いとともに、それぞれのパートナーのドキュメントにリストされています。

必要条件	起源	アクセス	説明
パートナー	そのパートナーにアカウントを手配するか、Brazeのアカウントマネージャーに提案を求める。	パートナーのサイトをチェックするか、パートナーに連絡して申し込む。	Brazeは、あなたの会社のアカウントを通じてそのデータにアクセスできない場合、パートナーにデータを送信しない。
パートナーAPIキーまたはトークン	通常はパートナーのダッシュボードである。	それをコピーして指定のBrazeフィールドに貼り付けるだけだ。	Brazeには、パートナーのIntegrationsページに、このための指定フィールドがある。これは、データの送信先をマッピングするために必要です。パートナーのキー / トークンを最新の状態に維持することが重要です。認証情報が無効の場合、コネクターが無効になり、イベントがドロップする可能性があります。
認証コード/キー、秘密キー、認証ファイル	そのパートナーのアカウント担当者に連絡する。パートナーのダッシュボードにも存在する可能性がある。	キーをコピーして指定のBrazeフィールドにペーストする。.json 、またはその他の認証ファイルを作成し、Brazeの適切な場所にアップロードする。	Brazeには、パートナーのIntegrationsページに、このための指定フィールドがある。これにより Braze に認証情報が付与され、パートナーでのお客様のアカウントに Braze がファイルを書き込むことができます。認証の詳細を最新の状態に維持することが重要です。認証情報が無効の場合、コネクターが無効になり、イベントがドロップする可能性があります。
バケツ、フォルダパス	一部のパートナーは、バケツごとにデータを整理し、分類している。これはパートナーのダッシュボードにあるはずだ。	これが必要な場合は、Bucket名またはファイルパスをBrazeの指定スペースに正確にコピーしておくこと。私たちは、あなたのデータが失われることを望んでいない！	これはパートナーによっては必要なことではあるが、必要なときに正しく行うことが重要だ。

ステップ 1: パートナーの選択

Braze Currents を使用すると、フラットファイルを使用したデータストレージ経由での連携、またはバッチ化された JSON ペイロードを指定されたエンドポイントに送信して、行動分析を行ったり顧客データを扱ったりするパートナーとの連携ができます。

連携を開始する前に、目的に最適な連携を決定することをお勧めします。例えば、すでに mParticle と Segment を利用していて、そこに Braze データをストリーミングする場合は、バッチ化された JSON ペイロードを使用することが最も優れた方法です。データを独自に操作する場合、またはより複雑なデータ分析システムがある場合は、データ ストレージを使用することが最も優れた方法です (Braze ではこの方法を採用)。

ステップ 2: Currents への移動

まず、[パートナー連携] > [データのエクスポート] に移動します。Currents の [連携管理] ページが表示されます。

ステップ 3:パートナーの追加

画面上部のドロップダウンをクリックして、パートナー (「Currents コネクター」とも呼ばれる) を追加します。

パートナーごとに異なる設定ステップが必要です。各連携を有効にするには、 利用可能なパートナー のリストを参照し、それぞれのページの指示に従います。

ステップ 4: イベントの設定

利用可能なオプションから、パートナーに渡すイベントのチェックボックスをオンにします。これらのイベントのリストは、顧客行動イベントライブラリとメッセージエンゲージメントイベントライブラリにあります。

必要に応じて、イベントの詳細について「イベント配信セマンティクス」の記事を参照してください。

ステップ 5: フィールド変換

Currents のフィールド変換を使用すると、Currents の特定の文字列フィールドの削除 (空の文字列に置換)、またはハッシュ (SHA-256 ハッシュアルゴリズムの適用) を指定できます。

これらのいずれかの変換を行う対象のフィールドを選択すると、そのフィールドのあるすべてのイベントにその変換が適用されます。例えば、ハッシュ化の対象として email_address を選択すると、メール送信数、メール開封数、メールバウンス数、サブスクリプショングループの状態の変更の email_address フィールドがハッシュ化されます。

ステップ 6: 連携のテスト

連携をテストしたり、Currents の例の GitHub リポジトリにあるサンプルの Currents データを確認したりできます。

Currents のテストコネクター

Currents のテストコネクターは、弊社の既存のコネクターの無料版であり、さまざまな送信先のテストと試行に使用できます。Currents のテストは次のとおりです。

• テストカレントコネクターの数に制限はない。
• 7日間につき、最大10,000件までとする。このイベントの合計はダッシュボードで 1 時間ごとに更新されます。

Test Currentsコネクタが送信上限に達すると、コネクタは次の7日間までイベントを送信しない。

Currents のテストコネクターをアップグレードするには、ダッシュボードで連携を編集し、[アップグレード] を選択します。

Currents の更新

To update your Currents connector after launching, do the following:

1. In Braze, navigate to Partner Integrations > Data Export.
2. Locate and your Currents connector in the list.
3. Select  Edit.
4. Make your changes.
5. Click Update Current.

This will not stop your existing export and will begin sending events according to your new selection.

IP許可リスト

Brazeは、リストアップされたIPからCurrentsデータを送信する。このデータは、許可リストにオプトインされたAPIキーに自動的に動的に追加される。

インスタンスについてUS-01 、US-02 、US-03 、US-04 、US-05 、US-06 、US-07 ：
127.0.0.1
23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスについてEU-01 とEU-02 ：
127.0.0.1
52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスの場合US-08 ：
52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145