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時にリセットされます）。このイベント合計は、ダッシュボード上で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)