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 ad Adobe Analytics Adobe Analytics è una piattaforma di analisi dati affidabile che raccoglie dati da esperienze digitali multicanale che supportano il percorso del cliente e fornisce strumenti per l'analisi dei dati. Si tratta di una piattaforma comunemente usata dai professionisti del marketing e dagli analisti aziendali per scopi di analisi aziendale. Se sei un utente di Adobe Analytics, puoi connetterti AWS Glue al tuo account Adobe Analytics. Quindi, puoi usare Adobe Analytics come origine dati nei tuoi processi ETL. Esegui questi processi per trasferire dati tra Adobe Analytics e AWS servizi o altre applicazioni supportate. **Topics** + [AWS Glue supporto per Adobe Analytics](adobe-analytics-support.md) + [Policy contenenti le operazioni API per creare e utilizzare le connessioni](adobeanalytics-configuring-iam-permissions.md) + [Configurazione di Adobe Analytics](adobeanalytics-configuring.md) + [Configurazione delle connessioni Adobe Analytics](adobeanalytics-configuring-connections.md) + [Lettura da entità di Adobe Analytics](adobeanalytics-reading-from-entities.md) + [Opzioni di connessione di Adobe Analytics](adobeanalytics-connection-options.md) + [Creazione di un account Adobe Analytics](adobeanalytics-create-account.md) + [Limitazioni](adobeanalytics-connector-limitations.md) # AWS Glue supporto per Adobe Analytics AWS Glue supporta Adobe Analytics come segue: **Supportato come origine?** Sì. Puoi utilizzare i lavori AWS Glue ETL per interrogare i dati da Adobe Analytics. **Supportato come destinazione?** No. **Versioni dell'API Adobe Analytics supportate** v2.0 # Policy contenenti le operazioni API per creare e utilizzare le connessioni La seguente politica di esempio descrive le AWS autorizzazioni 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: + [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che diversi AWS Glue processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono Amazon S3 AWS Glue, 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 necessarie. 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 politica 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 di Adobe Analytics Prima di poter AWS Glue utilizzare il trasferimento da Adobe Analytics, devi soddisfare i seguenti requisiti: ## Requisiti minimi + Avere un account Adobe Analytics con e-mail e password. Per ulteriori informazioni sulla creazione di account, consulta [Creating a Adobe Analytics account](adobeanalytics-create-account.md). + L'account Adobe Analytics è abilitato per l'accesso alle API. L'accesso all'API è abilitato per impostazione predefinita per le edizioni Select, Prime e Ultimate. Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Adobe Analytics. Per le connessioni tipiche, non è necessario fare nient'altro in Adobe Analytics. # Configurazione delle connessioni Adobe Analytics Adobe Analytics supporta il tipo di concessione `AUTHORIZATION_CODE` per `OAuth2`. Questo tipo di concessione è considerato `OAuth` “a tre gambe” in quanto si basa sul reindirizzamento degli utenti al server di autorizzazione di terzi per l'autenticazione. Gli utenti possono scegliere di creare la propria app connessa in Adobe Analytics e fornire il proprio ID client e il segreto del client durante la creazione di connessioni tramite la AWS Glue console. In questo scenario, verranno comunque reindirizzati ad Adobe Analytics per accedere e autorizzare AWS Glue ad accedere alle risorse. Questo tipo di concessione genera un token di aggiornamento e un token di accesso. Il token di accesso dura poco tempo e può essere aggiornato automaticamente senza l'interazione dell'utente utilizzando il token di aggiornamento. [Per la documentazione pubblica di Adobe Analytics sulla creazione di un'app connessa per il OAuth flusso AUTHORIZATION\$1CODE, consulta Adobe Analytics. APIs](https://adobedocs.github.io/analytics-2.0-apis/) Per configurare una connessione Adobe Analytics: 1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli: Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` come chiave. **Nota** È necessario creare un segreto per ogni connessione in AWS Glue. 1. In AWS Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti: 1. In **Tipo di connessione**, seleziona Adobe Analytics. 1. Fornisci `x_api_key, instanceUrl` di Adobe Analytics a cui desideri connetterti. 1. Seleziona il ruolo IAM per il quale 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 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à di Adobe Analytics **Prerequisiti** Un oggetto di Adobe Analytics da cui desideri leggere. Consulta la tabella delle entità supportate qui di seguito per verificare quelle disponibili. **Entità supportate** | Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta Partizionamento | | --- | --- | --- | --- | --- | --- | | Annotazione | Sì | Sì | Sì | Sì | No | | Metriche calcolate | Sì | Sì | Sì | Sì | No | | Funzione delle metriche calcolate | Sì | No | No | Sì | No | | Condivisioni di metadati dei componenti | Sì | Sì | No | Sì | No | | Intervalli di date | Sì | Sì | No | Sì | No | | Dimensioni | Sì | No | No | Sì | No | | Metriche | Sì | No | No | Sì | No | | Progetti | Sì | No | No | Sì | No | | Segnala l'elemento principale | Sì | Sì | No | Sì | No | | Segmenti | Sì | Sì | Sì | Sì | No | | Log di utilizzo | Sì | Sì | No | Sì | No | **Esempio** ``` adobeAnalytics_read = glueContext.create_dynamic_frame.from_options( connection_type="adobeanalytics", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "annotation/ex*****", "API_VERSION": "v2.0" }) ``` **Dettagli sull'entità e sul campo di Adobe Analytics** + [Annotazioni](https://adobedocs.github.io/analytics-2.0-apis/#/Annotations) + [Metriche calcolate](https://adobedocs.github.io/analytics-2.0-apis/#/Calculated%20Metrics) + [Metadati dei componenti](https://adobedocs.github.io/analytics-2.0-apis/#/Component%20Meta%20Data) + [Intervalli di date](https://adobedocs.github.io/analytics-2.0-apis/#/Date%20Ranges) + [Dimensioni](https://adobedocs.github.io/analytics-2.0-apis/#/Dimensions) + [Parametri](https://adobedocs.github.io/analytics-2.0-apis/#/Metrics) + [Progetti](https://adobedocs.github.io/analytics-2.0-apis/#/Projects) + [Report](https://adobedocs.github.io/analytics-2.0-apis/#/Reports) + [Segmenti](https://adobedocs.github.io/analytics-2.0-apis/#/Segments) + [Utenti](https://adobedocs.github.io/analytics-2.0-apis/#/Users) + [Log di utilizzo](https://adobedocs.github.io/analytics-2.0-apis/#/Usage%20Logs) # Opzioni di connessione di Adobe Analytics Di seguito sono riportate le opzioni di connessione di Adobe Analytics: + `ENTITY_NAME` (stringa): (obbligatorio) utilizzato per lettura/scrittura. Il nome dell'oggetto in Adobe Analytics. + `API_VERSION` (stringa): (obbligatorio) utilizzato per lettura/scrittura. La versione dell'API Rest di Adobe Analytics da utilizzare. Ad esempio: v2.0. + `X_API_KEY` (stringa): (obbligatorio) utilizzato per lettura/scrittura. È necessario autenticare lo sviluppatore o l'applicazione che effettua richieste all'API. + `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. # Creazione di un account Adobe Analytics 1. Effettuare la registrazione al programma partner Exchange tramite l'accesso al [programma Adobe Partner](https://partners.adobe.com/exchangeprogram/creativecloud.html). 1. Scegliere **Iscriviti al programma Exchange**. 1. Effettuare la registrazione o creare un account utilizzando l'indirizzo e-mail aziendale. 1. Dalla finestra dei suggerimenti, selezionare l'azienda adeguata che dispone di un abbonamento al prodotto Adobe Analytics. 1. Assicurarsi che l'account venga registrato all'interno di un'organizzazione valida (dall'elenco disponibile) che dispone di un abbonamento attivo ad Adobe Analytics. 1. Dopo l'approvazione da parte dell'amministrazione dell'azienda, attivare l'account cliccando sul link presente nell'e-mail di approvazione. **Verificare se l'account creato ha accesso al servizio Adobe Analytics.** 1. Accedere alla [Adobe Admin Console](https://adminconsole.adobe.com/). 1. Verificare il nome dell'organizzazione nell'angolo in alto a destra della pagina per assicurarsi di aver effettuato l'accesso all'azienda corretta. 1. Selezionare **Prodotti** e verificare se è disponibile Adobe Analytics. **Nota** Se nessuna organizzazione è disponibile o il prodotto Adobe Analytics è disattivato o non è disponibile, è probabile che il tuo account non sia associato a un'organizzazione che non and/or ha un abbonamento attivo ad Adobe Analytics. Contattare l'amministratore di sistema per richiedere l'accesso a questo servizio per l'account. **Creazione di un progetto credenziali `OAuth2.0`** 1. Accedi all'account Adobe Analytics in cui desideri creare [l'app OAuth 2.0](https://developer.adobe.com/developer-console/docs/guides/services/services-add-api-oauth/). 1. Selezionare **Progetto**, poi **Crea un nuovo progetto**. 1. Per aggiungere un progetto, selezionare **Aggiungi al progetto**, poi **API**. 1. Selezionare l'**API Adobe Analytics**. 1. Selezionare **OAUTH** come autenticazione dell'utente. 1. Selezionare **Web** come `OAUTH` e indicare l'URI di reindirizzamento. Per l'URI di reindirizzamento e il relativo pattern, fare riferimento a quanto segue: + URI di reindirizzamento `OAuth 2.0` predefinito: un URI di reindirizzamento predefinito è l'URL della pagina a cui Adobe accederà durante il processo di autenticazione. Ad esempio, `https://ap-southeast-2.console.aws.amazon.com/appflow/oauth` + OAuth Schema URI di reindirizzamento 2.0: un pattern URI di reindirizzamento è un percorso URI (o elenco di percorsi separati da virgole) a cui Adobe può reindirizzare (se richiesto) quando il flusso di accesso è completo. Ad esempio, `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com` 1. Aggiungere i seguenti ambiti: + `openid` + `read_organizations` + `additional_info.projectedProductContext` + `additional_info.job_function` 1. Scegliere **Salva credenziali**. 1. Dopo aver creato l'app, copiare i valori `Client ID` e `Client Secret` in un file di testo. # Limitazioni Di seguito sono riportate le limitazioni per il connettore Adobe Analytics: + Adobe Analytics non supporta il partizionamento basato su campi e su record. Il partizionamento basato su campi non è supportato poiché non è possibile eseguire query sui campi partizionati. Il partizionamento basato su record non è supportato poiché non è previsto l'utilizzo di un valore di “offset” per l'impaginazione. + Nell'entità `Report Top Item`, i parametri di query `startDate` e `endDate` non funzionano come previsto. La risposta non viene filtrata in base a questi parametri, con conseguenti problemi di filtraggio e flusso incrementale per quest'entità. + Per le entità `Annotation`, `Calculated Metrics`, `Calculated Metrics Function`, `Date Ranges`, `Dimension`, `Metric`, `Project`, `Report Top Items` e `Segment`, il parametro di query `locale` specifica quale linguaggio deve essere utilizzato per le sezioni localizzate delle risposte e non filtra i record. Ad esempio, `locale="ja_JP"` mostrerà i dati in giapponese. + Entità `Report Top Item`: attualmente, il filtro per i campi `dateRange` e `lookupNoneValues` non funziona. + Entità `Segment`: con il valore del filtro `includeType=“templates”`, i filtri per gli altri campi non funzionano. + Entità `Date Range`: il filtro per il campo `curatedRsid` non funziona. + Entità `Metric entity`: il filtro per il campo segmentabile con valore “false” restituisce risultati per i valori true e false.