Mailchimp-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8895 des Connectors.

Erste Schritte

Mailchimp-Versionsunterstützung

Der Connector verwendet standardmäßig Version 3 der Core Mailchimp API.

Herstellen einer Verbindung

Mit Mailchimp verbinden

Mailchimp unterstützt die folgenden Authentifizierungsmethoden:

• APIKey
• OAuth

API Schlüssel

Der einfachste Weg, eine Verbindung zu Mailchimp herzustellen, ist die Verwendung des API Schlüssels. Der APIKey gewährt vollen Zugriff auf Ihr Mailchimp-Konto. So erhalten Sie den API-Schlüssel:

1. Melden Sie sich bei Mailchimp an.
2. Navigieren Sie zu Account > Extras > API Keys.
3. Notieren Sie den Wert des API -Schlüssels.

Sobald Sie den Wert des API -Schlüssels haben:

1. Satz APIKey zum Wert des API Schlüssels.
2. Setzen Sie AuthScheme auf APIKey.

OAuth

Desktop-Anwendungen

Um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-Anwendung zu authentifizieren, müssen Sie das OAuth-Zugriffstoken abrufen und aktualisieren. Danach können Sie eine Verbindung herstellen.

OAuth-Zugriffstoken abrufen und aktualisieren:

• InitiateOAuth = GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• OAuthClientId = die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret = das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• CallbackURL = die Umleitungs-URI, die bei der Registrierung Ihrer Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Mailchimp in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen.

Nachdem Sie der Anwendung Berechtigungen erteilt haben, schließt der Connector den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von Mailchimp und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector das Zugriffstoken automatisch.

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

Für die Verbindung mit Mailchimp stehen zwei Authentifizierungsmethoden zur Verfügung: Sie können verwenden APIKey oder verwenden Sie OAuth.

OAuth kann verwendet werden, um anderen Benutzern den Zugriff auf ihre eigenen Daten zu ermöglichen. Es ist auch nützlich, wenn Sie Folgendes möchten:

• das Branding des Authentifizierungsdialogs steuern;
• die Umleitungs-URI steuern möchten, zu der die Anwendung den Benutzer nach der Authentifizierung umleitet; oder
• die Berechtigungen anpassen möchten, die Sie vom Benutzer anfordern.

Um eine benutzerdefinierte OAuth-Anwendung in Mailchimp zu registrieren und die OAuth-Client-Anmeldeinformationen zu erhalten, OAuthClientId Und OAuthClientSecret:

1. Melden Sie sich bei Ihrem Mailchimp-Konto an.

2. Navigieren Sie zu Account > Extras > API Keys > Register and Manage Your Apps.

3. Geben Sie die Informationen ein, die Benutzern angezeigt werden sollen, wenn sie aufgefordert werden, Berechtigungen für Ihre Anwendung zu erteilen. Zu diesen Informationen gehören Ihr App-Name, Ihr Unternehmen und Ihre Website.

4. Wenn es sich um eine Desktop-Anwendung handelt, geben Sie eine Umleitungs-URI von an http://127.0.0.1.

   Wenn es sich um eine Webanwendung handelt, geben Sie eine Umleitungs-URI an, zu der Benutzer umgeleitet werden sollen, nachdem sie Ihrer Anwendung Berechtigungen erteilt haben.

Nachdem Sie eine benutzerdefinierte OAuth-App erstellt und registriert haben, können Benutzer eine Verbindung zu Mailchimp herstellen, wie unter „Herstellen einer Verbindung zu Mailchimp“ beschrieben.

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 Mailchimp-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 Mailchimp und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Mailchimp-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 Lists WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. 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 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

Das Datenmodell besteht aus drei Teilen: Tabellen, Ansichten und gespeicherte Prozeduren. 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

Der Mailchimp-Konnektor modelliert die Mailchimp-API in Tabellen, damit es einfach abgefragt und aktualisiert werden kann.

Der Connector ruft beim Herstellen einer Verbindung dynamisch benutzerdefinierte Felder für die ListMembers-Tabellen ab. Alle Änderungen, die Sie an diesen benutzerdefinierten Feldern vornehmen, z. B. das Hinzufügen eines neuen Felds oder das Ändern des Datentyps eines benutzerdefinierten Felds, werden beim erneuten Herstellen der Verbindung übernommen.

Dynamische Tabellen

Neben den standardmäßigen statischen Tabellen ermöglicht der Connector auch die Abfrage dynamischer Tabellen. Dies sind Tabellen, die basierend auf den „Zielgruppen“ (auch „Listen“ genannt) in Ihrem Mailchimp-Konto erstellt werden.
Angenommen, Sie haben diese 3 Zielgruppen in Ihrem Konto: Alte Zielgruppe, Neue Zielgruppe, VIP-Zielgruppe. Für jede dieser Zielgruppen erstellt der Connector 2 neue Tabellen: Eine beginnt mit „ListMembers_“ und die andere mit „ListMergeFields_“. Für den vorliegenden Fall werden also diese 6 Tabellen erstellt:

• ListMembers_OldAudience
• ListMembers_NewAudience
• ListMembers_VIPAudience
• ListMergeFields_OldAudience
• ListMergeFields_NewAudience
• ListMergeFields_VIPAudience

Die obigen 6 Tabellen werden erstellt, indem Leerzeichen aus dem Namen des Publikums entfernt und das Ergebnis mit einem Unterstrich an „ListMembers“ oder „ListMergeFields“ angehängt wird.

Tabellen, die mit beginnen "ListMembers_" alle Mitglieder für eine bestimmte Zielgruppe zusammen mit den Werten benutzerdefinierter Felder anzeigen.
Die mit beginnenden "ListMergeFields_" alle Namen benutzerdefinierter Felder für Mitglieder dieser Zielgruppe anzeigen.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden Daten, die schreibgeschützt sind und nicht aktualisiert werden können, als Ansichten angezeigt.

Dynamische Ansichten

Neben den standardmäßigen statischen Ansichten ermöglicht der Connector auch die Abfrage dynamischer Ansichten. Dabei handelt es sich um Ansichten, die auf Grundlage der „Zielgruppen“ (auch „Listen“ genannt) in Ihrem Mailchimp-Konto erstellt werden.
Angenommen, Sie haben diese 3 Zielgruppen in Ihrem Konto: Alte Zielgruppe, Neue Zielgruppe, VIP-Zielgruppe. Der Connector listet 3 Ansichten auf, die auf diesen basieren: ListMemberTags_OldAudience, ListMemberTags_NewAudience, ListMemberTags_VIPAudience.
Die obigen 3 Ansichten werden erstellt, indem Leerzeichen aus dem Namen der Zielgruppe entfernt und das Ergebnis mit einem Unterstrich an „ListMemberTags“ angehängt wird. Sie geben die Tags zurück, die jedem Mitglied der von Ihnen angegebenen Zielgruppe zugewiesen sind.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie können zum Suchen, Aktualisieren und Ändern von Informationen

in der Datenquelle verwendet werden.

Tabellen

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

Mailchimp-Connector-Tabellen

AutomatisierungE-Mail-Warteschlangen

Eine Zusammenfassung der Warteschlange für eine Email in einem Automatisierungs Workflow.

Tabellenspezifische Informationen

SELECT und INSERT werden für AutomationEmailQueues unterstützt.

Wählen

Select * from AutomationEmailQueues

Einfügen

Für INSERTs sind die WorkflowId, EmailId und EmailAddress erforderlich.

INSERT INTO AutomationEmailQueues (WorkflowId, EmailId, EmailAddress) VALUES ('myWorkflowId', 'myEmailId', 'myEmailAddress')

Spalten

AutomatisierungenEntfernte Abonnenten

Eine Zusammenfassung der Abonnenten, die aus einem Automatisierungs-Workflow entfernt wurden.

Tabellenspezifische Informationen

SELECT und INSERT werden für AutomationsRemovedSubscribers unterstützt.

Wählen

Select * from AutomationsRemovedSubscribers

Einfügen

Für INSERTs sind die Workflow-ID und die E-Mail-Adresse erforderlich.

Insert Into AutomationsRemovedSubscribers (WorkflowId, EmailAddress) Values('3456df3456','test1@mail.com');

Spalten

Kampagnenfeedback

Eine Zusammenfassung des Kommentarfeedbacks für eine bestimmte Kampagne.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELTE werden für CampaignFeedback unterstützt.

Wählen

Select * from CampaignFeedback

Einfügen

Für INSERTs sind die CampaignId und die Message erforderlich.

INSERT INTO CampaignFeedback (CampaignId, Message) VALUES ('myCampaignId', 'myMessage')

Spalten

Kampagnenordner

Ordner zum Organisieren von Kampagnen

Spalten

Kampagnen

Eine Zusammenfassung der Kampagnen innerhalb eines Kontos.

Tabellenspezifische Informationen

SELECT, UPDATE und DELETE werden für Kampagnen unterstützt.

Aktualisieren

UPDATE Campaigns SET Settings_Title = "Test" WHERE Id = "1234"

UPDATE Campaigns SET Recipients_SegmentOpts = "{"match":"any","saved_segment_id":314699}" WHERE Id = "cfb12c2228"


UPDATE Campaigns SET Settings_Title = "Test", Recipients_ListId = "1234", RssOpts_FeedUrl = "exampleUrl", Type = "rss", RssOpts_Frequency = "daily" WHERE ID = "1234"

Hinweis: Der UPDATE- Operation kann nicht für bereits GESENDETE Kampagnen ausgeführt werden. Außerdem kann der Typ einer Kampagne nicht mehr aktualisiert werden, sobald er einmal festgelegt wurde. Abhängig vom Kampagnentyp können bestimmte Optionen nur für bestimmte Kampagnentypen aktualisiert werden. Beispiel: Wenn eine Kampagne vom Typ „RSS“ ist, können nur die RSS-Optionsfelder für diese Kampagne aktualisiert werden. Variant- und AbSplitOps-Einstellungen können in diesem Fall nicht aktualisiert werden.

Spalten

E-CommerceCartLines

Eine Liste der Zeilen eines E-Commerce-Warenkorbs.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• CartId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceCartLines WHERE StoreId = 'Test_Store123' and CartId = '44'

SELECT * FROM EcommerceCartLines WHERE StoreId = 'Test_Store123' and CartId = '44' and ID = '88'

Löschen

Hinweis: Die API gibt einen Fehler aus, wenn der Warenkorb nur eine Position enthält. Sie müssen den Warenkorb löschen, um alle Positionen zu löschen.

DELETE FROM EcommerceCartLines WHERE StoreId = 'Test_Store123' and CartId = '44' and ID = '88'

Spalten

E-CommerceCarts

Eine Liste der E-Commerce-Warenkörbe eines Kontos.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceCarts WHERE StoreId = 'Test_Store123'

SELECT * FROM EcommerceCarts WHERE StoreId = 'Test_Store123' and Id = '44'

Spalten

E-CommerceKunden

Eine Liste der E-Commerce-Kunden eines Kontos.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceCustomers WHERE StoreId = 'Test_Store123'

SELECT * FROM EcommerceCustomers WHERE StoreId = 'Test_Store123' and ID = '44'

Spalten

E-CommerceBestellzeilen

Eine Liste der Zeilen einer E-Commerce-Bestellung.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• OrderId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceOrderLines WHERE StoreId = 'Test_Store123' and OrderId = '44'

SELECT * FROM EcommerceOrderLines WHERE StoreId = 'Test_Store123' and OrderId = '44' and ID = '88'

Löschen

Hinweis: Die API gibt einen Fehler aus, wenn die Bestellung nur eine Position enthält. Sie müssen die Bestellung löschen, um alle Positionen zu löschen.

DELETE FROM EcommerceOrderLines WHERE StoreId = 'Test_Store123' and OrderId = '44' and ID = '88'

Spalten

E-CommerceBestellungen

Eine Liste der E-Commerce-Bestellungen eines Kontos.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceOrders WHERE StoreId = 'Test_Store123'

SELECT * FROM EcommerceOrders WHERE StoreId = 'Test_Store123' and ID = '44'

Spalten

E-CommerceProdukte

Eine Liste der E-Commerce-Produkte eines Kontos.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceProducts WHERE StoreId = 'Test_Store123'

SELECT * FROM EcommerceProducts WHERE StoreId = 'Test_Store123' and ID = '44'

Spalten

E-CommerceProduktvarianten

Eine Liste der Varianten eines E-Commerce-Produkts.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Mailchimp API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Die StoreId kann durch Auswahl der ECommerceStores-Ansicht abgerufen werden.

• StoreId unterstützt die = Betreiber.
• ProductId unterstützt die = Betreiber.
• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceProductVariants WHERE StoreId = 'Test_Store123' and ProductId = '44'

SELECT * FROM EcommerceProductVariants WHERE StoreId = 'Test_Store123' and ProductId = '44' and ID = '88'

Löschen

Hinweis: Die API gibt einen Fehler aus, wenn das Produkt nur eine Variante enthält. Sie müssen das Produkt löschen, um alle Varianten zu löschen.

DELETE FROM EcommerceProductVariants WHERE StoreId = 'Test_Store123' and ProductId = '44' and ID = '88'

Spalten

DateiManagerDateien

Eine Auflistung aller verfügbaren Bilder und Dateien in der Galerie eines Kontos.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für FileManagerFiles unterstützt.

Wählen

SELECT * FROM FileManagerFiles

Einfügen

Für INSERTs sind Name, Ordner-ID und Dateidaten erforderlich.

INSERT INTO FileManagerFiles (Name, FolderID, FileData) VALUES ('myNewFolder', 'myFolderID', 'myBase64EncodedFileData')

Spalten

DateiManagerOrdner

Eine Auflistung aller verfügbaren Ordner in der Galerie eines Kontos.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für FileManagerFolders unterstützt.

Einfügen

Der Name ist für INSERTs erforderlich.

INSERT INTO FileManagerFolders (Name) VALUES ('myNewFolder'')

Spalten

ListeInteresseKategorien

Eine Auflistung der Interessenkategorien dieser Liste.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListInterestCategories unterstützt.

Wählen

Select * from ListInterestCategories

Select * from ListInterestCategories where ListId='abc'

Einfügen

Titel, Typ und ListId sind für INSERTs erforderlich.

INSERT INTO ListInterestCategories (Name, Type, ListID) VALUES ('myNewListInterestCategory', 'myType', 'myListID')

Spalten

Interessen auflisten

Eine Liste der Interessen dieser Kategorie

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListInterests unterstützt.

Wählen

Select * from ListInterests

Select * from ListInterests where ListId='abc'

Einfügen

Titel, Kategorie-ID und Listen-ID sind für INSERTs erforderlich.

INSERT INTO ListInterests (Name, CategoryId, ListID) VALUES ('myNewListInterest', 'myCategory', 'myListID')

Spalten

Mitgliederereignisse auflisten

Veranstaltungsinformationen für eine bestimmte Liste.

Tabellenspezifische Informationen

SELECT und INSERT werden für ListMemberEvents unterstützt.

Wählen

Select * from ListMemberEvents

Einfügen

Beim Einfügen ist die Spalte „Name“ erforderlich.

Spalten

ListeMitgliedNotizen

Die letzten 10 Notizen für ein bestimmtes Listenmitglied, basierend auf dem Erstellungsdatum.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListMemberNotes unterstützt.

Wählen

Select * from ListMemberNotes

Einfügen

Beim Einfügen sind keine Felder erforderlich.

Spalten

Mitgliederliste

Einzelpersonen, die derzeit oder früher auf dieser Liste eingetragen waren, einschließlich Mitglieder, die abgesprungen sind oder sich abgemeldet haben.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListMembers unterstützt.

Wählen

Select * from ListMembers

Einfügen

Für INSERTs sind die Listen-ID, die E-Mail-Adresse und der Status erforderlich.

INSERT INTO ListMembers (ListId, EmailAddress, Status) VALUES ('myListId', 'myEmailAddress', 'subscribed')

Spalten

ListeMitgliedTags

Tags, die einem bestimmten Mitglied/bestimmten Mitgliedern zugewiesen sind.

Tabellenspezifische Informationen

SELECT und INSERT werden für ListMemberTags unterstützt.

Wählen

Select * from ListMemberTags

Einfügen

Beim Einfügen sind Name, ListId und MemberId erforderlich.

INSERT INTO ListMemberTags (Name, ListId, MemberId) VALUES ('test', '434gfsd4', 'esdfsd4563vfghxgsf45645sdfgdfg')

Spalten

ListMergeFields

Das Seriendruckfeld (früher Seriendruckvariablen) für eine bestimmte Liste. Diese entsprechen den Seriendruckfeldern in den Listen und Abonnentenprofilen von MailChimp.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListMergeFields unterstützt.

Wählen

Select * from ListMergeFields

Select * from ListMergeFields where ListId='abc'

Einfügen

Der Name und die ListID sind für INSERTs erforderlich.

INSERT INTO ListMergeFields (Name, ListID) VALUES ('myNewListMergeField', 'myListID')

Spalten

Listen

Eine Sammlung von Abonnentenlisten, die mit diesem Konto verknüpft sind. Die Listen enthalten Abonnenten, die sich für den Erhalt von Korrespondenz von Ihnen oder Ihrer Organisation entschieden haben.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für Listen unterstützt.

Einfügen

Für INSERTs sind Name, PermissionReminder, EmailTypeOption, Contact_Company, Contact_Address1, Contact_City, Contact_State, Contact_Zip, Contact_Country, CampaignDefaults_FromName, CampaignDefaults_FromEmail, CampaignDefaults_Subject und CampaignDefaults_Language erforderlich.

INSERT INTO Lists (Name, PermissionReminder, EmailTypeOption, Contact_Company, Contact_Address1, Contact_City, Contact_State, Contact_Zip, Contact_Country, CampaignDefaults_FromName, CampaignDefaults_FromEmail, CampaignDefaults_Subject, CampaignDefaults_Language) VALUES ('myName', 'myPermissionReminder', 'true', 'myCompany', 'myAddress', 'myCity', 'myState', 'myZip', 'myCountry', 'myFromName', 'myFromEmail', 'myDefaultSubject', 'myDefaultLanguage')

Spalten

Listensegmentmitglieder

Einzelpersonen, die derzeit oder früher auf dieser Liste eingetragen waren, einschließlich Mitglieder, die abgesprungen sind oder sich abgemeldet haben.

Tabellenspezifische Informationen

SELECT, INSERT und DELETE werden für ListSegmentMembers unterstützt.

Wählen

Select * from ListSegmentMembers
Select * from ListSegmentMembers where ListId = '5152'

Select * from ListSegmentMembers where SegmentId = '2623'

Einfügen

Der Name und die Listen-ID sind für INSERTs erforderlich.

INSERT into ListSegmentMembers (EmailAddress,ListId,SegmentId) values ('abc@gmail.com','44a64c46cb','7032720')

Spalten

Listensegmente

Eine Liste der verfügbaren Segmente.

Tabellenspezifische Informationen

SELECT, INSERT, UPDATE und DELETE werden für ListSegments unterstützt.

Wählen

Select * from ListSegments

Select * from ListSegments where ListId = '5152'

Einfügen

Der Name und die Listen-ID sind für INSERTs erforderlich.

INSERT INTO ListSegments (Name, ListID) VALUES ('myNewListSegment', 'myListID')

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.

ListenWebhooks

Für die angegebene Liste konfigurierte Webhooks.

Spalten

Vorlagenordner

Ordner zum Organisieren von Vorlagen

Spalten

Vorlagen

Eine Liste der für ein Konto verfügbaren Vorlagen.

Tabellenspezifische Informationen

SELECT und DELETE werden für Vorlagen unterstützt.

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.

Mailchimp-Connector-Ansichten

AutorisierteApps

Eine Liste der Anwendungen, die zum Zugriff auf das Konto berechtigt sind.

Tabellenspezifische Informationen

SELECT wird für AuthorizedApps unterstützt.

Spalten

AutomatisierungE-Mails

Eine Zusammenfassung der Emails in einem Automatisierungs-Workflow.

Tabellenspezifische Informationen

SELECT wird für AutomationEmails unterstützt.

Wählen

Select * from AutomationEmails

Spalten

Automatisierungen

Eine Zusammenfassung der Automatisierungen innerhalb eines Kontos.

Spalten

KampagneÖffnenE-MailDetails

Eine Liste der Mitglieder, die die Kampagnen-Email geöffnet haben.

Tabellenspezifische Informationen

SELECT wird für CampaignOpenEmailDetails unterstützt.

Wählen

Zum Beispiel:

SELECT * FROM CampaignOpenEmailDetails
SELECT * FROM CampaignOpenEmailDetails WHERE CampaignId = '9f218dcf18'

Spalten

Konversationsnachrichten

Nachrichten aus einer bestimmten Konversation. Konversationsverfolgung ist eine Funktion, die kostenpflichtigen Konten zur Verfügung steht und mit der Sie Antworten auf Ihre Kampagnen innerhalb Ihres MailChimp Kontos anzeigen können.

Tabellenspezifische Informationen

SELECT wird für ConversationMessages unterstützt.

Wählen

SELECT * from ConversationMessages

Spalten

Gespräche

Eine Sammlung der verfolgten Konversationen dieses Kontos. Die Konversationsverfolgung ist eine Funktion, die kostenpflichtigen Konten zur Verfügung steht und mit der Sie Antworten auf Ihre Kampagnen innerhalb Ihres MailChimp Kontos anzeigen können.

Spalten

E-CommerceGeschäfte

Eine Liste der E-Commerce-Shops eines Kontos.

Tabellenspezifische Informationen

Wählen

• Id unterstützt die = Operator.

Beispiel:

SELECT * FROM EcommerceStores WHERE  ID = '44'

Spalten

Missbrauchsliste

Eine Sammlung von Missbrauchsbeschwerden für eine bestimmte Liste. Eine Missbrauchsbeschwerde tritt auf, wenn Ihr Empfänger in seinem Email-Programm auf „Spam melden“ klickt.

Tabellenspezifische Informationen

SELECT wird für ListAbuse unterstützt.

Wählen

Select * from ListAbuse

Select * from ListAbuse where ListId='abc'

Spalten

Listenaktivität

Bis zu den letzten 180 Tagen täglicher detaillierter aggregierter Aktivitätsstatistiken für eine bestimmte Liste. Enthält keine AutoResponder- oder Automatisierungsaktivität.

Tabellenspezifische Informationen

SELECT wird für ListActivity unterstützt.

Wählen

Select * from ListActivity

Select * from ListActivity where ListId='abc'

Spalten

Kundenliste

Am häufigsten verwendete Email Clients, gemessen an ihrem User-Agent-String

Spalten

ListeWachstumGeschichte

Eine Monatsübersicht der Wachstumsaktivität einer bestimmten Liste.

Tabellenspezifische Informationen

SELECT wird für ListGrowthHistory unterstützt.

Wählen

Select * from ListGrowthHistory

Select * from ListGrowthHistory where ListId='abc'

Spalten

Mitgliederaktivität auflisten

Die letzten 50 Mitgliederereignisse für eine Liste.

Tabellenspezifische Informationen

SELECT wird für ListMemberActivity unterstützt.

Wählen

Select * from ListMemberActivity

Spalten

ListeAnmeldeformulare

Sammlung von Listenanmeldeformularen

Spalten

Missbrauch melden

Eine Liste mit Missbrauchsbeschwerden für eine bestimmte Liste.

Tabellenspezifische Informationen

SELECT wird für ReportAbuse unterstützt.

Wählen

Select * from ReportAbuse

Select * from ReportAdvice where CampaignId='abc'

Spalten

BerichtBeratung

Eine Liste mit Feedback basierend auf den Statistiken einer Kampagne.

Tabellenspezifische Informationen

SELECT wird für ReportAdvice unterstützt.

Wählen

Select * from ReportAdvice

Select * from ReportAdvice where CampaignId='abc'

Spalten

BerichtKlickDetails

Eine Liste von URLs und eindeutigen IDs, die in HTML- und Nur-Text-Versionen einer Kampagne enthalten sind.

Tabellenspezifische Informationen

SELECT wird für ReportClickDetails unterstützt.

Wählen

Select * from ReportClickDetails

Select * from ReportClickDetails where CampaignId='abc'

Spalten

ReportClickDetailsMitglieder

Eine Sammlung von Mitgliedern, die innerhalb einer Kampagne auf einen bestimmten Link geklickt haben.

Tabellenspezifische Informationen

SELECT wird für ReportClickDetailsMembers unterstützt.

Wählen

Select * from ReportClickDetailsMembers

Spalten

BerichtDomänenLeistung

Statistiken für die Email Domänen mit der besten Leistung in einer Kampagne.

Tabellenspezifische Informationen

SELECT wird für ReportDomainPerformance unterstützt.

Wählen

Select * from ReportDomainPerformance

Select * from ReportDomainPerformance where CampaignId='abc'

Spalten

E-Mail-Aktivität melden

Eine Liste der Abonnentenaktivitäten eines Mitglieds in einer bestimmten Kampagne.

Tabellenspezifische Informationen

SELECT wird für ReportEmailActivity unterstützt.

Wählen

Select * from ReportEmailActivity

Spalten

BerichtStandorte

Top offene Standorte für eine bestimmte Kampagne.

Spalten

Berichte

Eine Liste von Berichten, die als „Gesendet“ markierte Kampagnen enthalten.

Spalten

BerichtGesendetAn

Eine Liste der Abonnenten, denen eine bestimmte Kampagne gesendet wurde.

Tabellenspezifische Informationen

SELECT wird für ReportSentTo unterstützt.

Wählen

Zum Abrufen von Daten aus dieser Tabelle ist eine Kampagnen-ID erforderlich. Wenn in der WHERE-Klausel keine angegeben ist, wird die erste für Ihr Konto verfügbare verwendet.

Spalten

MeldenAbmeldungen

Eine Liste der Mitglieder, die sich von einer bestimmten Kampagne abgemeldet haben.

Tabellenspezifische Informationen

SELECT wird für ReportUnsubscribes unterstützt.

Wählen

Select * from ReportUnsubscribes

Spalten

Umfrageantworten

Liste der Umfrageantworten.

Tabellenspezifische Informationen

SELECT wird für SurveyResponses unterstützt.

Wählen

Select * from SurveyResponses

Spalten

Umfragen

Erhalten Sie Berichte für Umfragen.

Tabellenspezifische Informationen

SELECT wird für Umfragen unterstützt.

Spalten

Gespeicherte Prozeduren

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

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

Gespeicherte Prozeduren für den Mailchimp-Connector

KampagneAbbrechen

Bricht eine reguläre oder reine Textkampagne von MailChimp ab.

Eingang

Ergebnissatzspalten

Kampagnenpause

Pausiert eine MailChimp RSS Kampagne.

Eingang

Ergebnissatzspalten

KampagneLebenslauf

Setzt eine MailChimp RSS Kampagne fort.

Eingang

Ergebnissatzspalten

Kampagnenplan

Plant eine MailChimp-Kampagne. Es können entweder Timewarp oder die Charge Eigenschaften verwendet werden, nicht beides.

Eingang

Ergebnissatzspalten

KampagneSenden

Sendet eine MailChimp Kampagne.

Eingang

Ergebnissatzspalten

Kampagnentest

Sendet eine Test-Email für eine MailChimp Kampagne.

Eingang

Ergebnissatzspalten

KampagnePlanen aufheben

Hebt die Planung einer MailChimp-Kampagne auf.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft den OAuth-Zugriffstoken ab, der für die Authentifizierung bei MailChimp verwendet werden soll.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die OAuth-Autorisierungs URL ab, die für die Authentifizierung bei MailChimp verwendet wird.

Eingang

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Mailchimp zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemas ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Lists-Tabelle zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Lists'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur GetOAuthAccessToken zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='GetOAuthAccessToken' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Lists-Tabelle ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Lists'

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten