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.
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:
-
Wechseln Sie zur Adobe-Entwicklerkonsole und melden Sie sich mit Ihrer Adobe ID an.
-
Wählen Sie Neues Projekt erstellen oder öffnen Sie ein vorhandenes Projekt.
-
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. -
Wählen Sie API hinzufügen, wählen Sie Experience Platform API und klicken Sie dann auf Weiter.
-
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.
-
Geben Sie einen Berechtigungsnamen mit höchstens 45 Zeichen ein, z. B.
Sales Qualifier Marketing Highlights Creds. -
Wählen Sie das zu verknüpfende Produktprofil und dann Konfigurierte API speichern aus.
-
Ö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.
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, nichtProd.
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/signalsWenn 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:
-
Wählen Sie in Marketo Admin > Webhooks aus.
-
Wählen Sie Neuer Webhook aus.
-
Legen Sie URL auf die Endpunkt-URL für Ihre Region von Teil B fest.
-
Legen Sie Anfragetyp auf
POSTfest. -
Setzen Sie Request Token Encoding auf
JSON. Diese Einstellung ist erforderlich. -
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=}} } } -
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-Typeapplication/jsonx-client-idIhre Client-ID x-client-secretIhr Client-Geheimnis x-gw-ims-org-idIhre imsOrg-ID x-sandbox-nameIhr Sandbox-Name -
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:
- Öffnen Sie eine bestehende Smart Trigger-Kampagne oder erstellen Sie eine neue (Marketing-Aktivitäten > Neu > Smart Campaign).
- 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.
- 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.
- 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.