Iterable連携を使うと、登録した人はすべてメールアドレスで識別されるユーザーとしてIterableに作成または更新され、選択したIterableのリストに登録されます。
必要なもの
- ユーザー識別子としてメールアドレスを使用するIterableプロジェクトと、APIキーを管理する権限を持つユーザー(通常は組織管理者またはプロジェクト管理者)。
- IterableプロジェクトがUSとEUのどちらのデータセンターにあるかの情報。
ステップ1:IterableでAPIキーを作成する
- Iterableで Integrations > API Keys に移動します。
- New API Key をクリックします。
- 「Scratcher」などの名前を付け、タイプとして Standard(サーバーサイド)を選択します。
- キーを作成してコピーします。Iterableでキー全体が表示されるのは一度だけです。
キーの用途
Standard(サーバーサイド)キーで、Scratcherに必要な以下の操作が可能です。
- リストとユーザーフィールドの読み取り(キャンペーンで選択できるようにするため)
- ユーザーの作成と更新
- ユーザーのリストへの登録
JavaScript、モバイル、または読み取り専用のキーは使用しないでください。これらのキーではサーバーからユーザーを追加できません。
ステップ2:IterableをScratcherに連携する
- Scratcherで 設定 > 連携 に移動し、Iterable をクリックします。
- データセンター(USまたはEU)を選択し、APIキーを貼り付けます。
- 連携をインストール をクリックします。Scratcherがリストを読み取れるかどうかを確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Iterable に移動し、有効化 をクリックします。
- 複数のプロジェクトを連携している場合は、アカウントを選択 でプロジェクトを選びます。
- 外部リスト でIterableのリストを選択します。選択できるのは静的リストのみです。
- フィールドマッピング で フィールドマッピングを追加 をクリックし、各 Scratcherフィールド をIterableのユーザーフィールドに対応付けます(例:「リード - 名」を firstName に)。
- 権限でフィルター(任意) で、マーケティング同意のチェックボックスを選択します。
- 保存 をクリックし、続いて テスト をクリックします。
フィールドマッピング
- メールアドレスは常に送信され、ユーザーの識別に使われます。マッピングする必要はありません。
- 送信先フィールド のリストには、プロジェクト内のユーザーフィールドが表示されます。まだ存在しないフィールドは、正しいタイプになるよう先にIterableで作成してください。
- 電話番号には、IterableがSMS用に求める「+」と国番号付きの 形式 を使用してください。
同意
リストに登録されただけでは、メッセージタイプの配信対象にはなりません。Iterableでは独自の購読設定を使用します。権限でフィルター(任意) でマーケティングのチェックボックスを選択し、同意した人だけを送信してください。また、同意の 承諾 と 日付 フィールドをユーザーフィールドにマッピングすれば、Iterable上で同意の証跡を残せます。
送信される内容とタイミング
新規登録は1〜2分以内に送信され、キャンペーンの既存リードは有効化した時点で送信されます。同じ人が再度参加すると、ユーザー情報が更新されます。ウェルカムメッセージを送るには、そのリストをIterableのジャーニーの起点として使用してください。すべての配信は 設定 > 連携 > 配信ステータス で確認できます。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される:キーが間違っているかStandardキーではない、またはデータセンターの選択が誤っています。
- フィールドが拒否される:値がIterableのユーザーフィールドのタイプに合っていません(例:日付フィールドにテキスト)。マッピングを確認してください。
- リストが表示されない:動的リストはユーザーを受け取れません。Iterableで静的リストを作成してください。