Currents の設定

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

新しい連携を追加する際に「残りの Currents 連携がありません」と表示される場合、一般的な原因は次のとおりです。

• このワークスペースに対して Currents のエンタイトルメントが購入されていない。
• Currents のエンタイトルメントが、お客様の会社の別のワークスペースで利用可能になっている。

エンタイトルメントのリクエストや設定の調整については、Braze のアカウントマネージャーにお問い合わせください。

要件

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

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

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

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

Currents の設定

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

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

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

ステップ 2: Currents を開く

始めるには、[パートナー連携] > [Currents] に移動します。Currents の連携管理ページが表示されます。

ステップ 3: パートナーを追加する

画面上部のドロップダウンを選択し、パートナー（「Currents コネクター」と呼ばれることもあります）を追加します。

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

ステップ 4: イベントを設定する

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

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

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

Currents フィールド変換を使用して、文字列フィールドを削除またはハッシュできます。

• 削除: 文字列フィールドを [REDACTED] に置き換えます。これは、パートナーが欠落フィールドまたは空のフィールドを持つイベントを拒否する場合に役立ちます。
• ハッシュ: SHA-256 ハッシュアルゴリズムを文字列フィールドに適用します。

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

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

テストする前に、GitHub のサンプル Currents データをご確認ください。テストの準備ができたら、以下のオプションを選択します。

テストイベントの送信

連携をテストするには、テストイベントを送信 を選択して、選択した各イベントタイプからこの Current に 1 つのイベントを送信します。各イベントタイプの詳細については、顧客行動イベントライブラリとメッセージエンゲージメントイベントライブラリを参照してください。

Currents コネクターのテスト

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

• ワークスペースあたり最大 10 個のテスト Currents コネクター。
• 固定の 24 時間期間ごとに、合計最大 1,500 件のイベント。これは UTC の深夜 0 時にリセットされます。このイベントの合計はダッシュボードで 1 時間ごとに更新されます。

テスト Currents コネクターが送信上限に達すると、そのコネクターは翌日の午前 0 時（UTC）までイベントを送信しません。

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

Currents の更新

起動後に Currents コネクターを更新するには、以下を実行します。

1. Braze で、Partner Integrations > データエクスポート に移動します。
2. リストで Currents コネクターを探します。
3. [編集] を選択します。
4. 変更を加える。
5. [Currents の更新] を選択します。

これにより、既存のエクスポートは停止せず、新しい選択に従ってイベントの送信が開始される。

IP 許可リスト

Braze は、リストされた IP から Currents データを送信します。

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)