Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Herstellen einer Verbindung mit Adobe Marketo Engage Adobe Marketo Engage ist eine Marketing-Automatisierungsplattform, mit der Marketingfachleute personalisierte Multi-Channel-Programme und -Kampagnen für Interessenten und Kunden verwalten können. **Topics** + [AWS Glue Unterstützung für Adobe Marketo Engage](adobe-marketo-engage-support.md) + [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](adobe-marketo-engage-configuring-iam-permissions.md) + [Konfiguration von Adobe Marketo Engage](adobe-marketo-engage-configuring.md) + [Konfiguration von Verbindungen mit Adobe Marketo Engage](adobe-marketo-engage-configuring-connections.md) + [Lesen aus Adobe-Marketo-Engage-Entitäten](adobe-marketo-engage-reading-from-entities.md) + [Schreiben in Entitäten von Adobe Marketo Engage](adobe-marketo-engage-writing-to-entities.md) + [Verbindungsoptionen für Adobe Marketo Engage](adobe-marketo-engage-connection-options.md) + [Einschränkungen und Hinweise für den Adobe-Marketo-Engage-Connector](adobe-marketo-engage-connector-limitations.md) # AWS Glue Unterstützung für Adobe Marketo Engage AWS Glue unterstützt Adobe Marketo Engage wie folgt: **Als Quelle unterstützt?** Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Adobe Marketo Engage abzufragen. **Als Ziel unterstützt?** Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten in Adobe Marketo zu schreiben. **Unterstützte API-Versionen von Adobe Marketo Engage** Die folgenden API-Versionen von Adobe Marketo Engage werden unterstützt: + v1 Informationen zur Unterstützung von Entitäten pro Version finden Sie unter „Unterstützte Entitäten für Quelle“. # Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien: + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen. # Konfiguration von Adobe Marketo Engage Bevor Sie Daten von Adobe Market AWS Glue nach Engage übertragen können, müssen Sie die folgenden Anforderungen erfüllen: ## Mindestanforderungen Die folgenden Anforderungen sind Mindestanforderungen: + Sie haben ein Konto bei Adobe Marketo Engage mit Kundenanmeldeinformationen. + Ihr Konto bei Adobe Marketo Engage verfügt über API-Zugriff mit einer gültigen Lizenz. Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung zu Ihrem Adobe AWS Glue Marketo Engage-Konto herstellen. Für typische Verbindungen müssen Sie in Adobe Marketo Engage nichts weiter tun. ## Anmeldedaten für Version 2.0 erhalten OAuth Informationen zum Abrufen von API-Anmeldeinformationen für authentifizierte Aufrufe Ihrer Instance finden Sie unter [Adobe Marketo Rest-API](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api). # Konfiguration von Verbindungen mit Adobe Marketo Engage Adobe Marketo Engage unterstützt den Zuschusstyp CLIENT CREDENTIALS für. OAuth2 + Dieser Zuschusstyp wird als 2-Legged OAuth 2.0 betrachtet, da er von Kunden verwendet wird, um außerhalb des Benutzerkontextes ein Zugriffstoken zu erhalten. AWS Glue ist in der Lage, die Client-ID und das Client-Geheimnis zur Authentifizierung von Adobe Marketo Engage zu verwenden, die von benutzerdefinierten Diensten bereitgestellt werden APIs , die Sie definieren. + Jeder benutzerdefinierte Service gehört einem Nur-API-Benutzer, der über eine Reihe von Rollen und Berechtigungen verfügt, die den Service zur Ausführung bestimmter Aktionen autorisieren. Ein Zugriffstoken ist einem einzelnen benutzerdefinierten Service zugeordnet. + Dieser Gewährungstyp führt zu einem Zugriffstoken, das nur von kurzer Dauer ist und durch Aufrufen eines Identitätsendpunkts erneuert werden kann. + Öffentliche Adobe Marketo Engage-Dokumentation für OAuth 2.0 mit Kundenanmeldedaten finden Sie unter [Authentifizierung](https://developers.adobe-marketo-engage.com/rest-api/authentication/) im Adobe Marketo Engage Developer Guide. Konfigurieren einer Verbindung mit Adobe Marketo Engage: 1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details: 1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten. 1. Hinweis: Sie müssen für jede Verbindung in AWS Glue ein Geheimnis erstellen. 1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen: 1. Wählen Sie bei der Auswahl eines **Verbindungstyps** die Option Adobe Marketo Engage aus. 1. Geben Sie die `INSTANCE_URL` der Instance von Adobe Marketo Engage an, mit der Sie eine Verbindung herstellen möchten. 1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten. 1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten. 1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte. # Lesen aus Adobe-Marketo-Engage-Entitäten **Voraussetzung** Ein Adobe-Marketo-Engage-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen, z. B. „leads“ oder „activities“ oder „customobjects“. Die folgenden Tabellen zeigen die unterstützten Entitäten. **Unterstützte Entitäten für die Quelle (synchron)**: | Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | | --- | --- | --- | --- | --- | --- | | leads | Ja | Ja | Nein | Ja | Nein | | activities | Ja | Ja | Nein | Ja | Nein | | customobjects | Ja | Ja | Nein | Ja | Nein | **Unterstützte Entitäten für die Quelle (asynchron)**: | Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | | --- | --- | --- | --- | --- | --- | | leads | Ja | Nein | Nein | Ja | Ja | | activities | Ja | Nein | Nein | Ja | Nein | | customobjects | Ja | Nein | Nein | Ja | Ja | **Beispiel:** ``` adobe-marketo-engage_read = glueContext.create_dynamic_frame.from_options( connection_type="adobe-marketo-engage", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "leads", "API_VERSION": "v2", "INSTANCE_URL": "https://539-t**-6**.mktorest.com" } ``` **Entitäts- und Felddetails von Adobe Marketo Engage**: **Entitäten mit statischen Metadaten**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html) **Entitäten mit dynamischen Metadaten**: Für folgende Entitäten bietet Adobe Marketo Engage Endpunkte zum dynamischen Abrufen von Metadaten, sodass die Operatorunterstützung für jede Entität auf Datentypebene erfasst wird. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html) ## Partitionierung von Abfragen Sie können die zusätzlichen Spark-Optionen `PARTITION_FIELD`,`LOWER_BOUND`, `UPPER_BOUND` und `NUM_PARTITIONS` angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird die ursprüngliche Abfrage in `NUM_PARTITIONS` Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können. + `PARTITION_FIELD`: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll. + `LOWER_BOUND`: ein **inklusiver** Untergrenzwert des ausgewählten Partitionsfelds. Für das DateTime Feld akzeptieren wir den Wert im ISO-Format. Beispiel für gültigen Wert: ``` "2024-07-01T00:00:00.000Z" ``` + `UPPER_BOUND`: ein **exklusiver** Obergrenzwert des ausgewählten Partitionsfelds. + `NUM_PARTITIONS`: die Anzahl der Partitionen. In der folgenden Tabelle sind Details zur Unterstützung der Partitionierung von Entitäten beschrieben: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html) Beispiel: ``` adobe-marketo-engage_read = glueContext.create_dynamic_frame.from_options( connection_type="adobe-marketo-engage", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "leads", "API_VERSION": "v1", "PARTITION_FIELD": "createdAt" "LOWER_BOUND": "2024-07-01T00:00:00.000Z" "UPPER_BOUND": "2024-07-02T00:00:00.000Z" "NUM_PARTITIONS": "10" } ``` # Schreiben in Entitäten von Adobe Marketo Engage **Voraussetzungen** + Ein Objekt in Adobe Marketo Engage, in das geschrieben werden soll. Sie benötigen den Objektnamen wie `leads` oder `customobjects`. + Der Adobe-Marketo-Connector unterstützt drei Schreibvorgänge: + INSERT + UPSERT + UPDATE + Für die Schreibvorgänge `UPSERT` und `UPDATE` muss die Option `ID_FIELD_NAMES` bereitgestellt werden, um das ID-Feld für die Datensätze anzugeben. Wenn Sie mit der Entität `leads` arbeiten, verwenden Sie `email` als `ID_FIELD_NAMES` für `UPSERT`-Vorgänge und `id` für `UPDATE`-Vorgänge. Verwenden Sie für die Entität `customobjects` `marketoGUID` als `ID_FIELD_NAMES` sowohl für `UPDATE`- als auch für `UPSERT`-Vorgänge. **Unterstützte Entitäten für Ziel (synchron)** | Entitätsname | Wird als Ziel-Connector unterstützt | Kann eingefügt werden | Kann aktualisiert werden. | Kann aktualisiert/eingefügt werden | | --- | --- | --- | --- | --- | | Leads | Ja | Ja(Bulk) | Ja(Bulk) | Ja(Bulk) | | customobjects | Ja | Ja(Bulk) | Ja(Bulk) | Ja(Bulk) | **Beispiel:** **INSERT-Vorgang:** ``` marketo_write = glueContext.write_dynamic_frame.from_options( frame=frameToWrite, connection_type="marketo", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "leads", "API_VERSION": "v1", "WRITE_OPERATION": "INSERT" } ``` **UPDATE-Vorgang** ``` marketo_write = glueContext.write_dynamic_frame.from_options( frame=frameToWrite, connection_type="marketo", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "leads", "API_VERSION": "v1", "WRITE_OPERATION": "UPDATE", "ID_FIELD_NAMES": "id" } ``` **Anmerkung** Für die Entitäten `leads` und `customobjects` bietet Adobe Marketo Endpunkte zum dynamischen Abrufen von Metadaten, sodass die beschreibbaren Felder anhand der Marketo-API-Antwort identifiziert werden. # Verbindungsoptionen für Adobe Marketo Engage Im Folgenden sind Verbindungsoptionen für Adobe Marketo Engage aufgeführt: + `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in Adobe Marketo Engage. + `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Version der REST-API von Adobe Marketo Engage, die Sie verwenden möchten. Beispiel: v1. + `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten. + `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen. + `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage. + `PARTITION_FIELD`(Zeichenfolge) – Zum Lesen verwendet. Feld, das zur Partitionierung der Abfrage verwendet werden soll. + `LOWER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds. + `UPPER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds. + `NUM_PARTITIONS`(Ganzzahl) – Standard: 1. Zum Lesen verwendet. Anzahl der zu lesenden Partitionen. + `TRANSFER_MODE`(Zeichenfolge) – Standard: SYNC. Für asynchrones Lesen verwendet. + `WRITE_OPERATION`(Zeichenfolge) – Standard: INSERT. Zum Schreiben verwendet. Wert muss INSERT, UPDATE, UPSERT sein. + `ID_FIELD_NAMES`(Zeichenfolge) – Standard: null. Erforderlich für UPDATE und UPSERT. # Einschränkungen und Hinweise für den Adobe-Marketo-Engage-Connector Im Folgenden finden Sie Einschränkungen oder Hinweise für den Jira-Cloud-Connector: + 'SinceDateTime' und 'activityTypeId' sind obligatorische Filterparameter für die Entität Sync Activities. + Den Abonnements werden 50.000 API-Aufrufe pro Tag zugewiesen (zurückgesetzt täglich um 12:00 Uhr CST). Zusätzliche Tageskapazität kann im Rahmen eines Adobe-Marketo-Engage-Abonnements erworben werden. Weitere Informationen finden Sie unter [Adobe-Marketo-Rest-API](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api). + Die maximale Zeitspanne für den Datumsbereichsfilter (`createdAt` oder `updatedAt`) beträgt 31 Tage. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + Den Abonnements werden jeweils maximal 10 Massenextraktionsaufträge in der Warteschlange zugewiesen. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + Standardmäßig sind Extrahierungsaufträge auf 500 MB pro Tag begrenzt (zurückgesetzt täglich um 12:00 Uhr CST). Zusätzliche Tageskapazität kann im Rahmen eines Adobe-Marketo-Engage-Abonnements erworben werden. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + Es sind maximal zwei Exportaufträge gleichzeitig möglich. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + Es sind maximal zehn Exportaufträge in der Warteschlange (einschließlich der aktuell exportierten Aufträge) möglich. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + Die maximal zulässige Dateigröße für das Extrahieren aus einem Massenauftrag beträgt 1 GB. + Sobald ein asynchroner Auftrag erstellt wurde, beträgt die Aufbewahrungsfrist für die Datei 7 Tage. Weitere Informationen finden Sie unter [Bulk Extract - Marketo Developers](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract). + `createdAt` oder `updatedAt` sind obligatorische Filterparameter für die Async-Leads-Entität. + `createdAt` ist ein obligatorischer Filterparameter für die Async-Activities-Entität. + `updatedAt` ist ein obligatorischer Filterparameter für die Custom-Object-Entität. + Bei der Verwendung von AWS Glue SaaS-Konnektoren können Benutzer nicht identifizieren, welche spezifischen Datensätze bei einem Schreibvorgang auf SaaS-Zielplattformen bei teilweisen Ausfällen fehlgeschlagen sind. + Bei Verwendung von Sync-Schreibvorgängen werden alle Felder mit Nullwerten in der Eingabedatei automatisch gelöscht und nicht an die SaaS-Plattform gesendet. + Sie können bis zu 300 Datensätze in einem Stapel für die Synchronisierung erstellen oder aktualisieren. Weitere Informationen finden Sie unter [Adobe Marketo Engage Integration Best Practices](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/marketo-integration-best-practices) und [Bulk Extract](https://https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-activity-extract).