マーケティングハイライトの設定

マーケティングハイライトには、電子メールの開封数やクリック数、web訪問、フォーム入力など、各見込み客のライブ Marketo アクティビティが表示されます。 この記事では、Marketo インスタンスを接続してアクティビティが流れるようにする方法について説明します。

IMPORTANT
この設定を完了するには、Marketoの​ Admin ​とAdobe Developer Consoleにアクセスする必要があります。 Adobeの担当者とMarketo管理者と協力して、以下の4つの部分を完成させます。

設定には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に対して安全に認証できます。

資格情報を作成するには:

  1. Adobe Developer Console に移動し 、Adobe ID を使用してログインします。

  2. 新しいプロジェクトを作成」を選択するか、既存のプロジェクトを開きます。

  3. プロジェクトを編集​を選択し、プロジェクトの名前をSales Qualifier Marketing Highlightsなどの識別可能な名前に変更して、保存​を選択します。

  4. Add API​を選択し、Experience Platform API​を選択してから、Next​を選択します。

  5. 認証タイプとして​ OAuth サーバー間 ​を選択し、​を選択します。

    OAuth Server-to-Server​を使用すると、Marketoはユーザーにログインを求めずに、そのサーバーから直接Sales Qualifier APIを呼び出すことができます。

  6. Sales Qualifier Marketing Highlights Credsなど、45文字以下の資格情報名を入力してください。

  7. 関連付ける製品プロファイルを選択し、設定したAPIを保存​を選択します。

  8. 接続済み資格情報​で、OAuth サーバー間​資格情報を開きます。 「クライアントシークレットを取得」を選択し、クライアント ID​と​ クライアントシークレット ​をコピーします。 これらの値は、​ パート Cで使用します。

WARNING
クライアントの秘密鍵を保持します。 パスワードのように扱い、電子メールで送信しないでください。 組織で承認されたセキュアチャネルを使用して、Webhookを設定するユーザーと共有します。

パート 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ではなく)。
地域
Webhook エンドポイント URL
北米
https://5r6xakp9k3.execute-api.us-east-1.amazonaws.com/prod/external/marketo/signals
EMEA
https://pc72i8q1k3.execute-api.eu-west-1.amazonaws.com/prod/external/marketo/signals
APAC / オーストラリア
https://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を作成するには:

  1. Marketoで、Admin > Webhook​を選択します。

  2. 新しいWebhook​を選択します。

  3. URL​を​ パート Bから地域のエンドポイント URLに設定します。

  4. 要求タイプ​をPOSTに設定します。

  5. 要求トークンエンコーディング​をJSONに設定します。 この設定は必須です。

  6. 以下のペイロードテンプレートを​ テンプレート ​に貼り付けます。 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=}}
      }
    }
    
  7. 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-Type application/json
    x-client-id クライアント ID
    x-client-secret クライアント秘密鍵
    x-gw-ims-org-id あなたのimsOrg ID
    x-sandbox-name サンドボックス名
  8. 保存」を選択します。

パート D:Webhookをトリガースマートキャンペーンに追加する part-d-add-the-webhook-to-a-trigger-smart-campaign

Call Webhook フローステップを、既存または新規のトリガースマートキャンペーンに追加します。 そのキャンペーンのスマートリストトリガーが、Sales Qualifierに送信するアクティビティを決定します。

Webhookを追加するには:

  1. 既存のトリガースマートキャンペーンを開くか、新しいスマートキャンペーンを作成します(マーケティングアクティビティ > 新規 > スマートキャンペーン)。
  2. スマートリスト」タブで、送信するアクティビティのトリガーまたはトリガーを追加します。例えば、電子メールのリンクをクリックフォームに入力Web ページへの訪問​などです。
  3. フロー」タブで、Webhookを呼び出す ステップを追加し、​ パート Cで作成したWebhookを選択します。
  4. スマートキャンペーンをアクティブ化します。

スマートキャンペーンのアクティビティがSales Qualifierに取り込まれます。 担当者は、見込み客 > マーケティングハイライト​でこのアクティビティを表示およびフィルタリングします。

recommendation-more-help
sales-qualifier-help