Salesforce Marketing Cloud v2 - Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8837 des Connectors.

Erste Schritte

Versionsunterstützung für Salesforce Marketing Cloud

Herstellen einer Verbindung

Herstellen einer Verbindung mit Salesforce Marketing Cloud

Sowohl für REST- als auch für SOAP APIs haben Sie die Möglichkeit, den Datenzugriff mithilfe der folgenden Eigenschaften zu verfeinern:

• Instance: Die verwendete Instanz der Salesforce Marketing Cloud API. Die Standardinstanz ist s7 der Web Services API. Sie können diese Eigenschaft jedoch verwenden, um eine andere Instanz anzugeben.
• Subdomain: Wenn die Instanz größer als s10 ist, müssen Sie auch die Subdomäne angeben.

REST API

Zum Verbinden setzen Sie Schema Zu REST.

Die Salesforce Marketing Cloud REST- API verwendet den OAuth-Authentifizierungsstandard. Um sich mit OAuth zu authentifizieren, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen, um Werte für abzurufen OAuthClientId Und OAuthClientSecret Verbindungseigenschaften. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Informationen.

SOAP API

Zum Verbinden setzen Sie Schema Zu SOAP.

Die Salesforce Marketing Cloud SOAP API kann über OAuth eine Verbindung herstellen, unterstützt aber auch die herkömmliche Verwendung von Anmeldeinformationen.

Authentifizieren bei Salesforce Marketing Cloud

Benutzerkonten (OAuth)

Setzen Sie die AuthScheme Zu OAUTH. Setzen Sie außerdem in allen OAuth-Flows AccountId zur spezifischen MID der Zielgeschäftseinheit.

Desktop-Apps

Befolgen Sie die nachstehenden Schritte, um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-Anwendung zu authentifizieren. Siehe Erstellen einer benutzerdefinierten OAuth-App für Informationen zu benutzerdefinierten OAuth-Anwendungen. Get an OAuth Access Token

Nachdem Sie Folgendes eingestellt haben, können Sie eine Verbindung herstellen:

• OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
• OAuthClientSecret: Das Client Secret in Ihren Anwendungseinstellungen.
• CallbackURL: Die Weiterleitungs URL in Ihren Anwendungseinstellungen.
• InitiateOAuth: GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation. Diese Werte bleiben über alle Verbindungen hinweg bestehen.

Um eine Verbindung zu Daten herzustellen, setzen Sie OAuthAccessToken Verbindungseigenschaft zum Zugriffstoken, das von der gespeicherten Prozedur zurückgegeben wird. Wenn das Zugriffstoken nach ExpiresIn Sekunden abläuft, rufen Sie GetOAuthAccessToken auf, um ein neues Zugriffstoken zu erhalten.

Kopflose Maschinen

Um den Treiber für die Verwendung von OAuth mit einem Benutzerkonto auf einem Headless-Computer zu konfigurieren, müssen Sie sich auf einem anderen Gerät authentifizieren, das über einen Internetbrowser verfügt.

1. Wählen Sie eine von zwei Optionen:
   • Option 1: Erhalten Sie die OAuthVerifierWert wie unten unter „Erhalten und Umtauschen eines Prüfcodes“ beschrieben.
   • Option 2: Installieren Sie den Connector auf einem Computer mit einem Internetbrowser und übertragen Sie die OAuth-Authentifizierungswerte, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben, wie unten unter „OAuth-Einstellungen übertragen“ beschrieben.
2. Konfigurieren Sie dann den Connector so, dass der Zugriffstoken auf der Headless-Maschine automatisch aktualisiert wird.

Option 1: Einen Verifier-Code erhalten und umtauschen

Um einen Prüfcode zu erhalten, müssen Sie sich bei der OAuth-Autorisierungs URL authentifizieren.

Führen Sie die folgenden Schritte aus, um sich vom Computer aus mit einem Internetbrowser zu authentifizieren und die OAuthVerifier Verbindungseigenschaft.

1. Wählen Sie eine dieser Optionen:

   • Wenn Sie die eingebettete OAuth-Anwendung verwenden, klicken Sie auf Salesforce Marketing Cloud OAuth-Endpoint, um den Endpoint in Ihrem Browser zu öffnen.

   • Wenn Sie eine benutzerdefinierte OAuth-Anwendung verwenden, erstellen Sie die Autorisierungs-URL, indem Sie die folgenden Eigenschaften festlegen:

     • InitiateOAuth: Auf setzen OFF.
     • OAuthClientId: Auf die Client-ID eingestellt, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
     • OAuthClientSecret: Auf das Client-Geheimnis einstellen, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.

     Rufen Sie dann die gespeicherte Prozedur rpgrestsp-getoauthauthorizationurl mit der entsprechenden Callback-URL auf. Öffnen Sie die von der gespeicherten Prozedur zurückgegebene URL in einem Browser. 2. Melden Sie sich an und erteilen Sie dem Connector die entsprechenden Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode enthält. 3. Speichern Sie den Wert des Prüfcodes. Später setzen Sie diesen in OAuthVerifier Verbindungseigenschaft.

Als Nächstes müssen Sie den OAuth-Verifiziercode gegen OAuth-Aktualisierungs- und Zugriffstoken austauschen. Legen Sie die folgenden Eigenschaften fest:

Legen Sie auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte zu erhalten:

• InitiateOAuth: REFRESH.
• OAuthVerifier: Der Prüfcode.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Die Client-ID in Ihren benutzerdefinierten OAuth-Anwendungseinstellungen.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Das Client-Geheimnis in den benutzerdefinierten OAuth-Anwendungseinstellungen.
• OAuthSettingsLocation: Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn Sie InitiateOAuth auf setzen GETANDREFRESH oder REFRESH. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'. Wenn diese Verbindungseigenschaft festgelegt ist, bleiben die Daten über alle Verbindungen hinweg erhalten.

Nachdem die OAuth-Einstellungsdatei generiert wurde, müssen Sie die folgenden Eigenschaften neu festlegen, um eine Verbindung herzustellen:

• InitiateOAuth: REFRESH.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthSettingsLocation: Der Speicherort, der die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass dieser Speicherort dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Option 2: OAuth-Einstellungen übertragen

Bevor Sie eine Verbindung auf einem Headless-Computer herstellen, müssen Sie eine Verbindung mit dem Treiber auf einem Gerät herstellen und installieren, das einen Internetbrowser unterstützt. Legen Sie die Verbindungseigenschaften wie oben unter „Desktop-Anwendungen“ beschrieben fest.

Nach Abschluss der Anweisungen unter „Desktopanwendungen“ werden die resultierenden Authentifizierungswerte verschlüsselt und an den durch angegebenen Speicherort geschrieben OAuthSettingsLocation. Der Standarddateiname ist OAuthSettings.txt.

Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner.

Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest:

• OAuthClientId: (nur benutzerdefinierte Anwendungen) Die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthSettingsLocation: Der Speicherort Ihrer OAuth-Einstellungsdatei. Stellen Sie sicher, dass dieser Speicherort dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Server-zu-Server (OAuthClient)

Wenn Sie eine Anwendung in Salesforce Marketing Cloud erstellen, können Sie die Server-zu-Server-Authentifizierung auswählen. In diesem Fall werden die Berechtigungen der Anwendung direkt in der Salesforce Marketing Cloud-Benutzeroberfläche konfiguriert. Daher gibt es keinen Benutzerkontext und daher auch keine browserbasierte Anmeldung oder Berechtigungserteilung. Für dieses Schema müssen Sie Ihre eigenen Anmeldeinformationen erstellen.

Geben Sie die folgenden Eigenschaften an, um die Server-zu-Server-OAuth-Authentifizierung für Ihre Anwendung zu aktivieren:

• AuthScheme: OAuthClient.
• InitiateOAuth: GETANDREFRESH.
• OAuthClientId: Die Client-ID.
• OAuthClientSecret: Das Client-Geheimnis.
• Subdomain: Geben Sie die Salesforce Marketing Cloud API Subdomäne an.

Benutzer-/Passwortkonten (Basic)

Die Salesforce Marketing Cloud SOAP API kann entweder mit Ihren Anmeldeinformationen oder mit der OAuth-Authentifizierung eine Verbindung herstellen.

Beachten Sie, dass dieses Authentifizierungsschema für REST- API-basierte Anwendungen nicht verfügbar ist.

Um eine Verbindung zum Datenzugriff unter Verwendung der Anmeldedaten-Authentifizierung herzustellen, legen Sie Folgendes fest:

• AuthScheme: Basic.
• User: Das Salesforce Marketing Cloud-Benutzerkonto.
• Password: Das zur Authentifizierung des Benutzers verwendete Passwort.
• UseLegacyAuthentication: True.

Erstellen einer benutzerdefinierten OAuth-App

Erstellen einer App

Befolgen Sie die nachstehenden Schritte, um eine Anwendung zu erstellen und zu registrieren und die OAuth-Clientanmeldeinformationen, die Client-ID und das Client-Geheimnis abzurufen:

1. Melden Sie sich bei Ihrer Salesforce Marketing Cloud an und navigieren Sie zu Marketing Cloud | Verwaltung | Installierte Pakete.
2. Klicken Sie auf New.
3. Geben Sie einen Paketnamen und eine Beschreibung an.
4. Speichern Sie das Paket. Das gespeicherte Paket enthält wichtige Daten. Weitere Informationen zu den einzelnen Feldern finden Sie unter „Definitionen installierter Pakete“. Beachten Sie, dass Sie die Paket-ID, das JWT-Signaturgeheimnis und das Quellkonto nur für Pakete sehen, die in Ihrem Konto erstellt wurden.
5. Klicken Sie unter „Komponenten“ auf Komponente hinzufügen.
6. Wählen Sie API Integration.
7. Sie müssen auswählen Server-to-Server oder Web App als Integrationstyp, wenn das Paket erweiterte Funktionen unterstützt.
8. Weisen Sie den entsprechenden Umfang für Ihre Integration zu.
   • Server-zu-Server-Anfragen ausführen… ist für alle API Integrationen automatisch ausgewählt.
   • Wählen Sie Anfragen im Namen des Benutzers ausführen… aus, wenn dieses Paket eine Marketing Cloud-Anwendung enthält.
   • Wählen Sie den Marketing Cloud-Bereich für Ihre API Aufrufe. Weisen Sie nur den Bereich zu, den Ihr Paket benötigt.
9. Speichern Sie die Komponente.
10. Die Client ID Und Client Secret befinden sich unter den Komponentendetails.

Auswählen aus Datenerweiterungen in SalesforceMarketingCloud

Der Connector bietet die Möglichkeit, Daten aus Data Extensions als relationale Tabellen auszuwählen, einzufügen, zu aktualisieren und zu löschen. Um eine Data Extension Abfrage, muss diese in Schritt 1 einer Salesforce Marketing Cloud v2-Aktivität ausgewählt werden. Data Extension-Namen können nicht manuell eingegeben werden.

Auswählen von Daten aus Datenerweiterungen

SELECT * FROM DataExtensionObject_fsefes3

SELECT * FROM DataExtensionObject_fsefes3 WHERE FieldName1 = 'One'

Hinweis 1: Alle Filter, die mit normalen Tabellen/Ansichten funktionieren, funktionieren auch mit Datenerweiterungen.

Hinweis 2: Standardmäßig ruft die Salesforce Marketing Cloud Daten für die angemeldete Client-ID ab. Um Ergebnisse für mehr als eine Client-ID abzurufen, verwenden Sie Semikolons (;) als Trennzeichen. Die Client-ID kann Konten und Unterkonten sein, einschließlich Enterprise 2.0-, On-Your-Behalf- und Lock & Publish-Konten.

SELECT * FROM DataExtensionObject_fsefes3 WHERE ClientID = '1234567'

Einfügen von Daten in Datenerweiterungen

INSERT INTO DataExtensionObject_fsefes3 (FieldName1, FieldName2, FieldName3) VALUES ('One', 'Two', 'Three')

Aktualisieren von Daten aus Datenerweiterungen

UPDATE DataExtensionObject_secondtest15 SET [Name] = 'ChangedFromTheApi' WHERE [Email Adresse] = 'update_me@gmail.com'

Hinweis: Damit das Update funktioniert, muss für diese Datenerweiterung ein Primärschlüssel vorhanden sein.

Löschen von Daten aus Datenerweiterungen

DELETE FROM DataExtensionObject_secondtest15 WHERE [Email Adresse] = 'delete_me@gmail.com'

Hinweis: Damit die Löschung funktioniert, muss für diese Datenerweiterung ein Primärschlüssel vorhanden sein.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Salesforce Marketing Cloud-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Salesforce Marketing Cloud und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Salesforce Marketing Cloud können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Subscriber WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der Jitterbit Connector für Salesforce Marketing Cloud modelliert zwei Salesforce Marketing Cloud APIs als relationale Datenbanken, die REST- API und die SOAP API. Setzen Sie die Schema-Eigenschaft und verwenden Sie die Informationen in jedem Abschnitt, um basierend auf den Anforderungen Ihres Projekts die richtige API auszuwählen.

Verwenden der REST- API

Die REST- API bietet einen breiteren Zugriff auf die Funktionen von Salesforce Marketing Cloud. Alle neuen Salesforce Marketing Cloud-Technologien implementieren die REST- API. Siehe REST-Datenmodell für die verfügbaren Entitäten in der REST- API.

Verwenden der SOAP API

Die SOAP API bietet umfassenden Zugriff auf die meisten Email Funktionen. Die SOAP API verwendet SOAP Umschläge, um Informationen zwischen Ihnen und Salesforce Marketing Cloud zu übermitteln. Siehe SOAP Datenmodell für die verfügbaren Entitäten in der SOAP API.

REST-Datenmodell

Der Connector modelliert die Salesforce Marketing Cloud REST- APIs als Datenbank-Tabellen und Gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt, mit denen Schemata leicht angepasst werden können.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Tabellen

Tabellen beschreibt die verfügbaren Tabellen. Tabellen werden statisch definiert, um Assets, Kategorien, Reisen und mehr zu modellieren.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Salesforce Marketing Cloud. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Salesforce Marketing Cloud, einschließlich des Herunterladens und Hochladens von Objekten.

Tabellen

Der Connector modelliert die Daten in Salesforce Marketing Cloud als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Jitterbit-Connector für Salesforce Marketing Cloud Tabellen

Vermögenswerte

Erstellen, aktualisieren, löschen und Abfrage Assets aus Ihrem SalesForce Marketing Cloud-Konto ab.

Tabellenspezifische Informationen

Auswählen

Alle Assets auswählen:

SELECT * FROM ASSETS

Ein bestimmtes Asset abrufen:

SELECT * FROM ASSETS WHERE ID = 20088

Erweiterte serverseitige Filterung mit 'AND' Und 'OR' Für diese Tabelle werden logische Operatoren unterstützt. Sie können in den Tabelleninformationen prüfen, ob die Spalte unterstützte Filter hat. Alle Spalten, die unterstützte Filter haben, können auch serverseitig sortiert werden.

SELECT * FROM ASSETS WHERE (Id = 5895 OR ID = 19442) AND EnterpriseId = 7307527 ORDER BY Name ASC, ID DESC

Einfügen

Um ein Asset zu erstellen, müssen Sie mindestens die Spalten „Name“ und „TypeId“ angeben.

INSERT INTO ASSETS (TypeID, TypeName, Name) VALUES (207, 'templatebasedemail', 'First_Based_Template_Email_')

Aktualisieren

Assets können geändert werden, indem die ID des Assets angegeben und eine UPDATE-Anweisung ausgegeben wird.

UPDATE ASSETS SET Description = 'This is an updated asset.', Data = '
  "campaigns": {
    "campaigns": [
      {
        "campaignId": 12345,
        "campaignAssociationId": 2387
      }
    ]
  },
"email": { } ... }'  WHERE ID = 19442

Löschen

Assets können gelöscht werden, indem die ID des Assets angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM ASSETS WHERE ID = 20027

Spalten

Rückrufe

Erstellen, Aktualisieren, Löschen und Abfrage von Ereignisbenachrichtigungs-Rückrufen

Tabellenspezifische Informationen

Auswählen

Alle Rückrufe auswählen:

SELECT * FROM Callbacks

Einen bestimmten Rückruf abrufen:

SELECT * FROM Callbacks WHERE CallbackId = 94766

Einfügen

Um einen Rückruf zu erstellen, müssen Sie mindestens die Spalten „CallbackName“ und „URL“ angeben.

INSERT INTO`[Rückrufe] `(CallbackName, Url) VALUES ('cb1', 'https://example.com')

Aktualisieren

Rückrufe können geändert werden, indem die Callback-ID des Rückrufs angegeben und eine UPDATE-Anweisung ausgegeben wird.

UPDATE`[Rückrufe] `SET CallbackName = 'cb update' WHERE CallbackId = '34cd6cfe-5a21-4f3e-94c5-b6313a6954a4'

Löschen

Rückrufe können gelöscht werden, indem die CallbackId des Rückrufs angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM`[Rückrufe] `WHERE CallbackId = '43841979-7154-4fc4-9789-909dbba3a54f'

Spalten

Kampagnen

Kampagnen erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Auswählen

Alle Kampagnen auswählen:

SELECT * FROM Campaigns

Eine bestimmte Kampagne abrufen:

SELECT * FROM Campaigns WHERE ID = '3130'

Einfügen

Um eine Kampagne zu erstellen, müssen Sie mindestens die Spalte „Name“ angeben.

INSERT INTO`[Kampagnen] `(Name, Description, CampaignCode, Color, Favorite) VALUES ('Test Camp', 'Test Description', 'tst 001', '0000ff', true)

Aktualisieren

UPDATE-Operationen werden für diese Tabelle nicht unterstützt.

Löschen

Kampagnen können gelöscht werden, indem die CampaignId der Kampagne angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM`[Kampagnen] `WHERE ID = '5161'

Spalten

Kategorien

Erstellen, aktualisieren, löschen und Abfrage Kategorien (Ordner) im Content Builder.

Tabellenspezifische Informationen

Auswählen

Alle Kategorien auswählen:

SELECT * FROM Categories

Alle Kategorien abrufen, die eine bestimmte ParentId haben:

SELECT * FROM Categories WHERE ParentId = 71839

Eine bestimmte Kategorie abrufen:

SELECT * FROM Categories WHERE ID = 94766

Alle Spalten außer SharedWith und SharingType können serverseitig sortiert werden:

SELECT * FROM Categories ORDER BY Name ASC

Einfügen

Um eine Kategorie zu erstellen, müssen Sie mindestens die Spalten „Name“ und „ParentId“ angeben.

INSERT INTO Categories (Name, ParentId, categoryType) VALUES ('New New New Folder', 71839, 'asset')

Aktualisieren

Kategorien können geändert werden, indem die ID der Kategorie angegeben und eine UPDATE-Anweisung ausgegeben wird.

UPDATE Categories SET SharedWith = '333,555,888', SharingType = 'edit', EnterpriseId = 12345 WHERE ID = 71839

Löschen

Kategorien können gelöscht werden, indem die ID der Kategorie angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Categories WHERE ID = 94843

Spalten

Ereignisdefinitionen

Ereignisdefinitionen erstellen, löschen und Abfrage.

Tabellenspezifische Informationen

Auswählen

Alle Ereignisdefinitionen abrufen:

SELECT * FROM EventDefinitions

Eine bestimmte Ereignisdefinition abrufen:

SELECT * FROM EventDefinitions WHERE ID = '9955614b-02e7-4147-91a2-3f5f5fe9d679'

Alle Ereignisdefinitionen abrufen, die in einem bestimmten Modus ausgeführt werden:

SELECT * FROM EventDefinitions WHERE Mode = 'Test'

Alle Ereignisdefinitionen abrufen, die die angegebene zitierte Phrase in ihrem Namen enthalten:

SELECT * FROM EventDefinitions WHERE CONTAINS (Name, 'Welcome Journey')

Einfügen

Um eine Ereignisdefinition zu erstellen, müssen Sie mindestens die Spalten „Name“ und „Typ“ angeben. DataExtensionId ist ebenfalls erforderlich. Wenn Sie es nicht angeben, müssen Sie die Spalte „Schema“ angeben.

INSERT INTO EventDefinitions (Type, Name, DataExtensionId, IsVisibleInPicker) VALUES ('Event', 'FirstEventDefinition', '74bc3342-eaca-e711-b98f-38eaa71427a1', true)

Löschen

Ereignisdefinitionen können gelöscht werden, indem die ID der Ereignisdefinition angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM EventDefinitions WHERE ID = 'f10efb9e-cb91-4fc9-be50-c20f00f7f255'

Spalten

FacebookMessengerEigenschaften

Facebook Messenger-Eigenschaften abfragen und erstellen.

Tabellenspezifische Informationen

Auswählen

Alle registrierten Facebook Messenger-Eigenschaften abrufen:

SELECT * FROM FacebookMessengerProperties

Eine bestimmte registrierte Facebook Messenger-Eigenschaft abrufen:

SELECT * FROM FacebookMessengerProperties WHERE PageId = '1732555047025799'

Einfügen

Um eine neue Facebook Messenger-Eigenschaft zu registrieren, müssen Sie PageId, ApplicationId, ApplicationSecret, PageName, PageAccessToken, CallbackVerifyToken, EndpointUrl und ApiVersion angeben:

INSERT INTO FacebookMessengerProperties (PageId, ApplicationId, ApplicationSecret, PageName, PageAccessToken, EndpointUrl, CallbackVerifyToken, ApiVersion) VALUES ('1732555047025799', '1093076390764037', '03d537gg656gvkbe9b430f002e9c4517', 'SFMC Engineers', 'someaccesstoken4fasdcruib213123knubkdnfisdubnu12312ub3pijnb', 'https://graph.facebook.com/v2.6/me/messages', 'this_is_the_verify_token', 'v2.0')

Spalten

ReiseAktivitäten

Erstellen, aktualisieren und Abfrage Reiseaktivitäten.

Tabellenspezifische Informationen

Auswählen

Reiseaktivitäten für die neueste Version der angegebenen Reise abrufen:

SELECT * FROM JourneyActivities WHERE JourneyId = '1cb643b5-3144-4d17-80fa-a1f0035e78e2'

Reiseaktivitäten für eine bestimmte Reiseversion abrufen:

SELECT * FROM JourneyActivities WHERE JourneyId = '1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND JourneyVersion = 1

Reiseaktivitäten von allen Reisen mit einer bestimmten Version abrufen:

SELECT * FROM JourneyActivities WHERE JourneyVersion = 1

Einfügen

Um eine neue Reiseaktivität zu erstellen, müssen Sie mindestens die Spalten JourneyId, JourneyVersion, Type, Key, Arguments und ConfigurationArguments angeben.

INSERT INTO JourneyActivities (JourneyId, JourneyVersion, Type, Key, Arguments, ConfigurationArguments) VALUES ('4753026f-20b2-481b-89c5-fcd76ffa41f7', 1, 'WAIT', 'WAITBYDURATION-1', '{
  "waitEndDateAttributeDataBound": "",
  "waitDefinitionId": "f3de0c9a-5ff8-4f7b-84bd-9309ca337227",
  "waitForEventId": "",
  "executionMode": "{{Context.ExecutionMode}}",
  "startActivityKey": "{{Context.StartActivityKey}}",
  "waitQueueId": "{{Context.WaitQueueId}}"
}', '{
  "waitDuration": 1,
  "waitUnit": "DAYS",
  "specifiedTime": "",
  "timeZone": "",
  "description": "",
  "waitEndDateAttributeExpression": "",
  "specificDate": "",
  "waitForEventKey": ""
}')

Aktualisieren

Reiseaktivitäten können durch Angabe der ID, Reise-ID, Reiseversion und Ausgabe einer UPDATE-Anweisung geändert werden.

UPDATE JourneyActivities SET Description = 'First_Journey_Activity_Description', Outcomes = '[
  {
    "key": "11bb2807-3f3d-4305-af51-547df032dbaf",
    "next": "WAITBYDURATION-1",
    "arguments": null,
    "metaData": null
  }
]' WHERE ID = 'fa4c3d81-8043-40e2-9741-22708d3a2e25' AND  JourneyId = '4753026f-20b2-481b-89c5-fcd76ffa41f7' AND JourneyVersion = 1

Spalten

Reisen

Reisen erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Auswählen

Reisen mit der aktuellsten Version abrufen:

SELECT * FROM Journeys

Rufen Sie eine Reiseversion ab:

SELECT * FROM Journeys WHERE ID = '1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND Version = 1

Alle Reiseversionen abrufen:

SELECT * FROM Journeys WHERE MostRecentVersionOnly = false

Reisen mit einem bestimmten Tag abrufen:

SELECT * FROM Journeys WHERE Tag = 'First_Tag'

Reisen abrufen, die die angegebene Suchzeichenfolge im Namen oder in der Beschreibung enthalten:

SELECT * FROM Journeys WHERE NameOrDescription = 'Journey'

Rufen Sie Journeys mit einer bestimmten Workflow-API Version ab:

SELECT * FROM Journeys WHERE workFlowApiVersion = 1

Reisen mit bestimmter Version abrufen:

SELECT * FROM Journeys WHERE Version = 1

Fahrten mit bestimmtem Status abrufen:

SELECT * FROM Journeys WHERE Status = 'Draft'

Reisen nach Änderungsdatum oder Namensspalte sortieren:

SELECT * FROM Journeys ORDER BY ModifiedDate DESC
SELECT * FROM Journeys ORDER BY Name DESC

Einfügen

Um eine neue Reise zu erstellen, müssen Sie mindestens die Spalte „Name“ angeben.

INSERT INTO Journeys (Name) VALUES ('API-Created journey')

Um eine neue Reiseversion zu erstellen, müssen Sie einen vorhandenen Reiseschlüssel angeben.

INSERT INTO Journeys (Name, Key) VALUES ('API-Created journey Version 3', '53bf5ea2-ff59-4c00-a23a-b1e9e333b80c')

Aktualisieren

Reisen können geändert werden, indem die ID und Version der Reise angegeben und eine UPDATE-Anweisung ausgegeben wird.

UPDATE Journeys SET Name = 'API-Updated journey' WHERE ID = '257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version = 5

Löschen

Reisen können gelöscht werden, indem die ID der Reise angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Journeys WHERE ID = '53bf5ea2-ff59-4c00-a23a-b1e9e333b80c'

Reiseversionen können gelöscht werden, indem die ID und Version der Reise angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Journeys WHERE ID = '257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version = 5

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

LineMessengerEigenschaften

Line Messenger-Eigenschaften abfragen und erstellen.

Tabellenspezifische Informationen

Auswählen

Alle registrierten Line Messenger-Eigenschaften abrufen:

SELECT * FROM LineMessengerProperties

Eine bestimmte registrierte Eigenschaft eines Line Messengers abrufen:

SELECT * FROM LineMessengerProperties WHERE ID = '23493453984234345'

Einfügen

Um eine neue Eigenschaft für einen Zeilen-Messenger zu registrieren, müssen Sie ChannelId, ChannelName, ChannelSecret, IsTransactional, IsTestChannel, EndpointUrl und ApiVersion angeben:

INSERT INTO LineMessengerProperties (ChannelId, ChannelName, ChannelSecret, EndpointUrl, IsTransactional, IsTestChannel, IsActive, ApiVersion) VALUES ('23493453984234345', 'SFMC Engineers', '03d537gg656gvkbe9b430f002e9c4517', 'https://example.com/1732555047025799', true, false, true, 'v2.0')");

Spalten

SendDefinitions

Sendedefinitionen erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Auswählen

Alle Sendedefinitionen abrufen:

SELECT * FROM SendDefinitions

Eine bestimmte Sendedefinition abrufen:

SELECT * FROM SendDefinitions WHERE DefinitionKey = '9955614b-02e7-4147-91a2-3f5f5fe9d679'

Alle Sendedefinitionen mit dem Status „Aktiv“ abrufen:

SELECT * FROM SendDefinitions WHERE Status = 'Active'

Einfügen

Um eine Sendedefinition zu erstellen, müssen Sie mindestens die Spalten DefinitionKey, Name, SubscriptionsList und ContentCustomerKey angeben.

INSERT INTO SendDefinitions (DefinitionKey, Name, ContentCustomerKey, SubscriptionsList, OptionsCc, OptionsCreateJourney) VALUES ('TEST_Definition_Key', 'Test Definition Key', '76ad3572-abbc-4baa-b3fe-04c4364bf34a', 'All Subscribers', 'john@example.com', true)

Aktualisieren

Um eine Sendedefinition zu aktualisieren, müssen Sie den DefinitionKey der SendDefinition angeben.

UPDATE SendDefinitions SET OptionsCc = 'john@example.com,steve@example.com', OptionsBcc = 'michael@example.com,richard@example.com' WHERE DefinitionKey = 'TEST_Definition_Key'

Löschen

Sendedefinitionen können gelöscht werden, indem der Definitionsschlüssel der Sendedefinition angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM SendDefinitions WHERE DefinitionKey = 'TEST_Definition_Key'

Spalten

Abonnements

Erstellen, aktualisieren, löschen und Abfrage Abonnements für Ereignisbenachrichtigungen.

Tabellenspezifische Informationen

Auswählen

Alle Abonnements auswählen:

SELECT * FROM Subscriptions

Ein bestimmtes Abonnement abrufen:

SELECT * FROM Subscriptions WHERE SubscriptionId = 94766

Einfügen

Um ein Abonnement zu erstellen, müssen Sie mindestens die Spalten „SubscriptionName“, „CallbackId“ und „EventCategoryTypes“ angeben.

INSERT INTO`[Abonnements] `(SubscriptionName, CallbackId, EventCategoryTypes) VALUES ('sajli subscription', '6fb0758b-155d-4968-869d-7a4f5a3ad2fe', '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]')

Aktualisieren

Abonnements können geändert werden, indem die SubscriptionId und die EventCategoryTypes-Spalte des Abonnements angegeben und eine UPDATE-Anweisung ausgegeben wird.

UPDATE`[Abonnements] `SET Status = 'paused', EventCategoryTypes = '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]' WHERE SubscriptionId = 'db1e2af0-807d-463b-96e8-fe3aaa019fdb'

Löschen

Abonnements können gelöscht werden, indem die SubscriptionId des Abonnements angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM`[Abonnements] `WHERE SubscriptionId = '43841979-7154-4fc4-9789-909dbba3a54f'

Spalten

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Jitterbit-Connector für Salesforce Marketing Cloud Ansichten

Asset-Typen

Holen Sie sich alle verfügbaren Asset-Typen in der Salesforce Marketing Cloud.

Tabellenspezifische Informationen

Auswählen

Alle Asset-Typen abrufen:

SELECT * FROM AssetTypes

Spalten

Kampagnenressourcen

Rufen Sie alle Kampagnenressourcen in der Salesforce Marketing Cloud ab.

Spezifische Informationen anzeigen

Auswählen

Alle Kampagnen-Assets für eine bestimmte Kampagne auswählen:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130'

Eine bestimmte Kampagne abrufen:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130' AND ID = '3325'

Spalten

Kontakt

Rufen Sie Kontakte in der Salesforce Marketing Cloud ab.

Tabellenspezifische Informationen

Wählen Sie

Alle Kontakte abrufen:

SELECT * FROM Contact

Kontakte im Status „gelöscht“, „wird gelöscht“ oder „eingeschränkt“ werden nicht abgerufen.

Spalten

Kontakte

Rufen Sie alle Kontakte in der Salesforce Marketing Cloud ab.

Tabellenspezifische Informationen

Auswählen

Alle Kontakte abrufen:

SELECT * FROM Contacts

Kontakte im Status „gelöscht“, „wird gelöscht“ oder „eingeschränkt“ werden nicht abgerufen.

Spalten

Reise-Audit-Protokolle

Ruft ein Prüfprotokoll einer Reise und ihrer Versionen ab.

Spalten

ReiseGeschichte

Gibt den Verlauf einer Reise an. Der Datensatzzugriff darf das 10.000ste Element nicht überschreiten.

Tabellenspezifische Informationen

Auswählen

Ruft Informationen zu einem bestimmten Kontakt, einer bestimmten Reise oder einer bestimmten Reiseversion ab.:

SELECT * FROM JourneyHistory

Ruft Informationen zu einem bestimmten Kontakt, einer bestimmten Reise oder Reiseversion innerhalb des angegebenen Datumsbereichs ab.:

SELECT * FROM JourneyHistory where TransactionTime >= '2022-09-01T10:29:22.438Z' and TransactionTime <= '2022-09-30T11:29:22.438Z'

SELECT * FROM JourneyHistory where TransactionTime > '2022-09-01T10:29:22.438Z' and TransactionTime < '2022-09-30T11:29:22.438Z'

SELECT * FROM JourneyHistory where TransactionTime = '2022-09-01T10:29:22.438Z'

Spalten

SMS-Statuscodes

SMS-Statuscodes abfragen.

Tabellenspezifische Informationen

Wählen

Rufen Sie alle Statuscodes für die folgenden Länder ab: USA, Kanada, Brasilien und Indien. Verwenden Sie diese Codes zur Auswertung und fehlerbehebung Ihrer SMS-Sendungen.

SELECT * FROM SmsStatusCodes

Spalten

TransaktionaleNachrichten

Erhält eine paginierte Liste der Nachrichten, die nicht gesendet wurden, sortiert von der ältesten zur neuesten.

Tabellenspezifische Informationen

Auswählen

Alle Transaktionsnachrichten auswählen:

SELECT * FROM TransactionalMessages

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Salesforce Marketing Cloud hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Salesforce Marketing Cloud zurück, zusammen mit einem Hinweis, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Jitterbit-Connector für gespeicherte Prozeduren in Salesforce Marketing Cloud

CreateImportSendDeliveryReport

Generiert eine CSV-Datei mit Informationen zur SMS-Nachrichtenübermittlung für eine bestimmte Nachrichtenliste und platziert den Bericht im erweiterten FTP Speicherort für das Marketing Cloud-Konto.

Eingang

Ergebnissatzspalten

Schlüsselwort erstellen

Erstellt ein Schlüsselwort für ein Konto.

Eingang

Ergebnissatzspalten

NachrichtenlisteZustellungsbericht erstellen

Löst einen Zustellbericht für die MessageList API aus.

Eingang

Ergebnissatzspalten

Opt-In-Nachricht erstellen

Erstellt eine SMS-Opt-in-Nachricht, die es Kontakten ermöglicht, weitere SMS-Nachrichten zu abonnieren.

Eingang

Ergebnissatzspalten

ErstellenTriggeredSenden

Erstellen Sie ein ausgelöstes Sendeobjekt, das eine bestimmte Instanz eines ausgelösten Email Versands darstellt.

Tabellenspezifische Informationen

Abonnentenattribute

Um Abonnentenattribute zu erstellen, müssen Sie Daten in eine temporäre Tabelle namens „Subscribers#TEMP“ einfügen.

INSERT INTO Subscribers#Temp(Order_Number,Order_Status,Purchase_Date) VALUES (1234,'received','2015-06-30 11:10:36.956')

EXECUTE CreateTriggeredSend  key='TEST_1', FromAddress='test123@salesforce.com', FromName='test', ToAddress='arctest42@gmail.com',SubscriberKey='12345678', Subscribers='Subscribers#Temp'

Ausführen

Sie können die gespeicherte Prozedur ausführen.

EXECUTE CreateTriggeredSend  key='TEST_1', FromAddress='test123@salesforce.com', FromName='test', ToAddress='arctest42@gmail.com',SubscriberKey='12345678'

EXECUTE CreateTriggeredSend  key='TEST_1', FromAddress='test123@salesforce.com', FromName='test', ToAddress='arctest42@gmail.com', SubscriberKey='12345678', SubscriberAttributes='{\"attrname\":\"test\",\"attrname2\":22,\"attrname3\":\"testing\"}'

Eingabe

Ergebnissatzspalten

Schlüsselwort löschen

Löscht ein Schlüsselwort auf einem Konto.

Schlüsselwort nach ID löschen

Löscht ein Schlüsselwort auf einem Konto mit einer angegebenen Schlüsselwort-ID.

EXECUTE DeleteKeyword KeywordId = 'alm5LXNSSktGMGluRznRb1Rb1R5MDZFQTo4Njow'

Schlüsselwort nach Longcode löschen

Löscht ein Schlüsselwort auf einem Konto, das ein Schlüsselwort und einen langen Code enthält.

EXECUTE DeleteKeyword LongCode = '5550003232', Keyword = 'TEST'

Schlüsselwort per Kurzcode löschen

Löscht ein Schlüsselwort auf einem Konto, das mit einem Schlüsselwort, einem Kurzcode und einem Ländercode versehen ist.

EXECUTE DeleteKeyword ShortCode = '89239', Keyword = 'TEST', CountryCode = 'US'

Eingang

Ergebnissatzspalten

Feuereintrittsereignis

Lösen Sie das Eintrittsereignis aus, das die Reise einleitet.

Eingang

Ergebnissatzspalten

GetChannelViewHtml

Gibt das kompilierte HTML der angeforderten Kanalansicht für das Asset zurück.

Eingang

Ergebnissatzspalten

GetDeliveryStatusOfQueuedMO

Ruft den Lieferstatus eines in die Warteschlange gestellten MO ab.

Eingang

Ergebnissatzspalten

DateiFürEinAssetAbrufen

Ruft die Binärdatei für ein Asset ab.

Eingang

Ergebnissatzspalten

GetHeaderFooterAccount

Ruft die Header und -fußzeile für ein Konto ab.

Ergebnissatzspalten

GetHeaderFooterEmail

Ruft die Header und Fußzeile einer Email ab.

Eingang

Ergebnissatzspalten

GetImportSendStatus

Ruft den Status einer ImportSend-Automatisierung ab.

Eingang

Ergebnissatzspalten

Importstatus abrufen

Ruft den Status eines Importauftrags ab.

Eingang

Ergebnissatzspalten

Reisepublikationsstatus abrufen

Ruft den Status einer Reiseveröffentlichung ab.

Eingang

Ergebnissatzspalten

GetMessageContactHistory

Ruft die letzte an eine Mobiltelefonnummer gesendete Nachricht ab.

Eingang

Ergebnissatzspalten

GetMessageContactStatus

Ruft den Gesamtzustellungsstatus einer Nachricht an einen Kontakt ab.

Eingang

Ergebnissatzspalten

Nachrichtenlistenstatus abrufen

Gibt den Status einer an eine Gruppe von Mobiltelefonnummern gesendeten Nachricht zurück.

Eingang

Ergebnissatzspalten

GetMessageSendStatus

Ruft den Sendestatus einer Nachricht ab.

EXECUTE GetMessageSendStatus MessageKey = 'bcX0qaEp0USGciEnUJTW0w'

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Erhält ein Authentifizierungstoken von SalesforceMarketingCloud.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs-URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt.

Eingang

Ergebnissatzspalten

GetRefreshListStatus

Ruft den Aktualisierungslistenstatus ab.

Eingang

Ergebnissatzspalten

Abonnementstatus abrufen

Gibt den Abonnementstatus für Mobiltelefonnummern oder Abonnentenschlüssel zurück.

EXECUTE GetSubscriptionStatus MobileNumbers = '["15555555555"]'
EXECUTE GetSubscriptionStatus SubscriberKeys = '["ExampleSubKey1"]'

Eingang

Ergebnissatzspalten

GetTrackingHistoryOfQueuedMO

Ruft den Trackingverlauf eines in die Warteschlange gestellten MO ab.

Eingang

Ergebnissatzspalten

ImportAndSendMessage

Importiert und sendet.

EXECUTE ImportAndSendMessage MessageId = 'MessageId', " +
          "Keyword = 'Test_Keyword'," +
          "NotificationEmail = 'myEmail@example.com'," +
          "IsDuplicationAllowed = true," +
          "IsDuplicationAllowed = true," +
          "ImportDefinition = '[{" +
          "    \"FileName\": \"MyTestList.csv\"," +
          "    \"ImportType\": \"FILE\"," +
          "    \"ImportMappingType\": \"ManualMap\"," +
          "    \"FieldMaps\": [{" +
          "      \"Destination\": \"_FirstName\"," +
          "      \"Source\": \"First Name\"" +
          "    }, {" +
          "      \"Destination\": \"_Subscriberkey\"," +
          "      \"Source\": \"Subscriber Key\"" +
          "    }, {" +
          "      \"Destination\": \"_LastName\"," +
          "      \"Source\": \"Last Name\"" +
          "    }, {" +
          "      \"Destination\": \"_MobileNumber\"," +
          "      \"Source\": \"Mobile\"" +
          "    }, {" +
          "      \"Destination\": \"_CountryCode\"," +
          "      \"Source\": \"Country\"" +
          "    }]" +
"  }]'

Eingang

Ergebnissatzspalten

PostMessageToList

Initiiert eine Nachricht an eine oder mehrere Kontaktlisten.

EXECUTE PostMessageToList MessageId = 'NCNSDNsd222as85dj92j2sM',  TargetListIds = ' [" +
          "        \"bzZ0cENGam1FZUtNX0poTDRYZzhlQTo2Mzow\"" +
          "    ]', OverrideTemplateTargetLists = true, OverrideTemplateExclusionLists = false, IgnoreExclusionLists = true, OverrideMessageText = false, " +
          "ContentURL = 'http://image.exct.net/lib/fe6d15707662057c7411/m/1/dj_CC_AUS.jpg'," +
"UtcOffset = '-0500', WindowStart = '1500', WindowEnd = '2200', AllowDuplication = false

Eingang

Ergebnissatzspalten

PostMessageToNumber

Initiiert eine Nachricht an eine oder mehrere Mobiltelefonnummern.

Abonnenten

Die für die temporäre Tabelle „Abonnenten“ verfügbaren Spalten sind die folgenden:

Ausführen

Mobiltelefonnummern zur Referenzierung von Kontaktdatensätzen verwenden:

EXECUTE PostMessageToNumber MessageId = 'NCNSDNsd222as85dj92j2sM', mobileNumbers = '[" +
          "    \"13175551212\"" +
"    ]', Subscribe = true, Resubscribe = true, keyword = 'JOINSMS', Override = true, messageText = 'Welcome to Code@', ContentURL = 'http://image.exct.net/lib/abcd/m/1/dj_CC_AUS.jpg', SendTime = '2012-10-05 20:01'

Verwenden Sie die Tabelle Subscribers#TEMP als alternative Möglichkeit zum Verweisen auf Kontaktdatensätze:

INSERT INTO Subscribers#TEMP (MobileNumber, SubscriberKey, Attributes) VALUES ('15555554410', 'ExampleSubKey1', '{" +
          "            \"FirstName\":\"Michael\"" +
          "            }')
INSERT INTO Subscribers#TEMP (MobileNumber, SubscriberKey, Attributes) VALUES ('15555552254', 'ExampleSubKey2', '{" +
          "            \"FirstName\":\"Kristen\"" +
          "            }')
EXECUTE PostMessageToNumber MessageId = 'NCNSDNsd222as85dj92j2sM', Subscribe = true, Resubscribe = true, Keyword = 'JOINSMS', Override = false, SendTime = '2012-10-05 20:01'

Eingang

Ergebnissatzspalten

VeröffentlichenReise

Veröffentlicht eine Reiseversion asynchron.

Eingang

Ergebnissatzspalten

WarteschlangeKontaktImport

Stellt einen Kontaktimport in die Warteschlange.

Feldkarten

Die für die temporäre FieldMaps-Tabelle verfügbaren Spalten sind die folgenden:

Ausführen

INSERT INTO FieldMaps#TEMP (destination, ordinal, source) VALUES ('_MobileNumber', 2, 'mobile number')
INSERT INTO FieldMaps#TEMP (destination, ordinal, source) VALUES ('_CountryCode', 3, 'locale')
INSERT INTO FieldMaps#TEMP (destination, ordinal, source) VALUES ('_SubscriberKey', 1, 'subscriber key')
EXECUTE QueueContactImport ListId = 'UEhwdktFWXpFZUs3Z3hRUW45R2dBQTo2Mzow', ShortCode = '90913', Keyword = 'WELCOME', SendEmailNotification = true, EmailAddress = 'example@example.com', " +
"ImportMappingType = 'MapByOrdinal', FileName = 'testdata.csv', FileType = 'csv', IsFirstRowHeader = true

Eingang

Ergebnissatzspalten

WarteschlangeMoNachricht

Stellt eine MO-Nachricht zum Senden in die Warteschlange.

EXECUTE QueueMoMessage MobileNumbers = '[" +
          "  \"15555551212\"" +
          "  ]', ShortCode = '86288', MessageText = 'CODETEST'
EXECUTE QueueMoMessage Subscribers = '[    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551212\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     },    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551213\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     }   " +
"   ]', ShortCode = '86288', MessageText = 'CODETEST'

Eingang

Ergebnissatzspalten

Liste aktualisieren

Aktualisiert eine Liste.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert das OAuth-Zugriffstoken, das für die Authentifizierung mit SalesforceMarketingCloud verwendet wird.

Eingang

Ergebnissatzspalten

SendeNachrichtAnEmpfänger

Senden Sie eine OTT-Nachricht an den Empfänger. Unterstützte OTT-Netzwerke sind Facebook Messenger und LINE.

Nachrichteninhalt

Sie können keine OTT-Nachricht an den Empfänger senden, ohne den Inhalt der Nachricht anzugeben. Um Nachrichteninhalte zu erstellen, müssen Sie Daten in eine temporäre Tabelle namens „MessageContents#TEMP“ einfügen. Die für diese temporäre Tabelle verfügbaren Spalten sind die folgenden:

MessageCustomKeys

Sie können auch benutzerdefinierte Nachrichtenschlüssel angeben, die in der Payload weitergegeben werden sollen, indem Sie Daten in eine temporäre Tabelle mit dem Namen „MessageCustomKeys#TEMP“ einfügen. Für diese temporäre Tabelle sind die folgenden Spalten verfügbar:

Ausführen

Messenger-Nachricht senden:

INSERT INTO MessageContents#TEMP (type, text) VALUES ('text', 'thanks for purchase')
INSERT INTO MessageCustomKeys#TEMP (messagingType) VALUES ('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey = 'e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey = 'CanBeAGUIDorAny100UnicodeCharString', SenderType = 'messenger', SenderId = '503868699681937', OttId = 'FBfacdb735074f7c492c0bf190fa99020', UserReference = '1938cd4d34cc4db0b109756b8a9b14ff', Subject = 'Message Name', ValidityPeriod = 30"

Verschiedene Messenger-Inhaltstypen:

INSERT INTO MessageContents#TEMP (type, url, AltUrl, IsReusable, AttachmentId) VALUES ('image', 'https://example.com/original.jpg', 'https://example.com/preview.jpg', true, 12345)
INSERT INTO MessageCustomKeys#TEMP (messagingType) VALUES ('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey = 'e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey = 'CanBeAGUIDorAny100UnicodeCharString', SenderType = 'messenger', SenderId = '503868699681937', OttId = 'FBfacdb735074f7c492c0bf190fa99020', UserReference = '1938cd4d34cc4db0b109756b8a9b14ff', Subject = 'Message Name', ValidityPeriod = 30"

LINE-Nachricht gesendet:

INSERT INTO MessageContents#TEMP (type, text) VALUES ('text', 'thanks for purchase')
INSERT INTO MessageCustomKeys#TEMP (messagingType) VALUES ('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey = 'CanBeAGUIDorAny100UnicodeCharString', MessageGroupKey = 'CanBeAGUIDorAny100UnicodeCharString', SenderType = 'line', SenderId = '2145435435632435', OttId = 'U42348yafsd8y3248yfsq8cy9088934d', UserReference = '1938cd4d34cc4db0b109756b8a9b14ff', Subject = 'Message Name', ValidityPeriod = 30"

Eingang

Ergebnissatzspalten

Transaktionsnachricht an mehrere Empfänger senden

Sendet eine Nachricht über eine Sendedefinition an einen einzelnen Empfänger.

Ausführen

Transaktionsnachricht senden:

Für RecipientAggregate und Attribute entweder JSON oder temporäre Tabelle als Eingabe. Beispiel:

INSERT INTO RecipientAggregate#TEMP (RecipientContactKey, RecipientTo, RecipientMessageKey, RecipientAttributes) VALUES ('recipient1', 'recipient1@example.com', 'nFL4ULgheUeaGbPIMzJJSw', '{"RequestAttribute_1":"value_1", "RequestAttribute_2":"value_2", "Attribute1":"This is one for recipient1", "Attribute2":"This is two for recipient1"}');
INSERT INTO RecipientAggregate#TEMP (RecipientContactKey, RecipientTo, RecipientMessageKey, RecipientAttributes) VALUES ('recipient2', 'recipient2@example.com', 'GV1LhQ6NFkqFUAE1IsoQ9Q', '{"UserAttribute_3":"value_3", "UserAttribute_4":"value_4"}');

EXECUTE SendTransactionalMessageToMultipleRecipients DefinitionKey = '2FA_order_accounts', RecipientAggregate = 'RecipientAggregate#TEMP', Attributes = '{"UserAttribute_a":"value_a", "UserAttribute_b":"value_b"}'

INSERT INTO Attributes#TEMP (UserAttr_1, UserAttr_2) VALUES ('UserAttrValue_1', 'UserAttrValue_2');

INSERT INTO RecipientAggregate#TEMP (RecipientContactKey, RecipientTo, RecipientMessageKey, RecipientAttributes) VALUES ('recipient1', 'recipient1@example.com', 'nFL4ULgheUeaGbPIMzJJSw', '{"RequestAttribute_1":"value_1", "RequestAttribute_2":"value_2", "Attribute1":"This is one for recipient1", "Attribute2":"This is two for recipient1"}');
INSERT INTO RecipientAggregate#TEMP (RecipientContactKey, RecipientTo, RecipientMessageKey, RecipientAttributes) VALUES ('recipient2', 'recipient2@example.com', 'GV1LhQ6NFkqFUAE1IsoQ9Q', '{"UserAttribute_3":"value_3", "UserAttribute_4":"value_4"}');


EXECUTE SendTransactionalMessageToMultipleRecipients DefinitionKey = '2FA_order_accounts', RecipientAggregate = 'RecipientAggregate#TEMP', Attributes = 'Attributes#TEMP'

Eingang

Ergebnissatzspalten

SendeTransaktionsnachrichtAnEmpfänger

Sendet eine Nachricht über eine Sendedefinition an einen einzelnen Empfänger.

Ausführen

Senden Sie eine Transaktionsnachricht:

Attribute unterstützen entweder JSON oder temporäre Tabellen als Eingabe. Beispiel:

EXECUTE SendTransactionalMessageToRecipient MessageKey = 'e1c35141-6e5c-4bc2-813b-60f969e52b0d', DefinitionKey = 'CanBeAGUIDorAny100UnicodeCharString', RecipientContactKey = 'd3c4a2d2-b620-4a39-88aa-b14868b766c6', RecipientTo = 'john@example.com', Attributes = '{"UserAttr_1":"UserAttrValue_1","UserAttr_2":"UserAttrValue_2"}'

INSERT INTO Attributes#TEMP (UserAttr_1, UserAttr_2) VALUES ('UserAttrValue_1', 'UserAttrValue_2');

EXECUTE SendTransactionalMessageToRecipient MessageKey = 'e1c35141-6e5c-4bc2-813b-60f969e52b0d', DefinitionKey = 'CanBeAGUIDorAny100UnicodeCharString', RecipientContactKey = 'd3c4a2d2-b620-4a39-88aa-b14868b766c6', RecipientTo = 'john@example.com', Attributes = 'Attributes#TEMP';

Eingang

Ergebnissatzspalten

StoppReise

Beenden Sie eine Laufreise.

Eingang

Ergebnissatzspalten

SOAP Datenmodell

Der Connector modelliert die Salesforce Marketing Cloud SOAP APIs als Datenbank-Tabellen und Ansichten. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt, mit denen Schemata leicht angepasst werden können.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL-Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Tabellen

Tabellen beschreibt die verfügbaren Tabellen. Tabellen werden statisch definiert, um Assets, Kategorien, Reisen und mehr zu modellieren.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden schreibgeschützte Daten als Ansichten angezeigt. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Salesforce Marketing Cloud, einschließlich des Herunterladens und Hochladens von Objekten.

Tabellen

Der Connector modelliert die Daten in Salesforce Marketing Cloud als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Jitterbit-Connector für Salesforce Marketing Cloud Tabellen

Konto

Ein Marketing Cloud-Konto.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle Werte außer Datums-/Uhrzeitwerten zu verarbeiten: =, !=, <>, >, >=, <, <=, IN. Für Datums-/Uhrzeitwerte werden nur > und < unterstützt. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden (aber nicht nur) Abfragen serverseitig verarbeitet:

SELECT * FROM Account WHERE Id = 123

SELECT * FROM Account WHERE Id IN (123, 456)

SELECT * FROM Account WHERE CreatedDate > '2017/01/25'

Einfügen

Sie müssen die Spalte „Name“ angeben, wenn Sie einen Einfügevorgang für diese Tabelle ausführen.

INSERT INTO Account (Name) VALUES ('Test')

Aktualisieren

Sie müssen die ID in der WHERE-Klausel angeben, wenn Sie ein Update für diese Tabelle ausführen.

UPDATE Account SET Fax = '1123123' WHERE ID = 123

Löschen

Sie müssen die ID in der WHERE-Klausel angeben, wenn Sie einen Löschvorgang für diese Tabelle ausführen.

DELETE FROM Account WHERE ID = 123

Spalten

KontoBenutzer

Ein einzelner Benutzer innerhalb eines Kontos. Diese Tabelle unterstützt keine Löschungen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle Werte außer Datums-/Uhrzeitwerten zu verarbeiten: =, !=, <>, >, >=, <, <=, IN. Für Datums-/Uhrzeitwerte werden nur > und < unterstützt. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden (aber nicht nur) Abfragen serverseitig verarbeitet:

SELECT * FROM AccountUser WHERE Id = 123

SELECT * FROM AccountUser WHERE Id IN (123, 456)

SELECT * FROM AccountUser WHERE CreatedDate > '2017/01/25'

Einfügen

Beim Einfügen in diese Tabelle müssen Sie die folgenden Felder angeben: Client_ID, Name, Email, Benutzer-ID und Kennwort.

INSERT INTO AccountUser (Client_Id, UserId, Name, Email, Password) VALUES (123, 'bcabsbasbcasb', 'Test', 'test@gmail.com', 'testpas@2sowrd')

Update

Sie müssen die ID und die Client_Id in der WHERE-Klausel angeben, wenn Sie ein Update für diese Tabelle ausführen.

UPDATE AccountUser SET Name = 'changed' WHERE ID = 123 AND Client_Id = 456

Spalten

Geschäftsbereich

Eine Einheit innerhalb eines größeren Enterprise- oder Enterprise 2.0-Kontos. Diese Tabelle unterstützt nur Abfragen und Aktualisierungen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle Werte außer Datums-/Uhrzeitwerten zu verarbeiten: =, !=, <>, >, >=, <, <=, IN. Für Datums-/Uhrzeitwerte werden nur > und < unterstützt. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden (aber nicht nur) Abfragen serverseitig verarbeitet:

SELECT * FROM BusinessUnit WHERE Id = 123

SELECT * FROM BusinessUnit WHERE Id IN (123, 456)

SELECT * FROM BusinessUnit WHERE CreatedDate > '2017/01/25'

Aktualisieren

Sie müssen die ID in der WHERE-Klausel angeben, wenn Sie ein Update für diese Tabelle ausführen.

UPDATE BusinessUnit SET Name = 'Changed' WHERE ID = 123

Spalten