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 Snapchat Ads in AWS Glue Studio Snapchat è un'applicazione e un servizio di messaggistica istantanea multimediale sviluppato da Snap Inc., originariamente Snapchat Inc. Una delle caratteristiche principali di Snapchat è che le immagini e i messaggi sono solitamente disponibili solo per un breve periodo di tempo prima di diventare inaccessibili per i destinatari. Il marketing su Snapchat prevede che le aziende possano pagare per pubblicare post destinati agli utenti di Snapchat. **Topics** + [AWS Glue supporto per Snapchat Ads](snapchat-ads-support.md) + [Policy contenenti le operazioni API per creare e utilizzare le connessioni](snapchat-ads-configuring-iam-permissions.md) + [Configurazione di Snapchat Ads](snapchat-ads-configuring.md) + [Configurazione delle connessioni di Snapchat Ads](snapchat-ads-configuring-connections.md) + [Lettura dalle entità di Snapchat Ads](snapchat-ads-reading-from-entities.md) + [Opzioni di connessione di Snapchat Ads](snapchat-ads-connection-options.md) + [Creazione di un account di Snapchat Ad e configurazione dell'app client](connecting-to-data-snapchat-ads-new-account.md) + [Creazione di un'app nel proprio account Snapchat Ads](connecting-to-data-snapchat-ads-managed-client-application.md) # AWS Glue supporto per Snapchat Ads AWS Glue supporta Snapchat Ads come segue: **Supportato come origine?** Sì. Puoi utilizzare i job AWS Glue ETL per interrogare i dati da Snapchat Ads. **Supportato come destinazione?** No. **Versioni dell'API di Snapchat Ads supportate** v1. # 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": "*" } ] } ``` ------ È anche possibile utilizzare le seguenti policy IAM per autorizzare l'accesso: + [ 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 AWS Glue Amazon S3 Amazon CloudWatch Logs, IAM 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 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 di Snapchat Ads Prima di poter AWS Glue utilizzare il trasferimento da Snapchat Ads, devi soddisfare questi requisiti: ## Requisiti minimi + Avere un account Snapchat Ads. Per ulteriori informazioni sulla creazione di un account, consultare [Creazione di un account di Snapchat Ad e configurazione dell'app client](connecting-to-data-snapchat-ads-new-account.md). + Hai creato un' OAuth2 app nel tuo account Snapchat Ads. Questa integrazione fornisce le credenziali che AWS Glue utilizza per accedere in modo sicuro ai dati quando si effettuano chiamate autenticate al proprio account: Per ulteriori informazioni, consulta [Creazione di un'app nel proprio account Snapchat Ads](connecting-to-data-snapchat-ads-managed-client-application.md). Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Snapchat Ads. In Snapchat Ads, un'app connessa è un framework che autorizza applicazioni esterne, ad esempio AWS Glue, ad accedere ai dati di Snapchat Ads. # Configurazione delle connessioni di Snapchat Ads Snapchat Ads supporta solo il tipo di concessione `AUTHORIZATION_CODE`. Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti al server di autorizzazione di terze parti per autenticare l'utente. Viene utilizzato durante la creazione di connessioni tramite la console. AWS Glue Per impostazione predefinita, l'utente che crea una connessione può affidarsi a un'app connessa di AWS Glue proprietà (applicazione client AWS Glue gestita) in cui non deve fornire alcuna informazione OAuth correlata ad eccezione dell'URL dell'istanza di Snapchat Ads. La AWS Glue Console reindirizzerà l'utente a Snapchat Ads, dove l'utente deve effettuare il login e concedere AWS Glue le autorizzazioni richieste per accedere alla propria istanza di Snapchat Ads. Gli utenti possono comunque scegliere di creare la propria app connessa in Snapchat Ads e fornire il proprio ID cliente e il segreto del client quando creano connessioni tramite la AWS Glue Console. In questo scenario, verranno comunque reindirizzati a Snapchat Ads per effettuare il login e autorizzare l'accesso AWS Glue alle proprie risorse. Questo tipo di concessione genera un token di aggiornamento e uno di accesso. Il token di accesso scade 1 ora dopo la creazione. È possibile recuperare un nuovo token di accesso utilizzando il token di aggiornamento. Per ulteriori informazioni sulla creazione di un'app connessa per il OAuth flusso del codice di autorizzazione, consulta [Ads](https://marketingapi.snapchat.com/docs/#authentication) API. Per configurare una connessione a Snapchat Ads: 1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli. È necessario creare un segreto per ogni connessione in AWS Glue. 1. 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. 1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti: 1. In **Tipo di connessione**, selezionare Snapchat Ads. 1. Fornire l'ambiente di Snapchat Ads. 1. Seleziona il ruolo 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 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 dalle entità di Snapchat Ads **Prerequisiti** + Un oggetto di Snapchat Ads da cui si desidera leggere. Consultare 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 | | --- | --- | --- | --- | --- | --- | | Organizzazione | No | No | No | Sì | No | | Account pubblicitario | No | No | No | Sì | No | | Creativo | No | No | No | Sì | No | | Media | No | No | No | Sì | No | | Campagna | Sì | No | No | Sì | No | | Annuncio sotto Account pubblicitario | Sì | No | No | Sì | No | | Annuncio sotto campagna | No | No | No | Sì | No | | Annuncio Squadra | Sì | No | No | Sì | No | | Segment | No | No | No | Sì | No | **Esempio** ``` snapchatads_read = glueContext.create_dynamic_frame.from_options( connection_type="snapchatAds", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "organization", "API_VERSION": "v1" } ) ``` **Dettagli sull'entità e sul campo di Snapchat Ads** Snapchat Ads carica dinamicamente i campi disponibili nell'entità selezionata. A seconda del tipo di dati di campo, supporta i seguenti operatori di filtro. | Tipo di dati dei campi | Operatori di filtro supportati | | --- | --- | | Booleano | = | **Query di partizionamento** + Partizionamento basato sul campo: non supportato. + Partizionamento basato su record: non supportato. # Opzioni di connessione di Snapchat Ads Di seguito sono riportate le opzioni di connessione per Snapchat Ads: + `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome dell'entità di Snapchat Ads. Esempio: ` campaign `. + `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. La versione dell'API Rest di Snapchat Ads che si desidera utilizzare. Il valore sarà v1, poiché Snapchat Ads attualmente supporta solo la versione v1. + `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Elenco di colonne separate da virgole che si desidera selezionare per l'entità selezionata. + `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 di Snapchat Ad e configurazione dell'app client **Topics** + [Registrarsi a Snapchat Ads](#snapchat-ads-sign-up) + [Passaggi per creare un account Snapchat Ad](#snapchat-ads-create-ad-account) ## Registrarsi a Snapchat Ads **Per registrarti a Snapchat Ads:** 1. Vai su [Snapchat Ads Manager](https://ads.snapchat.com/). Seleziona **Registrati** accanto a **È la prima volta che usi Snapchat?**. 1. Nella schermata **Crea account**, segui le istruzioni per inserire il nome della tua attività, l'indirizzo e-mail, la password, ecc. Scegli **Next (Successivo)**. 1. Nella schermata **Crea profilo**, inserisci Nome utente e Sito Web (facoltativo). Poi seleziona **Crea account**. A questo punto avrai la possibilità di aggiungere una foto profilo e una biografia nella schermata **Modifica profilo**. Scegli **Conferma**. 1. Nella schermata **Informazioni aziendali**, compila i campi obbligatori come Paese, Valuta, Numero di telefono, GSTIN ecc. e completa il processo di creazione dell'account selezionando **Avanti**. ## Passaggi per creare un account Snapchat Ad **Per creare un account Snapchat Ad:** 1. Accedi ad **Ads Manager**. Poi fai clic sulla barra di navigazione nell'angolo superiore e seleziona ** Account pubblicitario**. 1. Scegli **\$1 Nuovo Account pubblicitario**. Inserisci i tuoi dati in quanto inserzionista: + Indica se sei un'agenzia che acquista annunci per conto di un inserzionista. Se selezioni "Sì", il tuo annuncio potrebbe essere rifiutato qualora utilizzi parametri di targeting che potrebbero includere l'età, il sesso o il codice postale. Il targeting basato sull'età può essere applicato a un minimo di 21 anni. + Indica se il tuo account pubblicitario pubblicherà annunci immobiliari, annunci relativi a crediti o annunci di lavoro. Se selezioni "Sì", il tuo annuncio potrebbe essere rifiutato qualora utilizzi parametri di targeting che potrebbero includere l'età, il sesso o il codice postale. Il targeting basato sull'età può essere applicato a un minimo di 21 anni. + Indica se utilizzerai l'account pubblicitario per annunci politici. Se pubblichi un annuncio politico, inserisci l'organizzazione politica o il gruppo di sostegno che lo sponsorizza e che ne sostiene i costi. Se non inserisci l'organizzazione politica in modo corretto, i tuoi annunci potrebbero essere rifiutati. Prima di inviare gli annunci, dovrai inoltre compilare obbligatoriamente il "Modulo di revisione degli annunci politici" collegato. 1. Seleziona **Dettagli account** e inserisci le informazioni relative al tuo account pubblicitario: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/connecting-to-data-snapchat-ads-new-account.html) 1. Seleziona **Crea account**. Il tuo account pubblicitario verrà creato e potrai trovarlo nella sezione Account pubblicitari di Ads Manager. Per iniziare a pubblicare annunci, dovrai inserire un metodo di pagamento. Puoi anche aggiungere dei membri al tuo account pubblicitario. 1. Scegli se preferisci usare un metodo di pagamento esistente o crearne uno nuovo. Quindi, seleziona **Salva metodo di pagamento**. 1. Seleziona tutti i [membri che hai invitato](https://businesshelp.snapchat.com/s/article/manage-members?language=en_US) nella tua attività commerciale e aggiungili all'account pubblicitario. Per maggiori informazioni sui ruoli e sulle autorizzazioni che si possono assegnare, vedi [Panoramica su ruoli e autorizzazioni](https://businesshelp.snapchat.com/s/article/roles-permissions?language=en_US). I membri aggiunti potranno quindi accedere ad Ads Manager e a questo account pubblicitario. Quando hai finito, salva i membri. Per ulteriori informazioni sugli account pubblicitari, consulta [https://businesshelp.snapchat.com/s/article/roles-permissions?language=en_US](https://businesshelp.snapchat.com/s/article/roles-permissions?language=en_US) https://businesshelp.snapchat.com/s/ article/roles-permissions? language=it\$1US # Creazione di un'app nel proprio account Snapchat Ads Per attivare l'accesso all'API di marketing di Snapchat, assicurati di aver configurato un account aziendale. Quindi segui la procedura riportata di seguito. 1. Accedi ad Ads Manager. Quindi seleziona il menu nell'angolo in alto a sinistra e scegli **Business Dashboard**, quindi seleziona **Dettagli aziendali**. 1. Scegli **\$1 OAuth App**. 1. Inserisci il nome dell'app e aggiungi il seguente URL come URI di reindirizzamento Snap: `https://.console.aws.amazon.com/gluestudio/oauth`. Ad esempio, se utilizzi la regione us-west-1, l'URL sarebbe: `https://us-west-1.console.aws.amazon.com/gluestudio/oauth) and choose Create OAuth App`. Scegli **Crea OAuth app**. 1. Verranno visualizzate le credenziali dell'app (ID Client e Segreto client). Salvateli perché saranno necessari per creare una connessione.