Markto-Aufgabe

Informationen zu Marketo-Aufgaben

Mit der Marketo-Aufgabe können Sie Daten von Qualtrics an Marketo übergeben. Mit diesen Daten können Sie einen Marketo-Lead anlegen oder aktualisieren oder eine oder mehrere Marketo-Aktivitäten anlegen. Benutzerdefinierte Activitys können in Marketo verwendet werden, um Daten zu filtern oder Trigger anzulegen. Beim Einrichten dieser Aufgabe können Sie eine von drei Optionen auswählen:

• Marketo-Aktivität erstellen: Verknüpfen Sie eine einzelne Aktivität mit Ihrer Aufgabe, um eine Aktivität für jede Antwort anzulegen, die ein Lead erhält. Das bedeutet, dass Sie auswählen können, welche Antwortfelder Sie als Attribute für die Aktivität an Marketo übergeben möchten.
• Mehrere Marketo-Aktivitäten erstellen: Verknüpfen Sie mehrere Aktivitäten mit Ihrer Aufgabe, um für jede Antwort, die ein Lead erhält, mehrere Aktivitäten anzulegen. Für diese Aufgabe gilt jeder mit einer Antwort verbundene Datenpunkt als neue Aktivität.
• Marketo-Lead anlegen oder aktualisieren: Verknüpfen Sie eine Umfrageantwort mit einem neuen oder vorhandenen Marketo-Lead. Nachdem der Lead angelegt wurde, verfügen Sie über eine Lead-ID, die Sie in den nachfolgenden Aktivitätsaufgaben Marketo anlegen oder Mehrere Marketo-Aktivitäten anlegen verwenden können.

Marketo-Konfiguration

Es gibt einige Aktionen, die Sie in Ihrem Marketo-Konto ausführen müssen, bevor Sie diese Erweiterung verwenden können.

1. Legen Sie benutzerdefinierte Aktivitäten an, denen Sie Qualtrics-Felder zuordnen möchten.
2. Legen Sie einen API-Benutzer und eine API-Rolle für die Marketo-Erweiterung an. Stellen Sie sicher, dass Sie dem Benutzer und der Rolle die Berechtigung zum Erstellen und Aktualisieren von Aktivitäten erteilen.
3. Rufen Sie die Client-ID, den geheimen Client-Schlüssel und die Munchkin-ID Ihrer Instanz ab.

Weitere Informationen zum Festlegen Ihres Marketo-Kontos finden Sie in der Übersicht über die Marketo-Erweiterung.

Marketo-Aufgabe Erstkonfiguration

Sobald Sie Ihr Marketo-Konto fertig gestellt haben, ist es an der Zeit, mit dem Einrichten der Marketo-Aufgabe in Qualtrics zu beginnen. In diesem Abschnitt wird die Erstkonfiguration zum Verbinden eines Marketo-Kontos und zum Auswählen der gewünschten Aufgabe in Marketo erläutert.

1. Wechseln Sie in Ihrer Umfrage zur Registerkarte Workflows.
   
2. Klicken Sie auf Workflow erstellen.
3. Wählen Sie Gestartet, wenn ein Ereignis empfangen wurde.
4. Definieren Sie die Ereignis der den Workflow in Marketo auslöst. Meistens handelt es sich dabei um eine Umfrageantwort von Qualtrics.
   
5. Klicken Sie bei Bedarf auf das Pluszeichen (+) und dann auf Bedingungen, um Bedingungen festzulegen, unter denen der Workflow ausgelöst wird.
   Tipp: Dies ist besonders hilfreich, wenn Sie nicht möchten, dass benutzerdefinierte Aktivitäten in Marketo jedes Mal angelegt werden, wenn eine Antwort auf die Umfrage gesendet wird.
6. Klicken Sie auf das Pluszeichen (+) und dann auf Aufgabe.
7. Wählen Sie Marketo.
   
8. Wählen Sie die Aufgabe aus, die Sie in Marketo ausführen möchten.
   
   Folgende Optionen sind verfügbar:
   • Mehrere Marketo-Aktivitäten erstellen: Legen Sie mehrere neue Marketo-Aktivitäten für jede Umfrageantwort an.
   • Marketo-Aktivität erstellen: Legen Sie für jede Umfrageantwort eine neue Marketo-Aktivität an.
   • Marketo-Lead erstellen oder aktualisieren: Anlegen oder Aktualisieren der Telefonnummer, E-Mail-Adresse usw. eines Leads
9. Klicken Sie auf Weiter.
10. Wählen Sie ein Marketo-Konto aus, zu dem eine Verbindung hergestellt werden soll. Sie können alle zuvor verbundenen Konten sowie alle Konten auswählen, die von Administratoren zur Verwendung durch die Marke verbunden wurden.
    
11. Um ein neues Konto zu verbinden, klicken Sie auf Benutzerkonto hinzufügen.
    Tipp: Nachdem Sie auf Benutzerkonto hinzufügen geklickt haben, geben Sie Ihrem Konto einen Namen, um es zu identifizieren. Fügen Sie dann Ihre Client-ID und den geheimen Client-Schlüssel hinzu.
    
    Tipp: Sie finden Ihre Client-ID und den geheimen Client-Schlüssel, indem Sie zum Administrator und dann zum Startpunkt in Marketo wechseln. Wählen Sie anschließend neben Ihrem Service Details anzeigen.
    
12. Klicken Sie auf Weiter.
13. Geben Sie Ihre Munchkin-ID ein.
    
    Tipp: Die Munchkin-ID sind die ersten 11 Zeichen in Ihrer Identitäts-URL auf Marketo.
14. Klicken Sie auf Verifizieren.
15. Der Rest der Aufgabeneinrichtung hängt von der Option ab, die Sie in Schritt 8 ausgewählt haben. Weitere Informationen finden Sie in den verlinkten Abschnitten:
    • Marketo-Aktivität erstellen
    • Mehrere Marketo-Aktivitäten erstellen
    • Marketo-Lead erstellen oder aktualisieren

Marketo-Aktivität anlegen

Durch die Verknüpfung einer einzelnen Aktivität wird für jede Umfrageantwort, die ein Lead annimmt, eine Marketo-Aktivität angelegt. Mit dieser Option können Sie auswählen, welche Antwortfelder Sie als Attribute für die Aktivität an Marketo übergeben möchten.

1. Führen Sie die Schritte im Abschnitt Initiale Einrichtung der Marketo-Aufgabe aus, und wählen Sie als Aufgabe Marketo-Aktivität anlegen.
2. Verwenden Sie das Dropdown-Menü Aktivität auswählen, um eine benutzerdefinierte Aktivität auszuwählen.
   
   Tipp: Die in dieser Dropdown-Liste verfügbaren Aktivitäten hängen davon ab, welche benutzerdefinierten Aktivitäten Sie in Marketo eingerichtet haben. Weitere Informationen finden Sie in der Dokumentation zu den Aktivitäten von Marketo.
   Achtung: Wenn Sie in der Dropdown-Box für Aktivitäten keine Aktivitäten sehen, haben Sie möglicherweise falsche Anmeldeinformationen eingegeben. Wenn Sie die richtigen Anmeldeinformationen verwenden, müssen Sie möglicherweise die Berechtigungen anpassen, die für den Benutzer oder die Rolle in Marketo erteilt wurden. Weitere Informationen finden Sie unter Marketo-Konfiguration.
3. Geben Sie das Feld Leadnummer ein, indem Sie auf das Symbol {a} klicken und das eingebettete Datenfeld auswählen, das der Leadnummer entspricht. Dies kann aus externen eingebetteten Daten stammen, die in einer Mailingliste gespeichert sind, oder Daten, die von vorherigen Aufgaben übergeben wurden.
   Tipp: Damit die Antworten an Marketo gesendet werden, sollte jede Antwort eine Lead-ID haben, da benutzerdefinierte Aktivitäten mit Leads in Marketo verbunden sind.
   Beispiel: Sie können die Aufgabe Marketo Lead erstellen oder aktualisieren verwenden, um zunächst einen Lead in Marketo zu erstellen oder zu aktualisieren. Dadurch wird die Lead-ID in Qualtrics zu einem verfügbaren Feld. Verwenden Sie anschließend die Aktivitätsaufgabe Marketo anlegen, um eine Aktivität einzufügen. Das Piped-Text-Menü enthält die Lead-ID für die Pipe-In.
4. Ordnen Sie das erforderliche Primärattribut Ihrer Aktivität zu. In diesem Fall handelt es sich um die eindeutige ID der Antwort, daher haben wir den dynamischen Text für die Antwort-ID ausgewählt.
5. Um zusätzliche Felder hinzuzufügen, klicken Sie auf Feld hinzufügen, und wählen Sie dann das Feld Marketo und das Qualtrics-Quellfeld aus. Klicken Sie für Ihre Quellfelder auf das Piped-Symbol {a}, und wählen Sie das zu verwendende Qualtrics-Feld aus. Die in diesem Menü verfügbaren Felder hängen von Ihrem ausgewählten Ereignis ab. Wenn Sie ein Umfrageantwortereignis ausgewählt haben, lauten Ihre Optionen:
   • Umfragenfrage: Die Antwort des Umfrageteilnehmers auf eine Umfragenfrage.
   • Eingebettetes Datenfeld: Ein eingebettetes Datenfeld.
   • GeoIP-Standort: Postleitzahl, Ort, Bundesland/-staat/Region, Gebietscode oder Ländername für die Antwort basierend auf GeoIP-Daten.
   • DateTime: Der aktuelle DateTime-Wert oder ein DateTime-Wert, der relativ zum aktuellen DateTime-Wert ist.
   • Panelfeld: Vorname, Nachname, E-Mail, externe Datenreferenz und Sprache des Teilnehmers, falls in einer Mailingliste gespeichert.
   • Quote: Gibt an, ob die Antwort eine Umfragequote erhöht hat.
   • Antwort: Die ID und der Antwortlink der Antworten.
   • Status: Der Status der Antwort.
6. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ) neben dem Feld.
7. Wählen Sie Sichern, um den Vorgang abzuschließen.

Mehrere Mark-to-Aktivitäten anlegen

Wenn Sie mehrere Marketo-Aktivitäten mit einem Ereignis in Qualtrics verknüpfen, gilt jeder Datenpunkt, der mit einer Antwort verbunden ist, als neue Aktivität. Dazu gehören alle Fragenfelder und eingebetteten Daten, die mit der Antwort verbunden sind.

1. Führen Sie die Schritte im Abschnitt Initiale Einrichtung der Marketo-Aufgabe aus, und wählen Sie als Aufgabe Marketo-Aktivität anlegen.
2. Verwenden Sie das Dropdown-Menü Aktivität auswählen, um eine benutzerdefinierte Aktivität auszuwählen.
   
   Tipp: Die in dieser Dropdown-Liste verfügbaren Aktivitäten hängen davon ab, welche benutzerdefinierten Aktivitäten Sie in Marketo eingerichtet haben. Weitere Informationen finden Sie in der Dokumentation zu den Aktivitäten von Marketo.
   Achtung: Wenn Sie in der Dropdown-Box für Aktivitäten keine Aktivitäten sehen, haben Sie möglicherweise falsche Anmeldeinformationen eingegeben. Wenn Sie die richtigen Anmeldeinformationen verwenden, müssen Sie möglicherweise die Berechtigungen anpassen, die für den Benutzer oder die Rolle in Marketo erteilt wurden.
3. Geben Sie das Feld Leadnummer ein, indem Sie auf das Symbol {a} klicken und das eingebettete Datenfeld auswählen, das der Leadnummer entspricht. Dies kann aus externen eingebetteten Daten stammen, die in einer Mailingliste gespeichert sind, oder Daten, die von vorherigen Aufgaben übergeben wurden.
   Tipp: Damit die Antworten an Marketo gesendet werden, sollte jede Antwort eine Lead-ID haben, da benutzerdefinierte Aktivitäten mit Leads in Marketo verbunden sind.
   Beispiel: Sie können die Aufgabe Marketo Lead erstellen oder aktualisieren verwenden, um zunächst einen Lead in Marketo zu erstellen oder zu aktualisieren. Dadurch wird die Lead-ID in Qualtrics zu einem verfügbaren Feld. Verwenden Sie anschließend die Aktivitätsaufgabe Marketo anlegen, um eine Aktivität einzufügen. Das Piped-Text-Menü enthält die Lead-ID für die Pipe-In.
4. Ordnen Sie das erforderliche Primärattribut Ihrer Aktivität zu. In diesem Fall handelt es sich um die eindeutige ID der Antwort, daher haben wir das Feld „Antwort-ID“ ausgewählt.
5. Um zusätzliche Felder hinzuzufügen, klicken Sie auf Feld hinzufügen, und wählen Sie dann das Feld Marketo und das Qualtrics-Quellfeld aus. Für Ihre Quellfelder können Sie aus einer Liste vordefinierter Qualtrics-Attribute auswählen:
   • SurveyID: Eindeutige ID der Qualtrics-Umfrage, für die Sie die Aufgabe festlegen.
   • ResponseID: Qualtrics-definierte ID der Antwort.
   • QuestionID: Qualtrics-definierte ID für Fragen in Ihrer Umfrage.
   • ExportTag: Tag, das zur Identifizierung von Fragen in Ihrer Umfrage verwendet wird. Der Benutzer kann diese bearbeiten. Siehe Export-Tags.
   • ChoiceText: Text für die Antwortmöglichkeiten, die der Umfrageteilnehmer ausgewählt hat. Wird auch als Variablennamen bezeichnet.
   • ChoiceRecode: Umkodierungswerte für die Auswahlen, die der Umfrageteilnehmer ausgewählt hat.
   • EmbeddedDataField: Name des benutzerdefinierten eingebetteten Datenfelds.
   • EmbeddedDataValue: Eingebetteter Datenfeldwert.
     Beispiel: So sieht Ihre Zuordnung aus, wenn Sie jedes verfügbare Feld hinzufügen:
     
6. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ) neben dem Feld.
7. Wenn Sie fertig sind, klicken Sie auf Speichern.

Marketo-Lead anlegen oder aktualisieren

Durch das Erstellen oder Aktualisieren eines Leads in Marketo können Sie Qualtrics-Ereignisdaten wie eine Umfrageantwort übernehmen und einen neuen Lead in Marketo mit diesen Informationen erstellen oder den Lead mit neuen Informationen aktualisieren. Im Rahmen eines erfolgreichen Anlegens oder Aktualisierens wird dann die Leadnummer zurückgegeben, die mit der Aktivitätsaufgabe Markto anlegen oder Mehrere Marketos anlegen verwendet werden kann.

1. Führen Sie die Schritte im Abschnitt Initiale Einrichtung der Marketo-Aufgabe aus, und wählen Sie als Aufgabe Marketo-Aktivität anlegen.
2. Wählen Sie den Ereignistyp zum Anlegen oder Aktualisieren des Leads aus. Jede Option ändert die Aufgabeneinrichtung geringfügig.
   
   • Lead anlegen oder aktualisieren: Es wird versucht, den Lead zuerst in Marketo zu finden und die zugeordneten Felder für diesen Benutzer zu aktualisieren. Wenn der Lead nicht gefunden wird, wird ein neuer Lead mit den zugeordneten Feldern angelegt.
   • Nur anlegen: Es wird versucht, einen neuen Lead in Marketo anzulegen. Wenn der Lead bereits vorhanden ist, gibt Marketo einen Fehler zurück.
   • Nur aktualisieren: Es wird versucht, einen vorhandenen Lead in Marketo zu aktualisieren. Wenn der Lead nicht vorhanden ist, gibt marketo einen Fehler zurück.
3. Wenn Sie „Nur anlegen“ ausgewählt haben, überspringen Sie diesen Schritt, da Sie einen neuen Lead anlegen. Wenn Sie „Lead anlegen oder aktualisieren“ oder „Nur aktualisieren“ ausgewählt haben, müssen Sie ein Lookup-Feld auswählen, um nach dem Lead in Marketo zu suchen. Verwenden Sie die Dropdown-Liste Zu suchen, um ein Feld auszuwählen.
   
   Tipp: Die Felder, die Sie durchsuchen können, sind in der Regel eine Teilmenge aller führenden Felder. Diese Felder werden als durchsuchbare Felder betrachtet. Weitere Informationen zu durchsuchbaren Feldern finden Sie auf dieser Marketo-Supportseite.
4. Wenn Sie „Nur anlegen“ ausgewählt haben, überspringen Sie diesen Schritt, da Sie einen neuen Lead anlegen. Wenn Sie “Lead anlegen oder aktualisieren” oder “Nur aktualisieren” ausgewählt haben, müssen Sie das ausgewählte Feld als Mussfeld zuordnen. Dieses Feld wird verwendet, um zu ermitteln, ob das Lead bereits in Marketo vorhanden ist. Verwenden Sie das Symbol {a}, um ein Feld aus Qualtrics auszuwählen.
   
5. Um zusätzliche Felder hinzuzufügen, klicken Sie auf Feld hinzufügen, und wählen Sie dann das Feld Marketo und das Qualtrics-Quellfeld aus. Klicken Sie für Ihre Quellfelder auf das Piped-Symbol {a}, und wählen Sie das zu verwendende Qualtrics-Feld aus. Die in diesem Menü verfügbaren Felder hängen von Ihrem ausgewählten Ereignis ab. Wenn Sie ein Umfrageantwortereignis ausgewählt haben, lauten Ihre Optionen:
   
   • Umfragenfrage: Die Antwort des Umfrageteilnehmers auf eine Umfragenfrage.
   • Eingebettetes Datenfeld: Ein eingebettetes Datenfeld.
   • GeoIP-Standort: Postleitzahl, Ort, Bundesland/-staat/Region, Gebietscode oder Ländername für die Antwort basierend auf GeoIP-Daten.
   • DateTime: Der aktuelle DateTime-Wert oder ein DateTime-Wert, der relativ zum aktuellen DateTime-Wert ist.
   • Panelfeld: Vorname, Nachname, E-Mail, externe Datenreferenz und Sprache des Teilnehmers, falls in einer Mailingliste gespeichert.
   • Quote: Gibt an, ob die Antwort eine Umfragequote erhöht hat.
   • Antwort: Die ID und der Antwortlink der Antworten.
   • Status: Der Status der Antwort.
6. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ) neben dem Feld.
7. Wählen Sie Sichern, um den Vorgang abzuschließen.

FAQs