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 Analytics
Adobe Analytics ist eine leistungsstarke Datenanalyseplattform, die Daten aus digitalen Multi-Channel-Erlebnissen sammelt, die die Customer Journey unterstützen, und Tools zur Analyse dieser Daten bereitstellt. Diese Plattform wird häufig von Vermarktern und Geschäftsanalysten für geschäftliche Analysezwecke genutzt. Wenn Sie ein Adobe Analytics-Benutzer sind, können Sie eine Verbindung AWS Glue zu Ihrem Adobe Analytics-Konto herstellen. Anschließend können Sie Adobe Analytics als Datenquelle in Ihren ETL-Aufträgen verwenden. Führen Sie diese Jobs aus, um Daten zwischen Adobe Analytics und AWS Diensten oder anderen unterstützten Anwendungen zu übertragen.
**Topics**
+ [AWS Glue Unterstützung für Adobe Analytics](adobe-analytics-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](adobeanalytics-configuring-iam-permissions.md)
+ [Konfigurieren von Adobe Analytics](adobeanalytics-configuring.md)
+ [Konfigurieren von Adobe Analytics-Verbindungen](adobeanalytics-configuring-connections.md)
+ [Aus Adobe Analytics-Entitäten lesen](adobeanalytics-reading-from-entities.md)
+ [Verbindungsoptionen für Adobe Analytics](adobeanalytics-connection-options.md)
+ [Erstellen eines Adobe Analytics-Kontos](adobeanalytics-create-account.md)
+ [Einschränkungen](adobeanalytics-connector-limitations.md)
# AWS Glue Unterstützung für Adobe Analytics
AWS Glue unterstützt Adobe Analytics wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Adobe Analytics abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Versionen der Adobe Analytics-API**
v2.0
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS 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 vorstehende 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, an die die Richtlinie angehängt 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 in der Regel Benutzern der AWS Glue Konsole zugewiesen.
# Konfigurieren von Adobe Analytics
Bevor Sie die Übertragung von Adobe Analytics verwenden AWS Glue können, müssen Sie die folgenden Anforderungen erfüllen:
## Mindestanforderungen
+ Sie haben ein Adobe Analytics-Konto mit E-Mail-Adresse und Passwort. Weitere Informationen zum Erstellen eines Kontos finden Sie unter [Erstellen eines Adobe Analytics-Kontos](adobeanalytics-create-account.md).
+ Ihr Adobe Analytics-Konto ist für den API-Zugriff aktiviert. API-Zugriff ist standardmäßig für die Editionen „Select“, „Prime“ und „Ultimate“ aktiviert.
Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem Adobe Analytics-Konto herstellen. Für typische Verbindungen müssen Sie in Adobe Analytics nichts weiter tun.
# Konfigurieren von Adobe Analytics-Verbindungen
Adobe Analytics unterstützt den `AUTHORIZATION_CODE`-Gewährungstyp für `OAuth2`.
Dieser Gewährungstyp wird als „dreibeiniges“ `OAuth` betrachtet, da er darauf angewiesen ist, dass Benutzer zur Authentifizierung an den Autorisierungsserver eines Drittanbieters weitergeleitet werden. Benutzer können sich dafür entscheiden, ihre eigene verbundene App in Adobe Analytics zu erstellen und ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben, wenn sie Verbindungen über die AWS Glue Konsole herstellen. In diesem Szenario werden sie weiterhin zu Adobe Analytics weitergeleitet, um sich anzumelden und AWS Glue den Zugriff auf ihre Ressourcen zu gewähren.
Dieser Gewährungstyp führt zu einem Aktualisierungstoken und einem Zugriffstoken. Das Zugriffstoken ist kurzlebig und kann mithilfe des Aktualisierungstokens automatisch ohne Benutzerinteraktion aktualisiert werden.
[Eine öffentliche Adobe Analytics-Dokumentation zur Erstellung einer verbundenen App für den OAuth AUTHORIZATION\$1CODE-Flow finden Sie unter Adobe Analytics. APIs](https://adobedocs.github.io/analytics-2.0-apis/)
So konfigurieren Sie eine Adobe Analytics-Verbindung:
1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:
Für kundenseitig verwaltete verbundene App – Geheimnis muss das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten.
**Anmerkung**
Sie müssen für jede Verbindung in AWS Glue ein Geheimnis erstellen.
1. Stellen Sie in AWS Glue Studio unter **Datenverbindungen** eine Verbindung her, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie als **Verbindungstyp** Adobe Analytics aus.
1. Geben Sie die `x_api_key, instanceUrl` von Adobe Analytics an, zu der eine Verbindung hergestellt werden soll.
1. Wählen Sie die IAM-Rolle aus, für die AWS Glue Sie die folgenden Aktionen übernehmen können und über Berechtigungen verfügen:
------
#### [ 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, die Sie für diese Verbindung verwenden möchten AWS Glue , um die Token einzufügen.
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.
# Aus Adobe Analytics-Entitäten lesen
**Voraussetzungen**
Ein Adobe Analytics-Objekt, aus dem gelesen werden soll. In der folgenden Tabelle mit unterstützten Entitäten können Sie die verfügbaren Entitäten überprüfen.
**Unterstützte Entitäten**
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Anmerkung | Ja | Ja | Ja | Ja | Nein |
| Berechnete Metriken | Ja | Ja | Ja | Ja | Nein |
| Funktion für berechnete Metriken | Ja | Nein | Nein | Ja | Nein |
| Freigaben von Komponentenmetadaten | Ja | Ja | Nein | Ja | Nein |
| Datumsbereiche | Ja | Ja | Nein | Ja | Nein |
| Dimensionen | Ja | Nein | Nein | Ja | Nein |
| Kennzahlen | Ja | Nein | Nein | Ja | Nein |
| Projekte | Ja | Nein | Nein | Ja | Nein |
| Wichtigstes Element der Berichte | Ja | Ja | Nein | Ja | Nein |
| Segmente | Ja | Ja | Ja | Ja | Nein |
| Nutzungsprotokolle | Ja | Ja | Nein | Ja | Nein |
**Beispiel**
```
adobeAnalytics_read = glueContext.create_dynamic_frame.from_options(
connection_type="adobeanalytics",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "annotation/ex*****",
"API_VERSION": "v2.0"
})
```
**Entitäts- und Felddetails von Adobe Analytics**
+ [Anmerkungen](https://adobedocs.github.io/analytics-2.0-apis/#/Annotations)
+ [Berechnete Metriken](https://adobedocs.github.io/analytics-2.0-apis/#/Calculated%20Metrics)
+ [Komponentenmetadaten](https://adobedocs.github.io/analytics-2.0-apis/#/Component%20Meta%20Data)
+ [Datumsbereiche](https://adobedocs.github.io/analytics-2.0-apis/#/Date%20Ranges)
+ [Dimensions (Abmessungen)](https://adobedocs.github.io/analytics-2.0-apis/#/Dimensions)
+ [Metriken](https://adobedocs.github.io/analytics-2.0-apis/#/Metrics)
+ [Projekte](https://adobedocs.github.io/analytics-2.0-apis/#/Projects)
+ [Berichte](https://adobedocs.github.io/analytics-2.0-apis/#/Reports)
+ [Segmente](https://adobedocs.github.io/analytics-2.0-apis/#/Segments)
+ [Benutzer](https://adobedocs.github.io/analytics-2.0-apis/#/Users)
+ [Nutzungsprotokolle](https://adobedocs.github.io/analytics-2.0-apis/#/Usage%20Logs)
# Verbindungsoptionen für Adobe Analytics
Im Folgenden sind Verbindungsoptionen für Adobe Analytics aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Der Name Ihres Objekts in Adobe Analytics.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Version der REST-API von Adobe Analytics, die Sie verwenden möchten. Beispiel: v2.0.
+ `X_API_KEY` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Dies ist erforderlich, um den Entwickler oder die Anwendung zu authentifizieren, die Anforderungen an die API stellen.
+ `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.
# Erstellen eines Adobe Analytics-Kontos
1. Registrieren Sie sich für das Austauschpartnerprogramm, indem Sie auf das [Adobe-Partnerprogramm](https://partners.adobe.com/exchangeprogram/creativecloud.html) zugreifen.
1. Wählen Sie **Am Exchange-Programm teilnehmen**.
1. Registrieren Sie sich oder erstellen Sie ein Konto mit Ihrer Unternehmens-E-Mail-Adresse.
1. Wählen Sie im Vorschlagsfeld das entsprechende Unternehmen aus, das über ein Adobe Analytics-Produktabonnement verfügt.
1. Stellen Sie sicher, dass das Konto bei einer gültigen Organisation (aus der verfügbaren Liste) registriert ist, die über ein aktives Adobe Analytics-Abonnement verfügt.
1. Aktivieren Sie Ihr Konto nach der Genehmigung durch die Unternehmensverwaltung, indem Sie auf den Link in der Genehmigungs-E-Mail klicken.
**Überprüfen Sie, ob das von Ihnen erstellte Konto Zugriff auf den Adobe Analytics-Dienst hat**
1. Melden Sie sich bei der [Adobe-Adminkonsole](https://adminconsole.adobe.com/) an.
1. Überprüfen Sie den Namen der Organisation oben rechts auf der Seite, um sicherzustellen, dass Sie sich bei der richtigen Firma angemeldet haben.
1. Wählen Sie **Produkte** aus und überprüfen Sie, ob Adobe Analytics verfügbar ist.
**Anmerkung**
Wenn keine Organisation verfügbar ist oder das Adobe Analytics-Produkt ausgegraut oder nicht verfügbar ist, ist Ihr Konto wahrscheinlich nicht mit einer Organisation verknüpft, die kein aktives Adobe Analytics-Abonnement and/or hat. Wenden Sie sich an Ihren Systemadministrator, um den Zugriff auf diesen Service für Ihr Konto anzufordern.
**Erstellen eines Projekts und von `OAuth2.0`-Zugangsdaten**
1. Melden Sie sich bei dem Adobe Analytics-Konto an, in dem die [ OAuth 2.0-App](https://developer.adobe.com/developer-console/docs/guides/services/services-add-api-oauth/) erstellt werden soll.
1. Wählen Sie **Projekt** und dann **Neues Projekt erstellen** aus.
1. Um ein Projekt hinzuzufügen, wählen Sie **Dem Projekt hinzufügen** und dann **API** aus.
1. Wählen Sie **Adobe Analytics-API** aus.
1. Wählen Sie **OAUTH** als Benutzerauthentifizierung aus.
1. Wählen Sie **Web** für `OAUTH` aus und geben Sie die Umleitungs-URI an.
Informationen zur Umleitungs-URI und dem Muster finden Sie im Folgenden:
+ `OAuth 2.0`-Standard-Umleitungs-URI: Ein Standard-Umleitungs-URI ist die URL der Seite, auf die Adobe während des Authentifizierungsprozesses zugreift. Beispiel: `https://ap-southeast-2.console.aws.amazon.com/appflow/oauth`
+ OAuth 2.0 Umleitungs-URI-Muster — Ein Umleitungs-URI-Muster ist ein URI-Pfad (oder eine durch Kommas getrennte Liste von Pfaden), zu dem Adobe (falls angefordert) weiterleiten kann, wenn der Anmeldevorgang abgeschlossen ist. Beispiel: `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com`
1. Fügen Sie die folgenden Bereiche hinzu:
+ `openid`
+ `read_organizations`
+ `additional_info.projectedProductContext`
+ `additional_info.job_function`
1. Wählen Sie **Anmeldeinformationen speichern** aus.
1. Nach dem Erstellen der App kopieren Sie die Werte `Client ID` und `Client Secret` in eine Textdatei.
# Einschränkungen
Die folgenden Einschränkungen gelten für den Adobe Analytics-Connector:
+ Adobe Analytics unterstützt die feldbasierte und datensatzbasierte Partitionierung nicht. Die feldbasierte Partitionierung wird nicht unterstützt, weil Sie partitionierte Felder nicht abfragen können. Die datensatzbasierte Partitionierung kann nicht unterstützt werden, weil es keine Möglichkeit gibt, einen Versatzwert für die Paginierung zu erhalten.
+ In der Entität `Report Top Item` funktionieren die Abfrageparameter `startDate` und `endDate` nicht wie erwartet. Die Antwort wird nicht basierend auf diesen Parametern gefiltert, was zu Problemen mit dem Filter und dem inkrementellen Ablauf für diese Entität führt.
+ Für die Entitäten `Annotation`, `Calculated Metrics`, `Calculated Metrics Function`, `Date Ranges`, `Dimension`, `Metric`, `Project`, `Report Top Items` und `Segment` gibt der Abfrageparameter `locale` an, welche Sprache für lokalisierte Antwortabschnitte verwendet werden soll, und filtert die Datensätze nicht. `locale="ja_JP"` zeigt die Daten beispielsweise auf Japanisch an.
+ `Report Top Item`-Entität – Filter basierend auf den Feldern `dateRange` und `lookupNoneValues` funktionieren derzeit nicht.
+ `Segment`-Entität – Mit einem Filterwert von `includeType=“templates”` funktionieren Filter für andere Felder nicht.
+ `Date Range`-Entität – Der Filter basierend auf dem Feld `curatedRsid` funktioniert nicht.
+ `Metric entity`-Entität – Der Filter nach einem segmentierbaren Feld mit dem Wert „false“ liefert Ergebnisse sowohl für den wahren (true) als auch für den falschen (false) Wert.