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 Facebook Page Insights
Facebook Pages ermöglicht es Unternehmen und anderen Interessengruppen, Seiten für das soziale Netzwerk Facebook.com zu erstellen. Unternehmen nutzen diese Seiten, um Öffnungszeiten zu teilen, Ankündigungen zu machen und online mit Kunden in Kontakt zu treten. Wenn Sie ein Facebook Page Insights-Nutzer sind, können Sie eine Verbindung AWS Glue zu Ihrem Facebook Page Insights-Konto herstellen. Sie können Facebook Page Insights als Datenquelle für Ihre ETL-Aufträge verwenden. Führen Sie diese Jobs aus, um Daten von Facebook Page Insights an AWS Dienste oder andere unterstützte Anwendungen zu übertragen.
**Topics**
+ [AWS Glue Unterstützung für Facebook Page Insights](facebook-page-insights-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](facebook-page-insights-configuring-iam-permissions.md)
+ [Konfigurieren von Facebook Page Insights](facebook-page-insights-configuring.md)
+ [Konfigurieren von Verbindungen mit Facebook Page Insights](facebook-page-insights-configuring-connections.md)
+ [Lesen aus Facebook-Page-Insights-Entitäten](facebook-page-insights-reading-from-entities.md)
+ [Verbindungsoptionen für Facebook Page Insights](facebook-page-insights-connection-options.md)
+ [Einschränkungen und Hinweise für den Facebook-Page-Insights-Connector](facebook-page-insights-connector-limitations.md)
# AWS Glue Unterstützung für Facebook Page Insights
AWS Glue unterstützt Facebook Page Insights wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Facebook Page Insights abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Versionen der API von Facebook Page Insights**
Die folgenden Versionen der API von Facebook Page Insights werden unterstützt:
+ v17
+ v18
+ v19\$1
+ v20
+ v21
# 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.
# Konfigurieren von Facebook Page Insights
Bevor Sie Daten von Facebook Page Insights übertragen können, müssen Sie die folgenden Anforderungen erfüllen: AWS Glue
## Mindestanforderungen
Die folgenden Anforderungen sind Mindestanforderungen:
+ Auf Facebook-Standardkonten wird direkt über Facebook zugegriffen.
+ Zur Generierung des Zugriffstokens ist eine Benutzerauthentifizierung erforderlich.
+ Der Facebook Page Insights-Konnektor implementiert den OAuth Benutzerzugriffstoken-Flow.
+ Der Connector verwendet OAuth2 .0, um unsere API-Anfragen bei Facebook Page Insights zu authentifizieren. Dies fällt unter die Multi-Faktor-Authentifizierung (MFA)-Architektur, die eine Obergruppe von 2FA darstellt. Es handelt sich um eine webbasierte Authentifizierung.
+ Der Benutzer muss Berechtigungen für den Zugriff auf die Endpunkte gewähren. Für den Zugriff auf die Benutzerdaten erfolgt die Autorisierung des Endpunkts über Berechtigungen und Features.
# Konfigurieren von Verbindungen mit Facebook Page Insights
Konfigurieren einer Verbindung mit Facebook Page Insights:
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** Facebook Page Insights aus.
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 die URL des Autorisierungscodes aus.
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 Facebook-Page-Insights-Entitäten
**Voraussetzung**
Ein Facebook-Page-Insights-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen.
**Unterstützte Entitäten für Quelle**:
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Seiteninhalt | Ja | Nein | Ja | Ja | Ja |
| CTA-Klicks auf Seite | Ja | Nein | Nein | Ja | Ja |
| Seiteninteraktion | Ja | Nein | Nein | Ja | Ja |
| Seiten-Impressionen | Ja | Nein | Nein | Ja | Ja |
| Seiten-Posts | Ja | Nein | Nein | Ja | Ja |
| Seiten-Post-Interaktion | Nein | Nein | Nein | Ja | Nein |
| Seiten-Post-Reaktionen | Nein | Nein | Nein | Ja | Nein |
| Seitenreaktionen | Ja | Nein | Nein | Ja | Ja |
| Geschichten | Ja | Nein | Nein | Ja | Ja |
| Demografische Merkmale der Seitenbenutzer | Ja | Nein | Nein | Ja | Ja |
| Seiten-Videoaufrufe | Ja | Nein | Nein | Ja | Ja |
| Seitenaufrufe | Ja | Nein | Nein | Ja | Ja |
| Seiten-Videobeiträge | Ja | Nein | Nein | Ja | Ja |
| Seiten | Nein | Ja | Nein | Ja | Nein |
| Feeds | Ja | Ja | Nein | Ja | Ja |
**Beispiel:**
```
facebookPageInsights_read = glueContext.create_dynamic_frame. from options(
connection_type="facebookpageinsights",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "entityName",
"API_VERSION": "v21"
}
```
**Facebook-Page-Insights-Felddetails**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/facebook-page-insights-reading-from-entities.html)
## Partitionieren von Abfragen
**Filterbasierte Partitionierung**:
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 das Spark-Zeitstempelformat, das in Spark-SQL-Abfragen verwendet wird.
Beispiele für gültigen Wert:
```
"2024-09-30T01:01:01.000Z"
```
+ `UPPER_BOUND`: ein **exklusiver** Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`: Die Anzahl an Partitionen.
Beispiel:
```
facebookPageInsights_read = glueContext.create_dynamic_frame.from_options(
connection_type="facebookpageinsights",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "entityName",
"API_VERSION": "v21",
"PARTITION_FIELD": "created_Time"
"LOWER_BOUND": "2024-10-27T07:00:00+0000"
"UPPER_BOUND": "2024-10-27T07:00:00+0000"
"NUM_PARTITIONS": "10"
}
```
# Verbindungsoptionen für Facebook Page Insights
Im Folgenden sind Verbindungsoptionen für Facebook Page Insights aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in Facebook Page Insights.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Version der REST-API von Facebook Page Insights, die Sie verwenden möchten.
+ `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.
+ `INSTANCE_URL` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Eine gültige Instance-URL für Facebook Page Insights.
# Einschränkungen und Hinweise für den Facebook-Page-Insights-Connector
Im Folgenden finden Sie Einschränkungen oder Hinweise für den Facebook-Page-Insights-Connector:
+ Die meisten Metriken werden einmal alle 24 Stunden aktualisiert.
+ Es sind nur die Erkenntnisse der letzten zwei Jahre verfügbar.
+ Bei Verwendung der Parameter `since` und `until` können nur Erkenntnisse aus 90 Tagen gleichzeitig angezeigt werden.