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 LinkedIn
LinkedIn è uno strumento di marketing a pagamento che offre l'accesso ai LinkedIn social network attraverso vari post sponsorizzati e altri metodi. LinkedIn è un potente strumento di marketing per le aziende B2B per creare lead, riconoscere online, condividere contenuti e altro ancora.
**Topics**
+ [AWS Glue supporto per LinkedIn](linkedin-support.md)
+ [Policy contenenti le operazioni API per creare e utilizzare le connessioni](linkedin-configuring-iam-permissions.md)
+ [Configurazione LinkedIn](linkedin-configuring.md)
+ [Configurazione delle connessioni LinkedIn](linkedin-configuring-connections.md)
+ [Lettura da LinkedIn entità](linkedin-reading-from-entities.md)
+ [LinkedIn opzioni di connessione](linkedin-connection-options.md)
+ [Creare un LinkedIn account](linkedin-create-account.md)
+ [Limitazioni](linkedin-connector-limitations.md)
# AWS Glue supporto per LinkedIn
AWS Glue supporta LinkedIn quanto segue:
**Supportato come origine?**
Sì. È possibile utilizzare i job AWS Glue ETL da LinkedIn cui interrogare i dati.
**Supportato come destinazione?**
No.
**Versioni LinkedIn API supportate**
** 202406 (giugno 2024) **
# 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 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 LinkedIn
Prima di poter utilizzare AWS Glue per il trasferimento da LinkedIn, è necessario soddisfare i seguenti requisiti:
## Requisiti minimi
+ Hai un LinkedIn account. Per ulteriori informazioni sulla creazione di un account, consulta [Creazione di un LinkedIn account](linkedin-create-account.md).
+ Il tuo LinkedIn account è abilitato all'accesso tramite API.
+ Hai creato un'`OAuth2 API`integrazione nel tuo LinkedIn account. Questa integrazione fornisce le credenziali del client che AWS Glue utilizza per accedere ai dati in modo sicuro quando effettua chiamate autenticate al vostro account. Per ulteriori informazioni, consulta [Creare un LinkedIn account](linkedin-create-account.md).
Se soddisfi questi requisiti, sei pronto per AWS Glue connetterti al tuo account. LinkedIn Per le connessioni tipiche, non è necessario fare nient'altro LinkedIn.
# Configurazione delle connessioni LinkedIn
LinkedIn supporta il tipo di `AUTHORIZATION_CODE` concessione 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 LinkedIn 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 al login e LinkedIn all'autorizzazione ad accedere AWS Glue alle proprie risorse.
Questo tipo di concessione genera sia un token di aggiornamento che un token di accesso. Il token di accesso scade 60 giorni dopo la creazione. È possibile ottenere un nuovo token di accesso utilizzando il token di aggiornamento.
Per la LinkedIn documentazione pubblica sulla creazione di un'app connessa per `Authorization Code OAuth` flow, consulta [Authorization Code Flow ( OAuth3-legged](https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow?toc=%2Flinkedin%2Fmarketing%2Ftoc.json&bc=%2Flinkedin%2Fbreadcrumb%2Ftoc.json&view=li-lms-2024-07&tabs=HTTPS1)).
**Configurazione di una connessione LinkedIn**
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.
+ Per l'app AWS connessa gestita: segreto o segreto vuoto con un valore temporaneo.
**Nota**
È necessario creare un segreto per ogni connessione in AWS Glue.
1. Nel AWS Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti:
1. Quando si seleziona un **tipo di connessione**, selezionare **LinkedIn**.
1. Fornisci l' LinkedIn ambiente.
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. Seleziona le **opzioni di rete** se desideri utilizzare la tua rete.
1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro.
# Lettura da LinkedIn entità
**Prerequisiti**
Un LinkedIn oggetto da cui vorresti 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 |
| --- | --- | --- | --- | --- | --- |
| Account pubblicitari | Sì | Sì | Sì | Sì | No |
| Campagne | Sì | Sì | Sì | Sì | No |
| Gruppi di campagne | Sì | Sì | Sì | Sì | No |
| Creativi | Sì | Sì | Sì | Sì | No |
| Analisi degli annunci | Sì | No | No | Sì | No |
| Ad Analytics All AdAcocunts | Sì | No | No | Sì | No |
| Analisi degli annunci (tutte le campagne) | Sì | No | No | Sì | No |
| Ad Analytics Tutti CampaignGroups | Sì | No | No | Sì | No |
| Ad Analytics Tutti AdCreatives | Sì | No | No | Sì | No |
| Condividi statistiche | Sì | No | No | Sì | No |
| Pagina delle statistiche | Sì | No | No | Sì | No |
| Statistiche dei follower | Sì | No | No | Sì | No |
**Esempio**
```
netsuiteerp_read = glueContext.create_dynamic_frame.from_options(
connection_type="linkedin",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "adaccounts",
"API_VERSION": "202406"
}
)
```
**LinkedIn dettagli sull'entità e sul campo**
| **Tipo di dati dei campi** | **Operatori di filtro supportati** |
| --- | --- |
| Stringa | = |
| DateTime | BETWEEN, = |
| Numerico | = |
| Booleano | = |
# LinkedIn opzioni di connessione
Di seguito sono elencate le opzioni di connessione per LinkedIn:
+ `ENTITY_NAME` (stringa): (obbligatorio) utilizzato per lettura/scrittura. Il nome del tuo oggetto in LinkedIn. Ad esempio, adAccounts.
+ `API_VERSION`(String) — (Obbligatorio) Utilizzato per la lettura/scrittura. LinkedIn Versione dell'API Rest che desideri utilizzare. Il valore sarà 202406, poiché LinkedIn attualmente supporta solo la versione 202406.
+ `SELECTED_FIELDS` (List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne 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.
# Creare un LinkedIn account
**Creazione di un' LinkedIn app e OAuth credenziali**
1. Vai alla pagina **LinkedIn Developer Network** e accedi con le credenziali del tuo LinkedIn account.
1. Vai alla pagina Le **mie app** e scegli **Crea applicazione** per creare una nuova LinkedIn app.
1. Inserisci i seguenti dettagli nel modulo di registrazione dell'app:
+ **Nome dell'azienda**: seleziona un'azienda esistente o creane una nuova.
+ **Nome**: inserisci il nome dell'applicazione.
+ **Descrizione**: inserisci la descrizione dell'applicazione.
+ **Logo dell'applicazione**: seleziona un file immagine come logo dell'applicazione.
+ **Uso dell'applicazione**: seleziona l'uso dell'applicazione.
+ **URL del sito Web**: inserisci l'URL del sito Web che contiene informazioni dettagliate sull'applicazione.
+ **E-mail aziendale**: inserisci il tuo indirizzo e-mail aziendale.
+ **Telefono aziendale**: inserisci il numero di telefono aziendale.
+ **LinkedIn Termini di utilizzo dell'API**: leggi e accetta.
1. Dopo aver completato il modulo di registrazione dell'app, scegli **Invia**.
Verrai reindirizzato alla pagina di **autenticazione**, dove verranno visualizzate le chiavi di autenticazione (ID client e segreto client) e altri dettagli pertinenti.
1. Se la tua applicazione web richiede l'accesso all'indirizzo e-mail dell'utente dal suo LinkedIn account, seleziona l'`r_emailaddress`autorizzazione. Inoltre, puoi specificare il reindirizzamento autorizzato URLs per la tua LinkedIn applicazione.
**Creazione di una pagina nell'account LinkedIn**
1. Vai a [Prodotti per LinkedIn sviluppatori](https://developer.linkedin.com/).
1. **Nell'angolo in alto a destra della pagina **Prodotti per LinkedIn sviluppatori**, seleziona Le mie app.**
1. Nell'angolo in alto a destra della pagina **Le mie app**, seleziona **Crea app**.
1. Nella pagina **Crea un'app** immetti il nome dell'app nel campo **Nome**.
1. Nel campo **LinkedIn Pagina**, inserisci il nome o l'URL della pagina aziendale.
**Nota**
Se non hai una LinkedIn pagina, puoi crearne una selezionando **Crea una nuova LinkedIn**.
1. Nel campo **URL dell'informativa sulla privacy**, inserisci l'URL dell'Informativa sulla privacy.
1. Scegli **Carica un logo** per caricare un'immagine da mostrare agli utenti quando effettuano l'autorizzazione con la tua app.
1. Nella sezione **Accordo legale**, seleziona **Ho letto e accetto questi termini**.
1. Scegli **Crea app**.
La tua nuova app verrà creata e sarà disponibile nella scheda **Le mie app**.
**Pubblicazione di annunci relativi alla campagna in LinkedIn**
1. Accedi a **Gestione della campagna**.
1. Seleziona un **Gruppo campagna** esistente oppure scegli **Crea** per crearne uno nuovo.
1. Seleziona il tuo obiettivo.
1. Seleziona il gruppo, il budget e il programma.
1. Costruisci il tuo pubblico di riferimento.
1. Seleziona il formato dell'annuncio.
1. Seleziona il budget e il programma.
1. Configura i tuoi annunci.
1. Rivedi e avvia.
# Limitazioni
Per i campi di analisi `ad_analytics_all_adAccounts`, `ad_analytics_all_campaigns`, `ad_analytics_all_campaign_groups` e `ad_analytics_all_adCreatives` è obbligatorio un filtro per recuperare i record.