Mappとの連携を使うと、登録したすべての人がMapp Engageの連絡先として作成または更新され、選択したグループ(リスト)に追加されます。
必要なもの
- Mapp Engageのアカウントと、システムユーザーを作成できるユーザー(通常は管理者)。
- Mapp EngageのAPIアドレス。これはお使いのMapp EngageシステムのアドレスにAPIパスを加えたもので、ご利用システム向けのMapp APIドキュメントで確認するか、Mappサポートにお問い合わせください。
ステップ1:Mapp EngageでAPIユーザーを作成する
Mapp Engageでは、API用にユーザー名とパスワードを持つ専用ユーザーを使用します。
- Mapp Engageで Administration > System Users に移動します。
- 新しいシステムユーザーを作成し、「Scratcher」などの名前を付けます。
- ユーザーにAPIロール(APIアクセス)を付与し、下記の権限を設定します。
- 強力なパスワードを設定して保存します。ユーザー名とパスワードをコピーしておきます。
APIユーザーに必要な権限
Scratcherはこのユーザーを使って次の操作を行います。
- グループの読み取り(キャンペーンでグループを選択できるようにするため)
- 連絡先属性の読み取り(フィールドを属性にマッピングできるようにするため)
- 連絡先の作成と更新
- 連絡先のグループへの追加(購読登録)
メッセージやレポートなど、その他へのアクセス権は不要です。
ステップ2:MappをScratcherに連携する
- Scratcherで 設定 > 連携 に移動し、Mapp をクリックします。
- APIアドレス、ユーザー名、パスワードを該当するフィールドに貼り付けます。
- 連携をインストール をクリックします。Scratcherがグループを読み取れるかどうかを確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Mapp に移動し、有効化 をクリックします。
- 複数のアカウントを連携している場合は、アカウントを選択 で使用するアカウントを選びます。
- 外部リスト で、Mappのグループを選択します。
- フィールドマッピング で フィールドマッピングを追加 をクリックし、各 Scratcherフィールド をMappの属性に対応付けます(例:「リード - 名」を FirstName に)。
- 許可でフィルター(任意) で、マーケティング同意のチェックボックスを選択します。
- 保存 をクリックし、続いて テスト をクリックします。
フィールドマッピング
- メールアドレスは常に送信され、連絡先の識別に使われます。マッピングは不要です。
- 送信先フィールド の一覧には、Mappシステムの標準属性とカスタム属性が表示されます。カスタム属性は先にMappで作成してください。
- 携帯電話番号には フォーマット 設定を使用します。Mappでは通常、「+」と国番号付きの形式が求められます。
同意
連絡先は選択したグループに購読登録されます。Mappでそのグループにダブルオプトインが設定されている場合、Mappから独自の確認メールが送信され、本人が確認した時点で購読登録されます。許可でフィルター を使えば、マーケティングのチェックボックスにチェックを入れた人だけを追加できます。
送信される内容とタイミング
新規登録者は1〜2分以内に送信されます。連携を有効にすると、そのキャンペーンの既存のリードも送信されます。同じ人が再度参加した場合は、連絡先が更新されます。すべての送信状況は 設定 > 連携 > 配信ステータス で確認できます。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される場合:APIアドレスを確認し、システムユーザーにAPIロールが付与されていてロックされていないことを確認してください。
- アクセスエラーで配信に失敗する場合:システムユーザーに上記の権限のいずれかが不足しています。
- パスワードの有効期限が切れた場合:Mappシステムによってはパスワードに有効期限があります。Mappで新しいパスワードを設定し、新しいアカウントを追加 から再度連携してください。