Einrichten von Marketing-Highlights

Die Marketing-Highlights zeigen die Live-Marketo-Aktivität jedes Interessenten an, z. B. Öffnungen und Klicks von E-Mails, Web-Besuche und ausgefüllte Formulare. In diesem Artikel wird erläutert, wie Sie Ihre Marketo-Instanz verbinden, damit Aktivitäten in fließen.

IMPORTANT
Für den Abschluss dieses Setups ist der Zugriff auf die Adobe Developer Console und auf Admin in Marketo erforderlich. Arbeiten Sie mit Ihrem Adobe-Ansprechpartner und Ihrem Marketo-Administrator zusammen, um die vier folgenden Teile auszufüllen.

Das Setup besteht aus vier Teilen:

  • Teil A: Erstellen von API-Anmeldeinformationen in der Adobe Developer Console.
  • Teil B: Erfassen Sie Ihren Sales Qualifier-Endpunkt und Ihre Kennungen.
  • Teil C: Konfigurieren eines Webhooks in Marketo Engage.
  • Teil D: Hinzufügen des Webhooks zu einer Smart Trigger-Kampagne.

Nach Abschluss des Setups können Benutzer diese Aktivität unter Interessenten > Marketing-Highlights anzeigen und filtern.

Teil A: Erstellen von API-Anmeldeinformationen part-a-create-api-credentials

Mit diesen Anmeldeinformationen können Marketo sich sicher bei Sales Qualifier authentifizieren.

So erstellen Sie die Anmeldeinformationen:

  1. Wechseln Sie zur Adobe-Entwicklerkonsole und melden Sie sich mit Ihrer Adobe ID an.

  2. Wählen Sie Neues Projekt erstellen oder öffnen Sie ein vorhandenes Projekt.

  3. Wählen Sie Projekt bearbeiten, benennen Sie das Projekt in einen identifizierbaren Namen um, z. B. Sales Qualifier Marketing Highlights, und wählen Sie Speichern.

  4. Wählen Sie API hinzufügen, wählen Sie Experience Platform API und klicken Sie dann auf Weiter.

  5. Wählen Sie Authentifizierungstyp OAuth Server- als aus und klicken Sie dann auf Weiter.

    OAuth Server-zu-Server ermöglicht es Marketo, die Sales Qualifier-API direkt von ihrem Server aus aufzurufen, ohne dass sich eine Person anmelden muss.

  6. Geben Sie einen Berechtigungsnamen mit höchstens 45 Zeichen ein, z. B. Sales Qualifier Marketing Highlights Creds.

  7. Wählen Sie das zu verknüpfende Produktprofil und dann Konfigurierte API speichern aus.

  8. Öffnen Sie „Verbundene Anmeldeinformationen die OAuth Server-zu-Server-Anmeldeinformationen. Wählen Sie Client-Geheimnis abrufen und kopieren Sie dann die Client-ID und Client-Geheimnis. Sie verwenden diese Werte in Teil C.

WARNING
Den Client-Schlüssel privat halten. Behandeln Sie sie wie ein Passwort und senden Sie sie nicht per E-Mail. Verwenden Sie den genehmigten sicheren Kanal Ihrer Organisation, um ihn für die Person freizugeben, die den Webhook konfiguriert.

Teil B: Erfassen Sie Ihren Endpunkt und Ihre Kennungen part-b-gather-your-endpoint-and-identifiers

Sie benötigen drei Werte für Teil C:

  • Endpunkt-URL - Die Webhook-Adresse für Sales Qualifier für Ihre Region.
  • imsOrg ID - Die Kennung Ihres Unternehmens im Adobe Identity Management System (IMS) in der {ORG_ID}@AdobeOrg.
  • Sandbox-Name - Der Name Ihrer AEP-Sandbox entspricht exakt der in der Sales Qualifier-URL angezeigten Darstellung (dem sname), nicht dem in der Benutzeroberfläche angezeigten Anzeigenamen. Verwenden Sie den URL-Wert in Kleinbuchstaben, z. B. prod, nicht Prod.
Region
Webhook-Endpunkt-URL
Nordamerika
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 / Australien
https://5cxxxyqlai.execute-api.ap-southeast-2.amazonaws.com/prod/external/marketo/signals

Wenn Sie sich bezüglich Ihrer Region, IMS-Org-ID oder Ihres Sandbox-Namens nicht sicher sind, kann Ihr Adobe-Kontakt sie bestätigen.

Teil C: Konfigurieren des Marketo-Webhooks part-c-configure-the-marketo-webhook

So erstellen Sie den Webhook:

  1. Wählen Sie in Marketo Admin > Webhooks aus.

  2. Wählen Sie Neuer Webhook aus.

  3. Legen Sie URL auf die Endpunkt-URL für Ihre Region von Teil B fest.

  4. Legen Sie Anfragetyp auf POST fest.

  5. Setzen Sie Request Token Encoding auf JSON. Diese Einstellung ist erforderlich.

  6. Fügen Sie die unten stehende Payload-Vorlage in Vorlage ein. Verwenden Sie das Token einfügen von Marketo, um die Feldnamen in Ihrer Instanz abzugleichen.

    note
    NOTE
    Umschließen Sie bei JSON-Kodierung keine Zeichenfolgen-Token in Anführungszeichen. Marketo fügt sie automatisch hinzu.
    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. Wählen Sie Webhook- > Benutzerdefinierte Kopfzeile festlegen und fügen Sie dann die folgenden Kopfzeilen hinzu, indem Sie die Werte aus Teil A und Teil B:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
    Header Wert
    Content-Type application/json
    x-client-id Ihre Client-ID
    x-client-secret Ihr Client-Geheimnis
    x-gw-ims-org-id Ihre imsOrg-ID
    x-sandbox-name Ihr Sandbox-Name
  8. Wählen Sie Speichern aus.

Teil D: Hinzufügen des Webhooks zu einer intelligenten Trigger-Kampagne part-d-add-the-webhook-to-a-trigger-smart-campaign

Fügen Sie Trigger-Smart Kampagne einen Flussschritt „Webhook aufrufen“ hinzu, entweder eine vorhandene oder eine neue. Die Trigger der Smart List für diese Kampagne entscheiden, welche Aktivitäten an Sales Qualifier gesendet werden.

So fügen Sie den Webhook hinzu:

  1. Öffnen Sie eine bestehende Smart Trigger-Kampagne oder erstellen Sie eine neue (Marketing-Aktivitäten > Neu > Smart Campaign).
  2. Fügen Sie auf der Registerkarte Smart den Trigger oder die Trigger für die Aktivitäten hinzu, die Sie senden möchten, z. B. Klicks auf Link in E-Mail, Formular ausfüllen oder Web-Seite besuchen.
  3. Fügen Sie auf der Registerkarte Fluss den Schritt Webhook aufrufen hinzu und wählen Sie den Webhook aus, den Sie in Teil C erstellt haben.
  4. Aktivieren Sie die Smart-Kampagne.

Die Aktivität dieser Smart Campaign fließt jetzt in Sales Qualifier. Mitarbeiter können diese Aktivität unter „Interessenten > „Marketing Highlights“ anzeigen filtern.

recommendation-more-help
sales-qualifier-help