Daten an Salesforce-Kampagnen senden

Sie können die Salesforce-Kampagnenintegration von Looker verwenden, um Kampagnen in Salesforce zu erstellen und die Kampagnenmitglieder mit Leads und Kontakten aus einem Looker-Look oder einem Looker-Konto zu füllen. Sie können entweder eine neue Kampagne erstellen oder Nutzer an eine vorhandene Kampagne in Looker anhängen.

Einrichtungsvoraussetzungen

  • Salesforce API, Version 42.0 und höher (veröffentlicht im Frühjahr 2018)
  • Nutzer benötigen die Berechtigungen „Erstellen“ und „Bearbeiten“ für das Kampagnenobjekt (standardmäßig mit dem Profil „Marketingnutzer“ verknüpft) sowie das Kästchen „Marketingnutzer“ in ihrem Nutzerprofil.
    • Wenn Sie nicht die erforderlichen Berechtigungen haben, wird möglicherweise die folgende Fehlermeldung angezeigt: entity type cannot be inserted...

Anleitung für die Einrichtung

  1. Erstellen Sie ein Nutzerattribut, um den Zugriff auf die Aktion zu steuern, und geben Sie die Salesforce-Domain an. Klicken Sie auf der Seite Nutzerattribute im Abschnitt Nutzer des Menüs Admin auf Nutzerattribut erstellen. Definieren Sie das neue Nutzerattribut:

    • Name: salesforce_campaigns_action_domain
    • Label: Aktionsdomain für Salesforce-Kampagnen
    • Datentyp: String
    • Nutzerzugriff: Ansehen
    • Werte ausblenden: No
    • Kein Standardwert

    Klicken Sie auf Speichern.

  2. Nachdem Sie ein Nutzerattribut definiert haben, können Sie den einzelnen Nutzern und Nutzergruppen, die die Aktion verwenden sollen, die Salesforce-Domain (z. B. „https://MeinDomainName.IhrUnternehmen.de“) als Wert zuweisen. Wählen Sie oben auf der Seite Nutzerattribute die Tabs Nutzerwerte und Gruppenwerte aus, um einzelnen Nutzern bzw. Nutzergruppen Werte zuzuweisen.

    • Verschiedene Nutzer können unterschiedliche Domains ansprechen, z. B. eine Staging- oder Entwicklungsinstanz von Salesforce. Sie können den Domainwert jederzeit aktualisieren.
    • Nutzern, denen kein Wert zugewiesen ist, wird die Aktion nicht als Zieloption angezeigt.

  3. Aktivieren Sie als Nächstes die Aktion. Rufen Sie im Menü Admin im Bereich Plattform die Seite Aktionen auf und wählen Sie neben der Aktion Salesforce Campaign Action Domain die Option Enable aus. Aktivieren Sie auf der Seite Aktionsdomain für Salesforce-Kampagnen die Ein-/Aus-Schaltfläche Aktiviert und wählen Sie für das Feld Salesforce-Domain das Nutzerattribut Salesforce-Kampagnenaktionsdomain aus. Klicken Sie auf Speichern.

  4. Richten Sie optional die LookML-Tags sfdc_contact_id und sfdc_lead_id für Kontakte bzw. Lead-Felder ein. Alternativ versucht die Aktion, den regulären Ausdruck mit dem folgenden Ausdruck zu vergleichen: /contact id/i und /lead id/i (Groß-/Kleinschreibung nicht berücksichtigend).

Aktion „Salesforce-Kampagnen“ verwenden

Sobald die Salesforce-Kampagnenaktion konfiguriert ist, können Sie sie im Looker-Planer verwenden:

  1. Erstellen Sie in „Look“ oder „Entdecken“ einen Zeitplan oder wählen Sie die Option zum Sendeneiner einmaligen Lieferung aus.
  2. Wählen Sie unter Wo sollen diese Daten eingefügt werden? die Aktion Salesforce-Kampagnen aus.
  3. Wenn Sie die Aktion zum ersten Mal verwenden, werden Sie aufgefordert, sich in Salesforce anzumelden. Klicken Sie auf Log in (Anmelden).
  4. Klicken Sie im OAuth-Zustimmungsbildschirm auf Zulassen und kehren Sie zum Looker Scheduler-Fenster zurück.

  5. Wählen Sie Anmeldedaten bestätigen aus. Nachdem Sie sich in Looker Scheduler in Salesforce angemeldet haben, füllen Sie das Aktionsformular für Salesforce-Kampagnen aus, um die Details Ihrer Look- oder Explore-Auslieferung zu konfigurieren:

    1. Erstellen oder anhängen: Wählen Sie Erstellen aus, um eine neue Kampagne zu erstellen, oder Anhängen, um eine Kampagne zu ändern.
    2. Kampagnenname: Geben Sie den Namen der neuen Kampagne ein oder wählen Sie eine vorhandene Kampagne aus.
    3. Mitgliedsstatus: Wählen Sie den Status der Kampagnenmitglieder aus. Diese Liste wird aus den verfügbaren Status Ihrer Salesforce-Instanz ausgefüllt.
    4. Salesforce Salesforce Errors In Looker (Salesforce-Fehler in Looker aufrufen): Setzen Sie diesen Wert auf Yes (Ja), um alle Salesforce-Fehler anzuzeigen, wenn Sie Kampagnenmitglieder in den Details zum geplanten Jobstatus von Looker festlegen. Dadurch wird auf der Seite Verlauf planen im Menü Admin ein Fehler im Status der geplanten Jobausführung in Looker aufgezeichnet. Das ist nützlich, um Fehler auf Mitgliedsebene zu beheben. Setzen Sie diesen Wert auf No, um alle Fehler im Zusammenhang mit Kampagnenmitgliedern zu ignorieren (Standardeinstellung). Dadurch wird der Status Abgeschlossen unabhängig von den Fehlern erfasst, die bei der Einrichtung der Kampagnenmitglieder aufgetreten sind.

  6. Geben Sie weitere Optionen für die Lieferung an.

  7. Wählen Sie Senden aus.

Aktion für Salesforce-Kampagnen entfernen

Wenn Sie die verbundene Salesforce-Instanz wechseln oder die Looker-Aktion von Ihrer Salesforce-Instanz trennen möchten, können Sie in Ihrem Salesforce-Konto die Verbindung zur Looker-Anwendung widerrufen.

Beschränkungen

  • Diese Aktion ist auf maximal 5.000 Zeilen beschränkt. Die Funktion zum Senden aller Ergebnisse wird derzeit entwickelt.
  • Für jede Salesforce-Version ist die Anzahl der API-Aufrufe begrenzt, die innerhalb von 24 Stunden zulässig sind. Informationen zu den API-Limits Ihrer Instanz finden Sie in der Dokumentation zu Salesforce API Request Limits and Alloctions. Bei dieser Aktion werden POST-Anfragen mit sObject Collections verwendet, um mehrere Einträge (200 Einträge pro API-Aufruf) in einer einzelnen Anfrage auszuführen.