概要
情報 |
情報 PIIトークナイズ送信は有料機能です。お客様のアカウントで有効にするには、MoEngageサポートチームに連絡してください。 |
PIIトークナイズ送信は、MoEngageの特許取得済み機能であり、MoEngageプラットフォーム内にお客様の個人識別情報(PII)を保存することなく、お客様とエンゲージすることを可能にします。
PIIデータには以下が含まれます:
- 顧客の連絡先詳細: メールID、携帯番号。
- 顧客のパーソナライズ情報: 名、姓。
トークン化は、この機密データを非機密で匿名のトークンに置き換えます。この機能により、MoEngage が GDPR などのデータプライバシー規制を完全に遵守しながら、セグメント化、パーソナライズ、およびキャンペーンの実行を行うことができます。
MoEngageのデータプライバシーコンプライアンスに関する詳細は、 GDPRコンプライアンス および PIIマスキング を参照してください。
ユースケース
- データセキュリティを強化する: MoEngageにメールアドレスや電話番号などの機密PIIを保存せずに、ターゲットを絞ったキャンペーンを通じてオーディエンスを引き付けましょう。
- コンプライアンスの確保: マーケティングプラットフォームで顧客の身元を匿名化することにより、厳格なデータプライバシー規制を満たします。
- パーソナライズの維持: リアルタイムでデータを取得してキャンペーンでパーソナライズを続けましょう。
library_add_check |
前提条件 この機能を設定する前に、以下を確認してください。
|
構成
キャンペーン配信中に顧客のメールIDや携帯番号を取得するために、PII APIを設定できます。
情報 |
情報
|
1.PII APIを構成する
MoEngageに顧客のメールアドレスを保存せずにメールキャンペーンを送信するには、次の設定を構成してください。
- MoEngageのダッシュボードで、 設定 > チャンネル > メール に移動します。
- データ タブを選択します。
- 顧客のメールアドレスデータ フィールドで、 顧客のメールアドレスはMoEngage DBに保存されません(API経由で取得) オプションを選択します。
- このオプションを選択すると、API設定フィールドが表示されます。次のステップに進んで、API設定を構成してください。
MoEngageに顧客の携帯番号を保存せずにSMSおよびRCSキャンペーンを送信するには、次の設定を構成してください。
- 設定 > チャンネル > SMS & RCS に移動します。
- PII トークン化 タブを選択します。
- +API設定を追加 をクリックします。
- API構成フィールドが表示されます。API設定を構成する次のステップに進みます。
MoEngageに顧客の携帯番号を保存せずにWhatsAppキャンペーンを送信するには、次の設定を構成してください。
- MoEngageダッシュボードで、 設定 > チャンネル > WhatsApp に移動します。
- データ タブを選択します。
- 顧客の携帯電話番号データ フィールドで、 顧客の携帯電話番号はMoEngage DBに保存されていません(API経由で取得) オプションを選択します。
- このオプションを選択すると、API構成フィールドが表示されます。次のステップに進んでAPI設定を構成します。
2.API設定
ユーザーのデータを個別またはバッチで取得できます。
次の手順を実行します:
- メソッド: GET または POST メソッドを選択します。
- リクエスト URL: API の「リクエスト URL」を入力または貼り付けます。
-
パラメータ:
API の関連する「URL パラメータ」、「ヘッダー」、および/または「ボディ」詳細をキーと値のペアとして入力または貼り付けます。キーと値のペアを入力する際にプレースホルダーに @ を入力することで、URL パラメータとリクエストヘッダーを個別に設定できます。
- リクエストのバッチサイズを入力してください。
-
API設定
- メソッド: 一括ではPOSTメソッドのみサポートされています。
- リクエストURL: APIの「リクエストURL」を入力または貼り付けてください。
-
パラメータ:
APIの関連する「URLパラメータ」、「ヘッダー」、および/または「ボディ」の詳細をキーと値のペアとして入力または貼り付けてください。
info 注意
一括リクエストではURLパスパラメータとヘッダーをパーソナライズすることはできません。リクエストボディ内のユーザー属性のみをキーと値のペアとしてパーソナライズできます。例: 顧客ハッシュ: {{UserAttribute['ID']}} 値、これは入力で必須であり、同じキーが出力で返されます。
-
サンプルリクエスト:
リクエストはバックエンドで以下のように処理されます:
{ "abcd": "abcd", "CustomerInBulk": [ { "Customer hash": "{{UserAttribute['ID']}}" } ] }
-
顧客ハッシュはキーであり、456 {{UserAttribute['ID']}} は値です。異なるキーと値のペアを持つことができます。例: 顧客キーと顧客ID。
サンプルレスポンス: 以下のようにバックエンドからレスポンスを受け取ります:{
“CustomerInBulk”: {
{
Customer hash: “456”,
First name: “John”,
Last name: “doe”,
Email ID: “xyz@abc.com”
Phone number: “9876543210”
},
{
Customer hash: “567”,
First name: “Joe”,
Last name: “Bloggs”,
Email ID: “ioh@abc.com”
Phone number: “1234567890”
}
},
}データはリクエストしたのと同じキー(ユーザー属性)で返されます。
info 注意
複数のキーセットを持つことができますが、ユーザー属性に基づいて1つのキーセットからのみパーソナライズされたリクエストを行うことができます。
3.テストと設定の保存
API設定を定義した後、MoEngageがデータを正しく取得できることを確認するために構成をテストする必要があります。
-
設定した匿名IDの有効なテスト値を入力します(例:
456
)。 - APIコールをトリガーするには、 テスト をクリックしてください。
- APIレスポンスを確認して、成功して正しいデータを返していることを確認してください。
-
APIレスポンスのEmail/携帯電話番号フィールド
リストで、顧客のメールアドレスまたは携帯番号を含むレスポンスキーを選択します(例えば、
Email_ID
)。 -
設定を完了するには、
保存
をクリックしてください。
PIIベースのキャンペーンワークフロー
次の図は、PIIトークン化送信が有効になっている場合のキャンペーン送信時のデータフローを示しています。
- MoEngageでキャンペーンが開始されます。
- MoEngageは、対象ユーザーの匿名IDを渡して、設定されたPII APIを呼び出します。
- あなたのAPIは、各匿名IDに対応するメールアドレスまたは携帯番号を取得して返します。
- MoEngageは、キャンペーンコンテンツと取得したPIIを設定されたEmail、SMS、RCS、またはWhatsAppのサービスプロバイダーに送信します。
- MoEngageは取得したPII (メール、携帯番号、およびそのキャンペーンのためにContent APIを介して取得されたその他のデータ)をプロバイダーに送信した後、直ちに削除します。
- サービスプロバイダーはメッセージをエンドカスタマーに届けます。
- サービスプロバイダーは配信状況データをMoEngageに返送します。
- MoEngageは、ユニークなメッセージIDを使用して配信データをキャンペーンにマッピングし、配信レシートで返された可能性のあるPIIを削除します。
- キャンペーン分析はMoEngageダッシュボードで更新されます。
匿名化サポート
MoEngageプラットフォームで顧客の匿名性をサポートするために実装された他のいくつかの変更点はこちらです。
- キャンペーン送信ログ- 特定のチャネルにトークン化された送信が設定されている場合、キャンペーンログは次回のキャンペーン実行(設定変更後)からメールまたは携帯番号データ(PIIトークン化送信が設定されているチャネルに応じて)の保存を停止します。
-
キャンペーン配信データ
- MoEngageは、すべてのネイティブコネクタの配信データを追跡し、メッセージIDフィールドを使用して配信データをキャンペーンにマッピングします。
情報 情報
配信用の情報は、カスタム(SMS、RCS、Email)コネクタでは追跡されません。
- セグメンテーション - 「ショーカウント」クエリは、 セグメント > セグメント作成 ナビゲーションからのセグメンテーションとキャンペーンのセグメンテーションの両方の一部としてユーザー数をリストします。ただし、MoEngageはモバイル番号やメールアドレスを保存しないため(到達可能性を計算する基準です)、どちらの場合も到達可能なユーザー数を表示することはできません。
- 現在のキャンペーン(ライブキャンペーン) - PII API設定が構成されている場合、そのチャネル(ポイントチャネルまたはフロー)でライブキャンペーンがある場合、送信は次のインスタンスからメールIDまたは携帯番号を取得して行われます。
- パーソナライズされたプレビュー - この機能は、PII設定が保存された後、自動的にチャネルで無効になります。再度有効にするには、カスタマーサクセスマネージャー (CSM) に連絡してリクエストできます。
- キャンペーンテスト失敗 理由- PII設定が行われているチャネルでキャンペーンを作成中にテストを行う際、APIが応答しない場合は、UIにAPIエラーが表示されます。
- キャンペーン分析 - 上記で構成されたPII APIが顧客の送信ID(メールIDまたは携帯番号)を取得できない顧客は、 キャンペーン配信統計 キャンペーン情報または分析セクションで。このファネルは有効なメールIDまたは携帯番号を持つユーザーを考慮しているためです。
- MoEngageで顧客データが利用できない場合のコンテンツパーソナライゼーション - 上記のPII APIは顧客の送信ID(メールIDまたは携帯番号)の取得に焦点を当てていますが、MoEngageのコンテンツ API機能を使用すると、キャンペーンがエンドカスタマーに送信される直前に、データベースからリアルタイムで任意のデータ(PIIおよび/またはその他)を直接取得することができます。詳細については、 コンテンツAPIを使用したパーソナライゼーション .
よくある質問 (FAQ)
いいえ。MoEngageでユーザーにマッピングできる、データベースに存在する一意の非PII顧客識別子を確保する必要があります。
はい。その機能は独立しています。PIIトークナイズド送信を使用せずにパーソナライズのためにコンテンツAPIを使用することができ、その逆も可能です。
そのチャンネルでのアクティブキャンペーンのすべての後続メッセージは、PII APIを使用して送信されます。設定を保存する前にプロバイダーのキューに既にあるメッセージは、MoEngageに以前保存されたデータを使用して送信される可能性があります。
MoEngageは、APIコールを最大3回リトライし、リトライ間隔は2秒です。再試行は、API呼び出しが失敗した特定のユーザーに対してのみ行われ、バッチ全体には行われません。
はい。MoEngageはAPIペイロードの対称鍵暗号化をサポートしています。PII 値はキャンペーン送信時にのみ復号化されます。
エラーブレークダウンセクションに次のエラーが表示されます:
チャンネル | UIのエラーメッセージ |
---|---|
SMS、RCS、WhatsApp |
無効なAPI応答(モバイル番号の取得)
MoEngageワークスペースで無効または空の顧客識別子。 |
メール |
無効なAPI応答(メールIDの取得)
MoEngageワークスペースでの無効/空の顧客識別子。 |
ドラフトキャンペーンは、公開または次にトリガーされるとすぐにPII APIを使用します。
それはあなたのメール/SMS/RCS/WhatsAppサービスプロバイダーと共有され、その後削除されます。
PII APIを通じてデータを取得するように設定されたチャネルの場合、MoEngageはメールIDおよび/または携帯番号のログを停止します。その代わりに、ログには MoEngage とお客様のデータベースの両方で一貫したユニークな顧客識別子(またはトークン化された識別子)が含まれます。
はい。例えば、メール設定がAPI経由でEmail IDを取得するように構成されている場合、個別のメールキャンペーンとフローに統合されたメールキャンペーンの両方が、MoEngageデータベース内のメール属性に依存するのではなく、APIを通じて顧客のEmail IDを取得し始めます。
はい、詳細については こちら を参照してください。
いいえ、現在、MoEngage 知らせるではPIIトークン化送信をサポートしていません。
PII APIの送信速度とスロットル速度は、メールバッチングの速度と同じです。