Currentsの設定

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

トラブルシューティング

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

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

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

これを解決するには、会社内の他のワークスペースを確認してください。別のワークスペースで利用可能なCurrentsのエンタイトルメントが表示される場合があります。エンタイトルメントのリクエストや設定の調整が必要な場合は、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時にリセット）。このイベント合計はダッシュボード上で1時間ごとに更新されます。

テスト用Currentsコネクターが送信上限に達すると、翌日（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)