Marketoコネクタ構成ガイド

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

• REST APIクライアントID：（必須）Marketo > 管理 > LaunchPointで見つかるクライアントIDを提供してください。APIユーザーはリードの読み書き、キャンペーンの読み取り/実行、リストの読み取りの権限が必要です。詳細については、Marketo: ReST APIで使用するカスタムサービスの作成を参照してください。
• REST APIクライアントシークレット：（必須）Marketo > 管理 > LaunchPointで見つかるクライアントシークレットを提供してください。
• REST APIエンドポイントURL：（必須）Marketo > 管理 > Webサービスで見つかるREST APIエンドポイント。例：https://123-ABC-123.mktorest.com/rest。
• REST APIアイデンティティURL：（必須）Marketo > 管理 > Webサービスで見つかるREST APIアイデンティティ。例：https://123-ABC-123.mktorest.com/identity。

アクション

アクション名	AudienceStream	EventStream
リストにリードを追加	✓	✓
リストにリードを追加（バッチ処理）	✓	✓
リストからリードを削除	✓	✓
リストからリードを削除（バッチ処理）	✓	✓
トランザクションメールを送信	✓	✓
リードを作成または更新	✓	✓
リードを作成または更新（バッチ処理）	✓	✓
リードをマージ	✓	✓
リードを一括インポート（リストに追加するオプションあり）	✓	✓

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

リストにリードを追加

パラメータ

パラメータ	説明
ターゲット静的リスト	（必須）リストを選択します。プラットフォームは最大300のリストをロードします。リストが表示されない場合は、リストIDを入力してください。
ターゲットリードID	ユーザーのリードIDがわかっている場合に使用します。リードID検索は空白のままにします。
リードID検索	ユーザーのリードIDが不明な場合に使用します。ターゲットリードIDを空白のままにし、このフィールドを使用してさまざまなフィルターでリードIDを検索します。可能な値：id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId。
リードを追加	リードが存在しない場合は追加します。

リストにリードを追加（バッチ処理）

バッチ制限

このアクションは、バッチ処理されたリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、バッチ処理されたアクションを参照してください。リクエストは、次のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：300
• 最古のリクエストからの最大時間：30分
• リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
ターゲット静的リスト	（必須）リストを選択します。プラットフォームは最大300のリストをロードします。リストが表示されない場合は、リストIDを入力してください。
ターゲットリードID	ユーザーのリードIDがわかっている場合に使用します。リードID検索は空白のままにします。
リードID検索	ユーザーのリードIDが不明な場合に使用します。ターゲットリードIDを空白のままにし、このフィールドを使用してさまざまなフィルターでリードIDを検索します。可能な値：id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId。
リードを追加	リードが存在しない場合は追加します。

リストからリードを削除

パラメータ

パラメータ	説明
ターゲット静的リスト	（必須）リストを選択します。プラットフォームは最大300のリストをロードします。リストが表示されない場合は、リストIDを入力してください。
ターゲットリードID	ユーザーのリードIDがわかっている場合に使用します。リードID検索は空白のままにします。
リードID検索	ユーザーのリードIDが不明な場合に使用します。ターゲットリードIDを空白のままにし、このフィールドを使用してさまざまなフィルターでリードIDを検索します。可能な値：id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId。
リードを追加	リードが存在しない場合は追加します。

リストからリードを削除（バッチ処理）

バッチ制限

このアクションは、バッチ処理されたリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、バッチ処理されたアクションを参照してください。リクエストは、次のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：300
• 最古のリクエストからの最大時間：30分
• リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
ターゲット静的リスト	（必須）リストを選択します。プラットフォームは最大300のリストをロードします。リストが表示されない場合は、リストIDを入力してください。
ターゲットリードID	ユーザーのリードIDがわかっている場合に使用します。リードID検索は空白のままにします。
リードID検索	ユーザーのリードIDが不明な場合に使用します。ターゲットリードIDを空白のままにし、このフィールドを使用してさまざまなフィルターでリードIDを検索します。可能な値：id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId。
リードを追加	リードが存在しない場合は追加します。

トランザクションメールを送信

パラメータ

パラメータ	説明
ターゲットメールキャンペーン	トランザクションメール用に作成されたターゲットスマートキャンペーンを選択します。詳細については、Marketo: トランザクションメールを参照してください。
ターゲットリードID	（必須）ターゲットリードIDを提供してください。
構成するトークンデータ	（オプション）トークン値をトークン名にマッピングします。Marketo UIからの完全なトークン形式を使用してください。例：{ { my.message } }。

リードを作成または更新

パラメータ

パラメータ	説明
更新戦略	（必須）更新戦略を選択します。
リードルックアップフィルタ	（オプション）既存のリードを検索するためのフィルタフィールドを選択します。 選択されたルックアップフィルタフィールドには、リードデータセクションで値が構成されている必要があります。
構成するリードデータ	（必須）値をリードプロパティ名にマッピングします。日付属性は自動的にISO 8601形式にフォーマットされます。

リードを作成または更新（バッチ処理）

バッチ制限

このアクションは、バッチ処理されたリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、バッチ処理されたアクションを参照してください。リクエストは、次のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：300
• 最古のリクエストからの最大時間：30分
• リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
更新戦略	（必須）更新戦略を選択します。
リードルックアップフィルタ	（オプション）既存のリードを検索するためのフィルタフィールドを選択します。 選択されたルックアップフィルタフィールドには、リードデータセクションで値が構成されている必要があります。
構成するリードデータ	（必須）値をリードプロパティ名にマッピングします。日付属性は自動的にISO 8601形式にフォーマットされます。

リードをマージ

パラメータ

パラメータ	説明
構成する一般データ	（必須） 勝利リードID：勝利リード。 敗北リードID：マージするリード（敗北リード）。
CRMでマージ	CRMでのマージも行うかどうかを指定します。

リードを一括インポート（リストに追加するオプションあり）

バッチ制限

このアクションは、バッチ処理されたリクエストを使用してベンダーへの大量データ転送をサポートします。リクエストは、次のいずれかの閾値が達成されるまでキューに入れられます：

• 最大リクエスト数：25,000
• 最古のリクエストからの最大時間：30分
• リクエストの最大サイズ：10 MB

パラメータ

パラメータ	説明
ターゲット静的リスト	（オプション）リードを追加するリストを選択します。
リード検索フィールド	（必須）リード検索に使用するフィールド。 選択された検索フィールドには、リードデータセクションで値が構成されている必要があります。 可能な値: id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId。
リードデータ	（必須）リードのプロパティ名に値をマッピングします。検索フィールドもマッピングする必要があります。

ユースケースの例

この例では、Marketoコネクタが新しいリードをリードデータベースに作成してプッシュします。Shoe Fansオーディエンスに参加する訪問はリードになります。

ステップ 1: 属性とオーディエンス条件を定義する

ユーザーのメールアドレスを保存する訪問ID属性を作成します。これはリードに関連付けられたユニークな値です。

メールアドレスのみからリードを作成することは可能ですが、リードに関連付けるためのより多くの情報を取得することをお勧めします。ステップ6では、この訪問メール訪問ID属性を名、姓、会社の三つの特性属性と共に渡します。

次に、Shoe Fansというタイトルで新しいオーディエンスを作成します。Shoe Fanバッジを持つすべての訪問と真の既知のユーザーブール属性がオーディエンスに追加されるようにロジックを構成します。

既知のユーザーブールはユーザーが既知かどうかを決定します。ユーザーにメールアドレスが関連付けられている場合、trueに構成されます。メールアドレスが存在しない場合はfalseに構成されます。この条件は、識別されていないユーザーをリードに変換することができないため必要です。

ステップ 2: Marketoでカスタムサービスを作成する

https://login.marketo.com/ でMarketoアカウントにログインします。

カスタムサービスを使用すると、ユーザーはクライアントアプリがアクセスできるデータを説明および定義できます。アプリを使用する前に、Marketo管理者がリードの読み取り、書き込み、マージ、キャンペーンの読み取りと実行ができるAPI専用ユーザーにそれを関連付ける必要があります。

次の情報を取得する必要があります：

• REST APIクライアントID
• REST APIクライアントシークレット
• REST APIエンドポイントURL
• REST APIアイデンティティURL

Marketoでカスタムサービスを作成する方法については、Marketo: ReST APIで使用するカスタムサービスを作成するを参照してください。

ステップ 3: Marketoコネクタを追加する

Marketoコネクタを追加するには、次の手順を実行します：

1. AudienceStream > Connectorsに移動します。
2. + Add Connectorをクリックします。
3. Marketoをクリックします。
4. + Add Connectorをクリックします。

REST APIフィールドの構成

1. コネクタウィンドウのConfigureタブに移動します。
2. ステップ2からの値を入力し、タイトルと関連するメモを追加します。
3. Nextをクリックします。

アクションの構成

1. ActionsメニューでCreate or Update a leadを選択します。
2. Shoe Fansオーディエンスを選択します。
3. Update StrategyでCreate onlyを選択します。
4. Lead Lookup FilterでUpdate Strategyを選択します。

適切なデータと値をマッピングします。Lead Data to Setの下で、ステップ1で作成した属性とその他の属性を選択し、それに対応する値にマッピングします。

ステップ 4: 構成のテストとトレース

構成を行った後、テストを実行します。Traceを実行して、イベントが適切に処理され、Marketoダッシュボードに正しい情報でリードが作成されたことを確認します。

トレースは次のことを示します：

1. オーディエンスに参加しました（Shoe Fans）。
2. アクションがトリガーされました（Marketo- Create leads）。
3. アクションが正常に処理されました（1 action processed / 0 actions failed）。

ステップ 5: Marketoで確認する