Daten an Salesforce-Kampagnen senden

Mit der Salesforce Campaigns-Integration von Looker können Sie Kampagnen in Salesforce erstellen und die Kampagnenmitglieder mit Leads und Kontakten aus einem Looker-Explore oder -Look füllen. Sie können in Looker eine neue Kampagne erstellen oder Nutzer einer bestehenden Kampagne hinzufügen.

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 dem Profil „Marketingnutzer“ zugewiesen) sowie das Kästchen „Marketingnutzer“ in ihrem Nutzerprofil.
    • Wenn Sie nicht über ausreichende Berechtigungen verfügen, wird möglicherweise die folgende Fehlermeldung angezeigt: entity type cannot be inserted...

Anleitung zur 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 Bereich Nutzer des Menüs Verwaltung auf Nutzerattribut erstellen. Definieren Sie das Attribut für neue Nutzer:

    • Name: salesforce_campaigns_action_domain
    • Label: Salesforce-Kampagnen-Aktionsdomain
    • Datentyp: String
    • Nutzerzugriff: Lesen
    • Werte ausblenden: Nein
    • Kein Standardwert

    Klicken Sie auf Speichern.

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

    • Unterschiedliche Nutzer können auf unterschiedliche Domains (z. B. eine Salesforce-Staging- oder -Entwicklungs-Instanz) abzielen. 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ü Verwaltung im Bereich Plattform die Seite Aktionen auf und wählen Sie neben der Aktion Salesforce-Kampagnen-Aktionsdomain die Option Aktivieren aus. Aktivieren Sie auf der Seite Salesforce Campaigns-Aktionsdomain die Option Aktiviert und wählen Sie das Nutzerattribut Salesforce Campaigns-Aktionsdomain für das Feld Salesforce-Domain aus. Klicken Sie auf Speichern.

  4. Optional: Richten Sie die LookML-Tags sfdc_contact_id und sfdc_lead_id für Kontakt- und Lead-Felder ein. Alternativ wird versucht, das Feldlabel mit den folgenden regulären Ausdrücken abzugleichen: /contact id/i und /lead id/i (ohne Berücksichtigung der Groß- und Kleinschreibung).

Salesforce-Kampagnenaktion verwenden

Nachdem die Salesforce-Kampagnenaktion konfiguriert wurde, können Sie sie im Looker-Scheduler verwenden:

  1. Erstellen Sie in einem Look oder Explore einen Zeitplan oder wählen Sie die Option Senden für eine einmalige Zustellung aus.
  2. Wählen Sie unter Wo sollen diese Daten hin? die Aktion Salesforce-Kampagnen aus.
  3. Wenn Sie die Aktion zum ersten Mal verwenden, werden Sie aufgefordert, sich in Salesforce anzumelden. Klicken Sie auf Anmelden.
  4. Klicken Sie auf dem OAuth-Zustimmungsbildschirm auf Zulassen und kehren Sie zum Looker-Scheduler-Fenster zurück.

  5. Wählen Sie Anmeldedaten bestätigen aus. Nachdem Sie sich im Looker-Scheduler in Salesforce angemeldet haben, füllen Sie das Aktionsformular Salesforce Campaigns aus, um die Details der Bereitstellung von Look oder Explore zu konfigurieren:

    1. Erstellen oder anhängen: Wählen Sie Erstellen aus, um eine neue Kampagne zu erstellen, oder Anhängen, um eine vorhandene 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 in Ihrer Salesforce-Instanz erstellt.
    4. Salesforce-Fehler in Looker anzeigen: Legen Sie hier Ja fest, um alle Salesforce-Fehler beim Festlegen von Kampagnenmitgliedern im Detail des geplanten Jobstatus in Looker anzuzeigen. Dadurch wird im Menü Verwaltung auf der Seite Zeitplanverlauf im Status des geplanten Jobs in Looker der Wert Fehler erfasst. Dies ist hilfreich, um Fehler auf Mitgliedsebene zu beheben. Legen Sie diese Option auf Nein fest, um alle Fehler im Zusammenhang mit Kampagnenmitgliedern zu ignorieren (Standardeinstellung). Dadurch wird der Status Abgeschlossen erfasst, unabhängig von Fehlern, die beim Einrichten der Kampagnenmitglieder aufgetreten sind.

  6. Geben Sie gegebenenfalls weitere Optionen für die Zustellung an.

  7. Wähle Senden aus.

Die Aktion „Salesforce-Kampagnen“ wird entfernt

Wenn Sie die verbundene Salesforce-Instanz wechseln oder die Verbindung der Looker-Aktion mit Ihrer Salesforce-Instanz aufheben möchten, können Sie die Verbindung zur Looker-Anwendung in Ihrem Salesforce-Konto 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 gilt eine Beschränkung der Anzahl der API-Aufrufe, die innerhalb eines 24-Stunden-Zeitraums zulässig sind. Informationen zu den API-Limits Ihrer Instanz finden Sie in der Dokumentation Salesforce API-Anfragelimits und ‑Zuweisungen. Bei dieser Aktion werden POST-Anfragen mit sObject-Sammlungen verwendet, um mehrere Einträge (200 Einträge pro API-Aufruf) in einer einzigen Anfrage auszuführen.