Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Connessione a Facebook Page Insights Le pagine Facebook permettono alle aziende e ad altri gruppi di interesse di creare pagine per il social network Facebook.com. Le aziende usano queste pagine per condividere gli orari di apertura, fare annunci e interagire con i clienti online. Se sei un utente di Facebook Page Insights, puoi connetterti AWS Glue al tuo account Facebook Page Insights. Puoi usare Facebook Page Insights come origine dati per i tuoi processi ETL. Esegui questi processi per trasferire dati da Facebook Page Insights ai AWS servizi o ad altre applicazioni supportate. **Topics** + [AWS Glue supporto per Facebook Page Insights](facebook-page-insights-support.md) + [Policy contenenti le operazioni API per creare e utilizzare le connessioni](facebook-page-insights-configuring-iam-permissions.md) + [Configurazione degli Approfondimenti sulla pagina Facebook](facebook-page-insights-configuring.md) + [Configurazione delle connessioni degli Approfondimenti sulla pagina Facebook](facebook-page-insights-configuring-connections.md) + [Lettura da entità degli Approfondimenti sulla pagina Facebook](facebook-page-insights-reading-from-entities.md) + [Opzioni di connessione degli Approfondimenti sulla pagina Facebook](facebook-page-insights-connection-options.md) + [Limitazioni e note per il connettore degli Approfondimenti sulla pagina Facebook](facebook-page-insights-connector-limitations.md) # AWS Glue supporto per Facebook Page Insights AWS Glue supporta Facebook Page Insights come segue: **Supportato come origine?** Sì. Puoi utilizzare i job AWS Glue ETL per interrogare i dati da Facebook Page Insights. **Supportato come destinazione?** No. **Versioni supportate dell'API degli Approfondimenti sulla pagina Facebook** Le versioni dell'API degli Approfondimenti sulla pagina Facebook supportate sono le seguenti: + v17 + v18 + v19 + v20 + v21 # Policy contenenti le operazioni API per creare e utilizzare le connessioni La seguente policy di esempio descrive le autorizzazioni AWS IAM richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ In alternativa, se non desideri utilizzare il metodo precedente, utilizza le seguenti policy IAM gestite: + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che AWS Glue i vari processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono AWS Glue Amazon S3, IAM, CloudWatch Logs e Amazon. EC2 Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni richieste. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la policy utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console. # Configurazione degli Approfondimenti sulla pagina Facebook Prima di poter AWS Glue utilizzare il trasferimento di dati da Facebook Page Insights, devi soddisfare questi requisiti: ## Requisiti minimi I requisiti minimi sono i seguenti: + Gli account Facebook Standard sono accessibili direttamente tramite Facebook. + L'autenticazione dell'utente è necessaria per generare il token di accesso. + Il connettore Facebook Page Insights implementa il OAuth flusso User Access Token. + Il connettore utilizza OAuth2 .0 per autenticare le nostre richieste API su Facebook Page Insights. Questo rientra nell'architettura dell'autenticazione a più fattori (MFA), che è un superset di 2FA. È un'autenticazione basata sul web. + L'utente deve concedere le autorizzazioni per accedere agli endpoint. Per accedere ai dati dell'utente, l'autorizzazione degli endpoint viene gestita tramite autorizzazioni e funzionalità. # Configurazione delle connessioni degli Approfondimenti sulla pagina Facebook Per configurare una connessione agli Approfondimenti sulla pagina Facebook: 1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti: 1. Quando selezioni un **tipo di connessione**, seleziona gli Approfondimenti sulla pagina Facebook. 1. Seleziona il ruolo AWS IAM che AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Seleziona l'URL del codice di autorizzazione. 1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token. 1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete. 1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro. # Lettura da entità degli Approfondimenti sulla pagina Facebook **Prerequisito** Un oggetto degli Approfondimenti sulla pagina Facebook da cui desideri leggere. È necessario il nome dell'oggetto. **Entità supportate come origine**: | Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | | --- | --- | --- | --- | --- | --- | | Contenuto della pagina | Sì | No | Sì | Sì | Sì | | Clic sul CTA della pagina | Sì | No | No | Sì | Sì | | Coinvolgimento di pagina | Sì | No | No | Sì | Sì | | Impression della pagina | Sì | No | No | Sì | Sì | | Post della pagina | Sì | No | No | Sì | Sì | | Coinvolgimento dei post della pagina | No | No | No | Sì | No | | Reazioni ai post della pagina | No | No | No | Sì | No | | Reazioni della pagina | Sì | No | No | Sì | Sì | | Storie | Sì | No | No | Sì | Sì | | Dati demografici degli utenti della pagina | Sì | No | No | Sì | Sì | | Visualizzazioni dei video della pagina | Sì | No | No | Sì | Sì | | Visualizzazioni della pagina | Sì | No | No | Sì | Sì | | Post dei video della pagina | Sì | No | No | Sì | Sì | | Pagine | No | Sì | No | Sì | No | | Feed | Sì | Sì | No | Sì | Sì | **Esempio**: ``` facebookPageInsights_read = glueContext.create_dynamic_frame. from options( connection_type="facebookpageinsights", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "entityName", "API_VERSION": "v21" } ``` **Dettagli del campo degli Approfondimenti sulla pagina Facebook**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/facebook-page-insights-reading-from-entities.html) ## Query di partizionamento **Partizionamento basato su filtri**: È possibile fornire le opzioni Spark aggiuntive `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se si desidera utilizzare la simultaneità in Spark. Con questi parametri, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark. + `PARTITION_FIELD`: il nome del campo da utilizzare per partizionare la query. + `LOWER_BOUND`: un valore limite inferiore **inclusivo** del campo di partizione scelto. Per il campo Datetime accettiamo il formato di timestamp Spark utilizzato nelle query SQL di Spark. Esempi di valori validi: ``` "2024-09-30T01:01:01.000Z" ``` + `UPPER_BOUND`: un valore limite superiore **esclusivo** del campo di partizione scelto. + `NUM_PARTITIONS`: il numero di partizioni. Esempio: ``` 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" } ``` # Opzioni di connessione degli Approfondimenti sulla pagina Facebook Le seguenti sono le opzioni di connessione per gli Approfondimenti sulla pagina Facebook: + `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome del tuo oggetto negli Approfondimenti sulla pagina Facebook. + `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. Versione dell'API Rest degli Approfondimenti sulla pagina Facebook che desideri utilizzare. + `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne da selezionare per l'oggetto. + `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Dev'essere in formato Spark SQL. + `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query Spark SQL completa. + `PARTITION_FIELD`(Stringa): utilizzato per la lettura. Campo da utilizzare per partizionare la query. + `LOWER_BOUND`(Stringa): utilizzato per la lettura. Un valore limite inferiore inclusivo del campo di partizione scelto. + `UPPER_BOUND`(Stringa): utilizzato per la lettura. Un valore limite superiore esclusivo del campo di partizione scelto. + `NUM_PARTITIONS`(Numero intero): predefinito: 1. Utilizzato per la lettura. Numero di partizioni da leggere. + `INSTANCE_URL`(Stringa): (obbligatorio) utilizzato per la lettura. Un URL di istanza valido di Facebook Page Insights. # Limitazioni e note per il connettore degli Approfondimenti sulla pagina Facebook Di seguito sono riportate le limitazioni o le note per il connettore degli Approfondimenti sulla pagina Facebook: + La maggior parte delle metriche viene aggiornata una volta ogni 24 ore. + Sono disponibili solo i dati degli ultimi due anni di approfondimenti. + È possibile visualizzare solo 90 giorni di approfondimenti alla volta utilizzando i parametri `since` e `until`.