マーケティングハイライトの設定
マーケティングハイライトには、電子メールの開封数やクリック数、web訪問、フォーム入力など、各見込み客のライブ Marketo アクティビティが表示されます。 この記事では、Marketo インスタンスを接続してアクティビティが流れるようにする方法について説明します。
設定には4つの部分があります。
- パート A: Adobe Developer ConsoleでAPI資格情報を作成します。
- パート B:Sales Qualifier エンドポイントとIDを収集します。
- パート C: Marketo EngageでWebhookを設定します。
- パート D: Webhookをトリガースマートキャンペーンに追加します。
設定が完了すると、ユーザーは見込み客 > マーケティングハイライトでこのアクティビティを表示およびフィルタリングします。
パート A:API資格情報の作成 part-a-create-api-credentials
これらの資格情報により、MarketoはSales Qualifierに対して安全に認証できます。
資格情報を作成するには:
-
Adobe Developer Console に移動し 、Adobe ID を使用してログインします。
-
「新しいプロジェクトを作成」を選択するか、既存のプロジェクトを開きます。
-
プロジェクトを編集を選択し、プロジェクトの名前を
Sales Qualifier Marketing Highlightsなどの識別可能な名前に変更して、保存を選択します。 -
Add APIを選択し、Experience Platform APIを選択してから、Nextを選択します。
-
認証タイプとして OAuth サーバー間 を選択し、次を選択します。
OAuth Server-to-Serverを使用すると、Marketoはユーザーにログインを求めずに、そのサーバーから直接Sales Qualifier APIを呼び出すことができます。
-
Sales Qualifier Marketing Highlights Credsなど、45文字以下の資格情報名を入力してください。 -
関連付ける製品プロファイルを選択し、設定したAPIを保存を選択します。
-
接続済み資格情報で、OAuth サーバー間資格情報を開きます。 「クライアントシークレットを取得」を選択し、クライアント IDと クライアントシークレット をコピーします。 これらの値は、 パート Cで使用します。
パート B:エンドポイントと識別子の収集 part-b-gather-your-endpoint-and-identifiers
パート Cには3つの値が必要です:
- エンドポイント URL – お住まいの地域のSales Qualifier Webhook アドレス。
- imsOrg ID—Adobe Identity Management システム (IMS)の組織のID (フォーム
{ORG_ID}@AdobeOrg)。 - サンドボックス名 - AEP サンドボックスの名前は、UIに表示される表示名ではなく、Sales Qualifier URL (
sname値)に表示されるとまったく同じです。 小文字のURL値(例:prod)を使用します(Prodではなく)。
https://5r6xakp9k3.execute-api.us-east-1.amazonaws.com/prod/external/marketo/signalshttps://pc72i8q1k3.execute-api.eu-west-1.amazonaws.com/prod/external/marketo/signalshttps://5cxxxyqlai.execute-api.ap-southeast-2.amazonaws.com/prod/external/marketo/signalsお住まいの地域、imsOrg ID、またはサンドボックス名がわからない場合は、Adobeの担当者がご確認いただけます。
パート C:Marketo Webhookの設定 part-c-configure-the-marketo-webhook
Webhookを作成するには:
-
Marketoで、Admin > Webhookを選択します。
-
新しいWebhookを選択します。
-
URLを パート Bから地域のエンドポイント URLに設定します。
-
要求タイプを
POSTに設定します。 -
要求トークンエンコーディングを
JSONに設定します。 この設定は必須です。 -
以下のペイロードテンプレートを テンプレート に貼り付けます。 Marketoの トークンを挿入 を使用して、インスタンス内のフィールド名と一致させます。
note NOTE JSON エンコーディングでは、文字列トークンを引用符で囲まないでください。 Marketoが自動的に追加します。 code language-json { "leadId": {{lead.Id:default=0}}, "email": {{lead.Email Address:default=}}, "fullName": {{lead.Full Name:default=}}, "company": {{company.Company Name:default=}}, "title": {{lead.Job Title:default=}}, "department": {{lead.Department:default=}}, "country": {{lead.Country:default=}}, "score": {{lead.Lead Score:default=0}}, "rating": {{lead.Lead Rating:default=}}, "leadStatus": {{lead.Lead Status:default=}}, "leadSource": {{lead.Lead Source:default=}}, "isCustomer": {{lead.Is Customer:default=false}}, "industry": {{company.Industry:default=}}, "annualRevenue": {{company.Annual Revenue:default=0}}, "numEmployees": {{company.Num Employees:default=0}}, "campaignId": {{campaign.id:default=0}}, "campaignName": {{campaign.name:default=}}, "programName": {{program.name:default=}}, "occurredAt": {{system.dateTime:default=}}, "munchkinId": {{system.munchkinId:default=}}, "triggerName": {{trigger.Trigger Name:default=}}, "crmId": {{lead.SFDC ID:default=}}, "crmType": {{lead.SFDC Type:default=}}, "crmOwnerEmail": {{lead.Lead Owner Email Address:default=}}, "crmOwnerFirstName": {{lead.Lead Owner First Name:default=}}, "crmOwnerLastName": {{lead.Lead Owner Last Name:default=}}, "attributes": { "asset": {{trigger.Name:default=}}, "link": {{trigger.Link:default=}}, "subject": {{trigger.Subject:default=}}, "webPage": {{trigger.Web Page:default=}}, "category": {{trigger.Category:default=}}, "details": {{trigger.Details:default=}}, "sentBy": {{trigger.Sent By:default=}}, "receivedBy": {{trigger.Received By:default=}}, "referrer": {{trigger.Referrer:default=}}, "searchEngine": {{trigger.Search Engine:default=}}, "searchQuery": {{trigger.Search Query:default=}}, "imDescription": {{lead.Last Interesting Moment Desc:default=}}, "imType": {{lead.Last Interesting Moment Type:default=}}, "imDate": {{lead.Last Interesting Moment Date:default=}}, "imSource": {{lead.Last Interesting Moment Source:default=}}, "chatAgentName": {{trigger.Agent Name:default=}}, "chatAgentEmail": {{trigger.Agent Email:default=}}, "chatConversationStatus": {{trigger.Conversation Status:default=}}, "chatConversationSummary": {{trigger.Conversation Summary:default=}}, "chatGoalName": {{trigger.Goal name:default=}}, "chatMeetingStatus": {{trigger.meeting status:default=}}, "chatScheduledFor": {{trigger.Scheduled For:default=}}, "chatDocumentName": {{trigger.Document Name:default=}}, "chatDocumentUrl": {{trigger.Document URL:default=}}, "chatPageUrl": {{trigger.Page URL:default=}} } } -
Webhook Actions > カスタムヘッダーを設定を選択し、 パート Aおよび パート Bの値を使用して、次のヘッダーを追加します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto ヘッダー 値 Content-Typeapplication/jsonx-client-idクライアント ID x-client-secretクライアント秘密鍵 x-gw-ims-org-idあなたのimsOrg ID x-sandbox-nameサンドボックス名 -
「保存」を選択します。
パート D:Webhookをトリガースマートキャンペーンに追加する part-d-add-the-webhook-to-a-trigger-smart-campaign
Call Webhook フローステップを、既存または新規のトリガースマートキャンペーンに追加します。 そのキャンペーンのスマートリストトリガーが、Sales Qualifierに送信するアクティビティを決定します。
Webhookを追加するには:
- 既存のトリガースマートキャンペーンを開くか、新しいスマートキャンペーンを作成します(マーケティングアクティビティ > 新規 > スマートキャンペーン)。
- 「スマートリスト」タブで、送信するアクティビティのトリガーまたはトリガーを追加します。例えば、電子メールのリンクをクリック、フォームに入力、Web ページへの訪問などです。
- 「フロー」タブで、Webhookを呼び出す ステップを追加し、 パート Cで作成したWebhookを選択します。
- スマートキャンペーンをアクティブ化します。
スマートキャンペーンのアクティビティがSales Qualifierに取り込まれます。 担当者は、見込み客 > マーケティングハイライトでこのアクティビティを表示およびフィルタリングします。