Currentsの設定

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

トラブルシューティング

新しいCurrents連携を追加できない

新しい連携を追加する際に「You do not have any remaining Currents integrations」と表示される場合、または新しいCurrentsコネクターを追加するボタンがグレーアウトしている場合、一般的な原因は以下のとおりです。

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

この問題を解決するには、会社内の他のワークスペースを確認してください。別のワークスペースに利用可能なCurrentsエンタイトルメントが表示される場合があります。エンタイトルメントのリクエストや設定の調整が必要な場合は、Brazeアカウントマネージャーにお問い合わせください。

追加のイベントトラッキングを有効にできない

コネクターの作成や編集はできるものの、オプションのトラッキングスイッチを有効にできない場合、ワークスペースがそのイベントカテゴリのエンタイトルメント上限に達している可能性があります。

• Track Customer Behavior and User Eventsには、利用可能なCustomer Behavior Eventsのエンタイトルメントが必要です。
• Track user profiles and attributesには、利用可能なUser Profiles and Attributesのエンタイトルメントが必要です。

追加のエンタイトルメントや設定の調整について支援が必要な場合は、Brazeアカウントマネージャーにお問い合わせください。

要件

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

各パートナーは、Brazeがデータファイルを書き込み送信する権限を必要としており、Brazeはそれらのファイルの書き込み先（具体的にはバケット名やキー）を尋ねます。

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

要件	Origin	アクセス	説明
パートナーのアカウント	パートナーとアカウントを手配するか、Brazeアカウントマネージャーにご相談ください。	パートナーのサイトを確認するか、パートナーに連絡してサインアップしてください。	会社のアカウントを通じてデータにアクセスできない場合、Brazeはパートナーにデータを送信しません。
パートナーAPIキーまたはトークン	通常はパートナーのダッシュボードにあります。	コピーして、Brazeの指定フィールドに貼り付けてください。	Brazeでは、各パートナーの連携ページにこの専用フィールドがあります。データの送信先をマッピングするために必要です。パートナーのキーまたはトークンを常に最新の状態に保ってください。無効な認証情報はコネクターを無効化し、イベントが欠落する原因になります。
認証コード/キー、シークレットキー、証明書ファイル	パートナーのアカウント担当者にお問い合わせください。パートナーのダッシュボードにある場合もあります。	キーをコピーしてBrazeの指定フィールドに貼り付けてください。.jsonまたはその他の証明書ファイルを生成し、Braze内の適切な場所にアップロードしてください。	Brazeでは、各パートナーの連携ページにこの専用フィールドがあります。これによりBrazeに認証情報が提供され、パートナーアカウントにファイルを書き込む権限が付与されます。認証情報を常に最新の状態に保つことが重要です。無効な認証情報はコネクターの無効化やイベントの欠落につながる可能性があります。
バケット、フォルダパス	一部のパートナーはバケットごとにデータを整理・分類します。パートナーのダッシュボードで確認できます。	必要な場合は、バケット名またはファイルパスをBrazeの指定スペースに正確にコピーしてください。	一部のパートナーでのみ必要ですが、必要な場合は正確に設定することが重要です。

Currentsの設定

ステップ1：パートナーを選択する

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

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

ステップ2：Currentsを開く

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

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

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

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

連携エラー通知の連絡先メールアドレスを入力します。認証情報の問題や接続の問題など、連携でエラーが発生した場合、Brazeはこのアドレスに通知を送信します。適切な担当者がアラートを受け取れるようにするため、配布リストまたはグループメールアドレスを使用してください。

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

利用可能なオプションからチェックして、そのパートナーに渡したいイベントを選択します。これらのイベントの一覧は、顧客行動イベントとメッセージエンゲージメントイベントライブラリで確認できます。

必要に応じて、イベント配信のセマンティクスの記事でイベントの詳細を確認できます。

ステップ5：フィールド変換を設定する

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

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

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

ステップ6：連携をテストする

テストを行う前に、GitHubのCurrentsサンプルデータを確認することを検討してください。テストの準備ができたら、以下のセクションからオプションを選択します。

テストイベントを送信する

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

Currentsコネクターのテスト

テスト用Currentsコネクターは、既存のコネクターの無料バージョンで、テストやさまざまな送信先の試用に使用できます。テスト用Currentsには以下の特徴があります：

• ワークスペースあたり最大10個のテスト用Currentsコネクター。
• 固定の24時間あたり合計最大1,500イベントで、UTC午前0時にリセットされます。Currentsページで、この制限に対する現在の送信量を追跡できます。Brazeはこの合計を1時間ごとに更新します。

テスト用Currentsコネクターが送信制限に達すると、Brazeはコネクターを無効にし、制限に達している間に作成されたイベントをドロップします。イベントの同期は、UTC午前0時に制限がリセットされた後に再開されます。

テスト用Currentsコネクターをアップグレードするには、ダッシュボードで連携を編集し、Upgrade Test Integrationを選択してください。

Currentsの更新

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

1. Brazeで、パートナー連携 > データのエクスポートに移動します。
2. リストでCurrentsコネクターを見つけます。
3.  編集を選択します。
4. 変更を加えます。
5. Currentsの更新を選択します。

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

IP許可リスト

Brazeは、以下のIPアドレスからCurrentsデータを送信します。

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