Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à LinkedIn
LinkedIn est un outil de marketing payant qui permet d'accéder aux réseaux LinkedIn sociaux par le biais de diverses publications sponsorisées et d'autres méthodes. LinkedIn est un puissant outil marketing permettant aux entreprises B2B de créer des prospects, de se faire reconnaître en ligne, de partager du contenu, etc.
**Topics**
+ [AWS Glue support pour LinkedIn](linkedin-support.md)
+ [Politiques contenant les opérations API pour la création et l’utilisation des connexions](linkedin-configuring-iam-permissions.md)
+ [Configuration LinkedIn](linkedin-configuring.md)
+ [Configuration des LinkedIn connexions](linkedin-configuring-connections.md)
+ [Lecture à partir d' LinkedIn entités](linkedin-reading-from-entities.md)
+ [LinkedIn options de connexion](linkedin-connection-options.md)
+ [Création d'un LinkedIn compte](linkedin-create-account.md)
+ [Limitations](linkedin-connector-limitations.md)
# AWS Glue support pour LinkedIn
AWS Glue prend en charge LinkedIn les éléments suivants :
**Prise en charge en tant que source ?**
Oui. Vous pouvez utiliser des tâches AWS Glue ETL pour interroger des données à partir de LinkedIn.
**Prise en charge en tant que cible ?**
Non.
**Versions LinkedIn d'API prises en charge**
**202406 (Juin 2024)**
# Politiques contenant les opérations API pour la création et l’utilisation des connexions
L'exemple de politique suivant décrit les AWS autorisations requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes :
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console.
# Configuration LinkedIn
Avant de pouvoir AWS Glue utiliser le transfert depuis LinkedIn, vous devez satisfaire aux exigences suivantes :
## Configuration requise
+ Tu as un LinkedIn compte. Pour plus d'informations sur la création d'un compte, consultez la section [Création d'un LinkedIn compte](linkedin-create-account.md).
+ Votre LinkedIn compte est activé pour accéder à l'API.
+ Vous avez créé une `OAuth2 API` intégration dans votre LinkedIn compte. Cette intégration fournit les informations d'identification du client qui AWS Glue permettent d'accéder à vos données en toute sécurité lorsqu'il effectue des appels authentifiés vers votre compte. Pour de plus amples informations, veuillez consulter [Création d'un LinkedIn compte](linkedin-create-account.md).
Si vous remplissez ces conditions, vous êtes prêt à vous connecter AWS Glue à votre LinkedIn compte. Pour les connexions classiques, vous n'avez rien d'autre à faire dans LinkedIn.
# Configuration des LinkedIn connexions
LinkedIn prend en charge le type de `AUTHORIZATION_CODE` subvention pour OAuth2.
Ce type d’autorisation est considéré comme `OAuth` tridimensionnel, car il repose sur la redirection des utilisateurs vers le serveur d’autorisation tiers pour authentifier l’utilisateur. Les utilisateurs peuvent choisir de créer leur propre application connectée LinkedIn et de fournir leur propre identifiant client et leur propre secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés LinkedIn vers pour se connecter et autoriser AWS Glue l'accès à leurs ressources.
Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès expire 60 jours après sa création. Un nouveau jeton d’accès peut être obtenu à l’aide du jeton d’actualisation.
Pour consulter LinkedIn la documentation publique sur la création d'une application connectée pour `Authorization Code OAuth` Flow, consultez [Authorization Code Flow (à 3 étapes). OAuth](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)
**Configuration d'une LinkedIn connexion**
1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes :
+ Pour l’application connectée gérée par le client : le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé.
+ Pour l'application connectée AWS gérée : secret vide ou secret avec une valeur temporaire.
**Note**
Il est indispensable de créer un secret par connexion dans AWS Glue.
1. Dans le AWS Glue Studio, créez une connexion sous **Connexions de données** en suivant les étapes ci-dessous :
1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez **LinkedIn**.
1. Fournissez l' LinkedIn environnement.
1. Sélectionnez le rôle IAM pour lequel AWS Glue vous pouvez assumer et qui dispose des autorisations nécessaires pour effectuer les actions suivantes :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons.
1. Sélectionnez les **options réseau** si vous souhaitez utiliser votre réseau.
1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`.
# Lecture à partir d' LinkedIn entités
**Conditions préalables**
Un LinkedIn objet que vous aimeriez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles.
**Entités prises en charge**
| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- |
| Ad Accounts | Oui | Oui | Oui | Oui | Non |
| Campagnes | Oui | Oui | Oui | Oui | Non |
| Campaign Groups | Oui | Oui | Oui | Oui | Non |
| Creatives | Oui | Oui | Oui | Oui | Non |
| Ad Analytics | Oui | Non | Non | Oui | Non |
| Toutes les analyses publicitaires AdAcocunts | Oui | Non | Non | Oui | Non |
| Ad Analytics All Campaigns | Oui | Non | Non | Oui | Non |
| Toutes les analyses publicitaires CampaignGroups | Oui | Non | Non | Oui | Non |
| Toutes les analyses publicitaires AdCreatives | Oui | Non | Non | Oui | Non |
| Share Statistics | Oui | Non | Non | Oui | Non |
| Page Statistics | Oui | Non | Non | Oui | Non |
| Follower Statistics | Oui | Non | Non | Oui | Non |
**Exemple**
```
netsuiteerp_read = glueContext.create_dynamic_frame.from_options(
connection_type="linkedin",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "adaccounts",
"API_VERSION": "202406"
}
)
```
**LinkedIn détails de l'entité et du champ**
| **Type de données de champs** | **Opérateurs de filtre pris en charge** |
| --- | --- |
| String | = |
| DateTime | BETWEEN, = |
| Numérique | = |
| Booléen | = |
# LinkedIn options de connexion
Les options de connexion suivantes sont disponibles pour LinkedIn :
+ `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Le nom de votre objet dans LinkedIn. Par exemple, adAccounts.
+ `API_VERSION`(Chaîne) — (Obligatoire) Utilisé pour la lecture/écriture. LinkedIn Version de l'API Rest que vous souhaitez utiliser. La valeur sera 202406, car seule la version 202406 LinkedIn est actuellement prise en charge.
+ `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’entité sélectionnée.
+ `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark.
+ `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète.
# Création d'un LinkedIn compte
**Création d'une LinkedIn application et d' OAuth informations d'identification**
1. Accédez à la page de votre **réseau de LinkedIn développeurs** et connectez-vous à l'aide des informations d'identification de votre LinkedIn compte.
1. Accédez à la page **Mes applications** et choisissez **Créer une application** pour créer une nouvelle LinkedIn application.
1. Saisissez les informations suivantes dans le formulaire d’inscription à l’application :
+ **Nom de l’entreprise** : sélectionnez une entreprise existante ou créez-en une.
+ **Nom** : saisissez le nom de l’application.
+ **Description** : saisissez la description de l’application.
+ **Logo de l’application** : sélectionnez un fichier image comme logo de votre application.
+ **Utilisation de l’application** : sélectionnez l’utilisation de votre application.
+ **URL du site Web** : saisissez l’URL du site Web qui contient des informations détaillées sur votre application.
+ **Adresse e-mail professionnelle** : saisissez votre adresse e-mail professionnelle.
+ **Numéro de téléphone professionnel** : saisissez votre numéro de téléphone professionnel.
+ **LinkedIn Conditions d'utilisation de l'API** — Lisez et acceptez.
1. Après avoir rempli le formulaire d’inscription à l’application, choisissez **Soumettre**.
Vous serez redirigé vers la page **Authentification**, où les clés d’authentification (ID client et secret client) et d’autres informations pertinentes seront affichées.
1. Si votre application Web nécessite l'accès à l'adresse e-mail de l'utilisateur depuis son LinkedIn compte, sélectionnez l'`r_emailaddress`autorisation. En outre, vous pouvez spécifier la redirection autorisée URLs pour votre LinkedIn application.
**Création d'une page dans le LinkedIn compte**
1. Accédez aux [produits pour LinkedIn développeurs](https://developer.linkedin.com/).
1. Dans le coin supérieur droit de la page **Produits pour LinkedIn développeurs**, sélectionnez **Mes** applications.
1. Dans le coin supérieur droit de la page **Mes applications**, sélectionnez **Créer une application**.
1. Sur la page **Créer une application**, dans le champ **Nom de l’application**, saisissez un nom pour votre application.
1. Dans le champ **LinkedIn Page**, saisissez le nom ou l'URL de la page de votre entreprise.
**Note**
Si vous n'avez pas de LinkedIn page, vous pouvez en créer une en sélectionnant **Créer une nouvelle LinkedIn**.
1. Dans le champ **URL de la politique de confidentialité**, saisissez l’URL de votre politique de confidentialité.
1. Choisissez **Charger un logo** pour charger une image à afficher aux utilisateurs lorsqu’ils se connectent à votre application.
1. Dans la section **Accord juridique**, sélectionnez **J’ai lu et j’accepte les présentes conditions**.
1. Sélectionnez **Créer une application**.
Votre application sera créée et sera disponible sous l’onglet **Mes applications**.
**Publier des annonces de campagne dans LinkedIn**
1. Connectez-vous à **Gestionnaire de campagnes**.
1. Sélectionnez un **groupe de campagnes** existant ou choisissez **Créer** pour en créer un.
1. Sélectionnez votre objectif.
1. Sélectionnez votre groupe, votre budget et votre calendrier.
1. Développez votre public cible.
1. Sélectionnez le format de votre annonce.
1. Sélectionnez votre budget et votre calendrier.
1. Configurez vos annonces.
1. Procédez à la vérification et au lancement.
# Limitations
Pour les champs Analytique `ad_analytics_all_adAccounts`, `ad_analytics_all_campaigns`, `ad_analytics_all_campaign_groups` et `ad_analytics_all_adCreatives`, un filtre est obligatoire pour récupérer les enregistrements.