Ortto連携を使うと、登録したすべての人がメールアドレスをもとに照合され、Orttoの人物(person)として作成または更新されます。
必要なもの
- Orttoアカウントと、データソースを追加できるユーザー。
- ScratcherはOrttoのヨーロッパAPIに接続するため、OrttoアカウントがOrttoのヨーロッパリージョンでホストされている必要があります。別のリージョンのアカウントをお使いの場合は、チャットでお問い合わせください。
ステップ1:OrttoでAPIキーを作成する
- Orttoで Data sources に移動し、New data source をクリックします。
- Custom API を選択します。
- わかりやすい名前を付けます(例:「Scratcher」)。
- Orttoに表示される API key をコピーし、データソースの作成を完了します。
キーに必要な権限
Scratcherはこのキーを使って、人物の読み取り、人物の作成・更新(マージ)、カスタム人物フィールドの読み取りを行います。キーで実行できるアクションをOrttoで尋ねられた場合は、これらを許可してください。それ以外の権限は不要です。
ステップ2:OrttoをScratcherに接続する
- Scratcherで 設定 > 連携 に移動し、Ortto をクリックします。
- Api Key にキーを貼り付けます。
- 連携をインストール をクリックします。ScratcherがOrttoの人物データを読み取れるかを確認します。
ステップ3:キャンペーンで有効にする
- エディターで 接続 > 連携 > Ortto に移動し、有効化 をクリックします。
- 複数のアカウントを接続している場合は、アカウントを選択 でアカウントを選びます。
- フィールドマッピング で、各 Scratcherフィールド をOrttoのフィールドに対応付けます。リストを選択する必要はありません。Orttoではすべての人が1か所に登録され、Orttoのオーディエンスでグループ分けします。
- 権限でフィルター(任意) で、マーケティング同意のチェックボックスを選択します。
- 保存 をクリックし、続けて テスト をクリックします。
ポイント:Orttoには選択するリストがないため、有効化 をクリックした時点でScratcherからの送信が始まります。キャンペーン公開前に有効化するか、すぐに設定を済ませてください。
フィールドマッピング
- メールアドレスと電話番号は自動的に送信されます。
- 独自のカスタムフィールドに加えて、Name、First name、Last name、Birthday、City、Country、Region、Postal code、Language、GDPR、External ID にマッピングできます。
- 同意の Accepted フィールドを GDPR にマッピングすると、Orttoに同意が記録されます。
送信される内容とタイミング
新規登録は1〜2分以内に送信され、既存のリードは有効化した時点で送信されます。配信ステータス で、各人物が新規作成されたか、既に存在していたかを確認できます。
トラブルシューティング
- インストール時に「All or some of the fields are invalid...」と表示される:キーが間違っているか、OrttoアカウントがヨーロッパリージョンにありLません。
- 配信に失敗する:Orttoでデータソースが削除されたか、キーが変更されています。新しいキーを作成し、新しいアカウントを追加 から接続してください。