Details zur Salesforce Marketing Cloud Verbindung

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Versionsunterstützung für Salesforce Marketing Cloud

Herstellen einer Verbindung

Authentifizieren Sie sich bei der Salesforce Marketing Cloud 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 App erstellen, um die OAuthClientId Und OAuthClientSecret Verbindungseigenschaften. Siehe OAuth-Authentifizierung verwenden für eine Anleitung zur Authentifizierung.

Authentifizieren Sie sich bei der Salesforce Marketing Cloud SOAP API

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

Um eine Verbindung zu Daten mithilfe der Basisauthentifizierung (Anmeldeinformationen) herzustellen, legen Sie Folgendes fest:

• User: Das zur Authentifizierung verwendete Salesforce Marketing Cloud-Benutzerkonto.
• Password: Das zur Authentifizierung des Benutzers verwendete Passwort.
• AuthScheme: Stellen Sie dies auf „Einfach“ ein.
• UseLegacyAuthentication: Setzen Sie dies auf True.

für Ihre Anmeldedaten.

Herstellen einer Verbindung zu den Salesforce Marketing Cloud APIs

Sobald Sie sich bei der SOAP oder REST- API authentifiziert haben, können Sie eine Verbindung zu den Daten herstellen.

Sie können den Datenzugriff optional mithilfe der folgenden Eigenschaften 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.

OAuth-Authentifizierung verwenden

OAuth erfordert, dass der authentifizierende Benutzer über den Browser mit Salesforce Marketing Cloud interagiert. Der Connector erleichtert dies auf verschiedene Weise, wie unten beschrieben.

Benutzerdefinierte Anmeldeinformationen

Sie müssen eine App registrieren, um die OAuthClientId Und OAuthClientSecret.

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für das Verfahren.

Benutzerdefinierte Anmeldeinformationen

Desktop-Authentifizierung mit Ihrer OAuth-App

Befolgen Sie die nachstehenden Schritte, um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-App zu authentifizieren. Siehe Erstellen einer benutzerdefinierten OAuth-App.

Holen Sie sich ein OAuth-Zugriffstoken

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

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
• APIIntegrationType: Stellen Sie dies entweder auf Web-App oder Server-zu-Server ein, je nachdem, was Sie beim Erstellen Ihrer App ausgewählt haben.
• OAuthGrantType: Alternativ können Sie anstelle von APIIntegrationType, Die OAuthGrantType kann direkt auf Code (Web-App) oder Client (Server-zu-Server) gesetzt werden. Es kann wünschenswert sein, zu verwenden OAuthGrantType in Fällen, in denen mehrere Produkte verwendet werden, um die Konsistenz zu wahren.
• CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Umleitungs URL fest.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken..
• AccountId: Legen Sie hier die spezifische MID der Zielgeschäftseinheit fest. Dies ist für Legacy-Pakete nicht verfügbar.

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 soll über mehrere Verbindungen hinweg bestehen bleiben.

Kopflose Maschinen

Verwenden von OAuth auf einer Headless-Maschine

Um Salesforce Marketing Cloud-Datenquellen auf Headless-Servern oder anderen Rechnern zu erstellen, auf denen der Connector keinen Browser öffnen kann, müssen Sie sich von einem anderen Rechner aus authentifizieren. Die Authentifizierung erfolgt in zwei Schritten.

1. Anstatt den Connector auf einem anderen Computer zu installieren, können Sie die folgenden Schritte ausführen, um den OAuthVerifier-Wert. Oder Sie können den Connector auf einem anderen Computer installieren und die OAuth-Authentifizierungswerte übertragen, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben.
2. Anschließend können Sie den Connector so konfigurieren, dass das Zugriffstoken vom Headless-Computer automatisch aktualisiert wird.

Verwenden der Anmeldeinformationen für eine benutzerdefinierte OAuth-App

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren. Sie können dann die folgenden Verfahren befolgen, um sich zu authentifizieren und eine Verbindung zu Daten herzustellen.

Besorgen Sie sich einen Prüfcode

Legen Sie die folgenden Eigenschaften auf der Headless-Maschine fest:

• InitiateOAuth: Stellen Sie dies auf AUS.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die App-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das App-Geheimnis fest.
• AccountId: Stellen Sie dies auf die spezifische MID der Zielgeschäftseinheit ein. Dies ist für Legacy-Pakete nicht verfügbar.

Sie können dann die folgenden Schritte ausführen, um sich von einem anderen Computer aus zu authentifizieren und die zu erhalten OAuthVerifier Verbindungseigenschaft.

1. Rufen Sie die GetOAuthAuthorizationURL auf gespeicherte Prozedur mit dem CallbackURL-Eingabeparameter, der auf die genaue Umleitungs-URI eingestellt ist, die Sie in Ihren App-Einstellungen angegeben haben.
2. Öffnen Sie die zurückgegebene URL in einem Browser. Melden Sie sich an und erteilen Sie dem Connector Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode enthält.
3. Speichern Sie den Wert des Prüfcodes. Sie setzen diesen in OAuthVerifier Verbindungseigenschaft.

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

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf den Consumer-Schlüssel fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Verbrauchergeheimnis fest.
• OAuthVerifier: Setzen Sie dies auf den Prüfcode.
• OAuthSettingsLocation: Legen Sie dies fest, um die verschlüsselten OAuth-Authentifizierungswerte in der angegebenen Datei zu speichern.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• AccountId: Stellen Sie dies auf die spezifische MID der Zielgeschäftseinheit ein. Dies ist für Legacy-Pakete nicht verfügbar.

Mit Daten verbinden

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung mit Daten herzustellen:

• OAuthSettingsLocation: Legen Sie dies auf die Datei fest, die die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass diese Datei dem Anbieter Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• AccountId: Stellen Sie dies auf die spezifische MID der Zielgeschäftseinheit ein. Dies ist für Legacy-Pakete nicht verfügbar.

OAuth-Einstellungen übertragen

Befolgen Sie die nachstehenden Schritte, um den Connector auf einem anderen Computer zu installieren, zu authentifizieren und dann die resultierenden OAuth-Werte zu übertragen.

Installieren Sie den Connector auf einem zweiten Computer und stellen Sie eine Verbindung mit den folgenden festgelegten Eigenschaften her:

• OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
• CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Rückruf URL fest.
• AccountId: Legen Sie hier die spezifische MID der Zielgeschäftseinheit fest. Dies ist für Legacy-Pakete nicht verfügbar.

Testen Sie die Verbindung zur Authentifizierung. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. 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, um eine Verbindung zu Daten herzustellen:

• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• OAuthSettingsLocation: Legen Sie hier den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• AccountId: Stellen Sie dies auf die spezifische MID der Zielgeschäftseinheit ein. Dies ist für Legacy-Pakete nicht verfügbar.

Erstellen einer benutzerdefinierten OAuth-App

Erstellen einer App

Mit dem nachstehenden Verfahren können Sie eine App registrieren und die OAuth-Clientanmeldeinformationen, die Client-ID und das Client-Geheimnis abrufen:

1. Melden Sie sich bei Ihrer Salesforce Marketing Cloud an. Gehen Sie zu Marketing Cloud | Verwaltung | Installierte Pakete.
2. Klicken Sie auf New.
3. Geben Sie dem Paket einen Namen und eine Beschreibung.
4. Speichern Sie das Paket. Sobald das Paket gespeichert ist, werden wichtige Details zum Paket angezeigt. Weitere Informationen zu den einzelnen Feldern finden Sie unter „Definitionen installierter Pakete“. Sie sehen die Paket-ID, das JWT-Signaturgeheimnis und das Quellkonto nur für Pakete, 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-App 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. Unter den Komponentendetails finden Sie die Client ID und Client Secret.

Auswählen aus Datenerweiterungen in Salesforce Marketing Cloud

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-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: Wenn Ihr Salesforce Marketing Cloud-Konto mehr als eine Business Unit enthält, muss die ClientID-Eingabe angegeben werden. Sie können Semikolons (;) verwenden, um mehr als eine ClientID anzugeben.

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.

Benutzerdefinierte Ansichten

Mit dem Salesforce Marketing Cloud-Connector 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"

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 Salesforce Marketing Cloud-Connector modelliert zwei Salesforce Marketing Cloud APIs als relationale Datenbanken, die REST- API und die SOAP API. Legen Sie die Schema-Eigenschaft und verwenden Sie die Informationen in jedem Abschnitt, um basierend auf den Anforderungen Ihres Projekts die richtige API auszuwählen.

Kollaborative Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisungen so weit wie möglich auf die Salesforce Marketing Cloud APIs und verarbeitet den Rest der Abfrage dann innerhalb des Connectors.

Sehen SupportEnhancedSQL für weitere Informationen dazu, wie der Connector API Einschränkungen durch die clientseitige In-Memory-Verarbeitung umgeht.

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 in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Salesforce Marketing Cloud-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Salesforce Marketing Cloud Connector-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

Aktualisierungsvorgänge werden für diese Tabelle nicht unterstützt.

Löschen

Kampagnen können gelöscht werden, indem die Kampagnen-ID 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

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 bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Oft ist eine gespeicherte Prozedur verfügbar, um die Daten zu aktualisieren, wenn eine solche Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich. Um mehr über Tabellen und gespeicherte Prozeduren zu erfahren, navigieren Sie bitte zu den entsprechenden Einträgen in diesem Hilfedokument.

Salesforce Marketing Cloud Connector-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

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

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Gespeicherte Prozeduren für den Salesforce Marketing Cloud Connector

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

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

NachrichtenlisteStatus abrufen

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

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Salesforce Marketing Cloud ab.

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

ImportierenUndSendenNachricht

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

WarteschlangeMoMessage

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 den OAuth-Zugriffstoken, der für die Authentifizierung bei Salesforce Marketing Cloud 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

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 in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Salesforce Marketing Cloud-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Salesforce Marketing Cloud Connector-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 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM Account

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 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM AccountUser

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 Passwort.

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 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM BusinessUnit

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

Inhaltsbereich

Ein ContentArea stellt einen definierten Abschnitt wiederverwendbaren Inhalts dar.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM ContentArea

SELECT * FROM ContentArea WHERE Id = 123

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

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

Einfügen

Beim Einfügen in diese Tabelle müssen Sie folgende Felder angeben: Name und Inhalt.

INSERT INTO ContentArea(Name, Content) VALUES('Testing', 'Hello world')

Aktualisieren

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

UPDATE ContentArea SET Name='Changed' 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 ContentArea WHERE ID = 123

Spalten

Datenerweiterung

Stellt eine Datenerweiterung innerhalb eines Kontos dar.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM DataExtension

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

Einfügen

Beim Einfügen in diese Tabelle müssen Sie die folgenden Felder angeben: Name, Kundenschlüssel und Felder.

Hinweis: Die Salesforce Marketing Cloud APIs haben Probleme mit DataExtensions bei Namen mit mehr als 40 Zeichen. Versuchen Sie, den Namen auf einen relativ kurzen Wert zu beschränken.

INSERT INTO DataExtension (Name, CustomerKey,  Fields) VALUES('TestName', 'TestCustomerKey', 'fieldname1;fieldname2;fieldname3')

Aktualisieren

Sie müssen die ObjectId oder den CustomerKey oder den Namen in der WHERE-Klausel angeben, wenn Sie ein Update für diese Tabelle ausführen.

UPDATE DataExtension SET ResetRetentionPeriodOnImport=true WHERE ObjectId='nzxcaslkjd-123'

Löschen

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

DELETE FROM DataExtension WHERE ObjectId = 'nzxcaslkjd-123'

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.

Email

Stellt eine Email in einem Marketing Cloud-Konto dar.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM Email

SELECT * FROM Email WHERE Id = 123

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

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

Einfügen

Beim Einfügen in diese Tabelle müssen Sie folgende Felder angeben: Name und Betreff.

INSERT INTO Email(Name, Subject) VALUES('Testing', 'Greetings')

Aktualisieren

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

UPDATE Email SET Name='Changed' WHERE Id=31558

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 Email WHERE ID = 123

Spalten

E-MailSendenDefinition

Datensatz, der die Nachrichteninformationen, das Absenderprofil, das Zustellprofil und die Zielgruppeninformationen enthält.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Marketing Cloud APIs, um die folgenden WHERE-Klauseloperatoren für alle 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. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie festlegen SupportEnhancedSQL auf „false“. In diesem Fall verursachen alle Suchkriterien, die sich auf andere Spalten beziehen, einen Fehler.

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

SELECT * FROM EmailSendDefinition

SELECT * FROM EmailSendDefinition WHERE ObjectID = 123

SELECT * FROM EmailSendDefinition WHERE ObjectID IN (123, 456)

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

Einfügen

Beim Einfügen in diese Tabelle müssen Sie die folgenden Felder angeben: Name, SendClassification_CustomerKey und Email_Id.

INSERT INTO EmailSendDefinition(Name, SendClassification_CustomerKey, Email_Id) VALUES('Testing', 13507, 31677)

Aktualisieren

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

UPDATE EmailSendDefinition SET Description='Changed' WHERE ObjectId='acasascas'

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 EmailSendDefinition WHERE ObjectId = 'sdfsdf123'

Spalten