Marketoコネクタ構成ガイド | サーバーサイドコネクター

コネクタアクション

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

構成の構成

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

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

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

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。

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

アクション - リストにリードを追加

パラメータ

パラメータ	説明
ターゲット静的リスト	(必須) リストを選択します。プラットフォームは最大300のリストをロードします。希望のリストが表示されない場合は、リスト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`
`cookies`
`email`
`twitterId`
`facebookId`
`linkedInId`
`sfdcAccountId`
`sfdcContactId`
`sfdcLeadId`
`sfdcLeadOwnerId`
`sfdcOpptyId`
リードを追加	リードが存在しない場合は追加します。

アクション - リストからリードを削除

パラメータ

パラメータ	説明
ターゲット静的リスト	(必須) リストを選択します。プラットフォームは最大300のリストをロードします。希望のリストが表示されない場合は、リスト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`
`cookies`
`email`
`twitterId`
`facebookId`
`linkedInId`
`sfdcAccountId`
`sfdcContactId`
`sfdcLeadId`
`sfdcLeadOwnerId`
`sfdcOpptyId`

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

パラメータ

パラメータ	説明
ターゲットメールキャンペーン	APIを使用してMarketoからトランザクショナルメールを送信するために作成されたターゲットスマートキャンペーンを選択します：APIを使用してMarketoからトランザクショナルメールを送信する
ターゲットリードID	(必須) ターゲットリードIDを提供します。
構成するトークンデータ	(オプション) トークン値をMarketo UIでの完全なトークン形式としてトークン名にマッピングします。例えば、`{ { my.message } }`

アクション - リードを作成または更新

パラメータ

パラメータ	説明
更新戦略	(必須) 更新戦略を選択します
リードルックアップフィルター	(オプション) 既存のリードを検索するためのフィルターフィールドを選択します。選択されたルックアップフィルターフィールドはリードデータセクションで値が構成されている必要があります。

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

バッチ制限

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

パラメータ

パラメータ	説明
更新戦略	(必須) 更新戦略を選択します。
リードルックアップフィルター	(オプション) 既存のリードを検索するためのフィルターフィールドを選択します。選択されたルックアップフィルターフィールドはリードデータセクションで値が構成されている必要があります。

アクション - リードをマージ

パラメータ

パラメータ	説明
勝利リードID	(必須)
敗北リードID	(必須)
CRMでマージ

使用例

この例では、Marketoコネクタを使用して新しいリードをリードデータベースに作成し、プッシュします。具体的には、シューファンのオーディエンスに参加する人々をリードにします。

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

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

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

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

Known userブーリアンは、ユーザーが既知かどうかを判断するために作成されました。ユーザーにメールアドレスが関連付けられている場合はtrueに構成されます。メールアドレスがない場合はfalseに構成されます。サイトのユーザーをリードに変換するには、そのユーザーが誰であるかを知る必要があるため、この条件は必要です。

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

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

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

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

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

Marketoカスタムサービスのステップ1-7に従って、Marketoでカスタムサービスを作成する方法を学びます。

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

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

AudienceStream > Connectorsに移動します。
+ Add Connectorをクリックします。
Marketoをクリックします。
+ Add Connectorをクリックします。

REST APIフィールドの構成

これで、コネクタを適切に構成するために必要なすべての情報が揃いました：

コネクタウィンドウのConfigureタブに移動します。
ステップ3で取得した値をコピーして貼り付け、タイトルと関連するメモを追加します。
Nextをクリックします。

アクションの構成

このウィンドウで、コネクタに何をするかの指示を与えます。

ActionsドロップダウンでCreate or Update a leadを選択します。
Shoe Fansオーディエンスを選択します。
Update StrategyでCreate onlyを選択します。
Lead Lookup FilterでUpdate Strategyを選択します。

リードはそれに関連付けられた情報の良し悪しによってのみ有効ですので、適切なデータと値をマッピングします。Lead Data to Setの下で、ステップ1で作成した属性とその他の属性を選択し、それらを対応する値にマッピングします。

ステップ4：テスト/トレース構成

構成を完了した後、テストする必要があります。構成をテストする最良の方法は、Traceを実行してイベントが適切に処理されていることを確認し、Marketoダッシュボードをチェックしてリードが適切な情報で作成されたことを確認することです。

上の画像は3つの主要なことを示しています：

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

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