

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verbindung herstellen zu LinkedIn
<a name="connecting-to-linkedin"></a>

LinkedIn ist ein kostenpflichtiges Marketinginstrument, das über verschiedene gesponserte Beiträge und andere Methoden Zugang zu LinkedIn sozialen Netzwerken bietet. LinkedIn ist ein leistungsstarkes Marketinginstrument für B2B-Unternehmen, um Leads zu generieren, Online-Bekanntheit zu erlangen, Inhalte zu teilen und vieles mehr.

**Topics**
+ [AWS Glue Unterstützung für LinkedIn](linkedin-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](linkedin-configuring-iam-permissions.md)
+ [Konfiguration LinkedIn](linkedin-configuring.md)
+ [LinkedIn Verbindungen konfigurieren](linkedin-configuring-connections.md)
+ [Aus LinkedIn Entitäten lesen](linkedin-reading-from-entities.md)
+ [LinkedIn Verbindungsoptionen](linkedin-connection-options.md)
+ [Ein LinkedIn Konto erstellen](linkedin-create-account.md)
+ [Einschränkungen](linkedin-connector-limitations.md)

# AWS Glue Unterstützung für LinkedIn
<a name="linkedin-support"></a>

AWS Glue unterstützt LinkedIn wie folgt:

**Als Quelle unterstützt?**  
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten von abzufragen LinkedIn.

**Als Ziel unterstützt?**  
Nein.

**Unterstützte LinkedIn API-Versionen**  
** 202.406 (Juni 2024) **

# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
<a name="linkedin-configuring-iam-permissions"></a>

Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält: 

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "glue:ListConnectionTypes",
        "glue:DescribeConnectionType",
        "glue:RefreshOAuth2Tokens",
        "glue:ListEntities",
        "glue:DescribeEntity"
      ],
      "Resource": "*"
    }
  ]
}
```

------

Wenn Sie die vorstehende Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+  [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden. 
+  [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, an die die Richtlinie angehängt ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird in der Regel Benutzern der AWS Glue Konsole zugewiesen. 

# Konfiguration LinkedIn
<a name="linkedin-configuring"></a>

Bevor Sie das Programm AWS Glue für die Übertragung von verwenden können LinkedIn, müssen Sie die folgenden Voraussetzungen erfüllen:

## Mindestanforderungen
<a name="linkedin-configuring-min-requirements"></a>
+ Sie haben ein LinkedIn Konto. Weitere Informationen zum Erstellen eines Kontos finden Sie unter [ LinkedInKonto erstellen](linkedin-create-account.md). 
+ Ihr LinkedIn Konto ist für den API-Zugriff aktiviert. 
+ Sie haben eine `OAuth2 API` Integration in Ihrem LinkedIn Konto erstellt. Diese Integration stellt die Kundenanmeldedaten bereit, die für den sicheren Zugriff auf Ihre Daten AWS Glue verwendet werden, wenn authentifizierte Anrufe an Ihr Konto getätigt werden. Weitere Informationen finden Sie unter [Ein LinkedIn Konto erstellen](linkedin-create-account.md).

Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem LinkedIn Konto herstellen. Für typische Verbindungen müssen Sie nichts weiter tun LinkedIn.

# LinkedIn Verbindungen konfigurieren
<a name="linkedin-configuring-connections"></a>

 LinkedIn unterstützt den `AUTHORIZATION_CODE` Zuschusstyp für OAuth2. 

Dieser Gewährungstyp wird als „dreibeiniges“ `OAuth` betrachtet, da er darauf angewiesen ist, dass Benutzer zur Authentifizierung an den Autorisierungsserver eines Drittanbieters weitergeleitet werden. Benutzer können sich dafür entscheiden, ihre eigene verbundene App in zu erstellen LinkedIn und ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben, wenn sie Verbindungen über die AWS Glue Konsole herstellen. In diesem Szenario werden sie weiterhin weitergeleitet, LinkedIn um sich anzumelden und den Zugriff auf ihre Ressourcen AWS Glue zu autorisieren. 

Dieser Gewährungstyp führt zu einem Aktualisierungstoken sowie einem Zugriffstoken. Das Zugriffstoken läuft 60 Tage nach seiner Erstellung ab. Ein neues Zugriffstoken kann mit dem Aktualisierungstoken bezogen werden.

Öffentliche LinkedIn Dokumentation zur Erstellung einer verbundenen App für `Authorization Code OAuth` Flow finden Sie unter [Authorization Code Flow ( OAuth3-beinig](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)).

**Eine Verbindung konfigurieren LinkedIn**

1.  Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details: 
   + Für kundenseitig verwaltete verbundene App – Geheimnis muss das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten. 
   + Für AWS verwaltete verbundene Apps — Leeres Geheimnis oder Geheimnis mit einem temporären Wert.
**Anmerkung**  
Sie müssen für jede Verbindung in AWS Glue ein Geheimnis erstellen.

1. Stellen Sie im unter **Datenverbindungen** eine Verbindung her AWS Glue Studio, indem Sie die folgenden Schritte ausführen: 

   1. Wählen Sie bei der Auswahl eines **Verbindungstyps **LinkedIn****.

   1. Stellen Sie die LinkedIn Umgebung bereit.

   1. Wählen Sie die IAM-Rolle aus, für die AWS Glue Sie die folgenden Aktionen übernehmen können und über Berechtigungen verfügen: 

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "secretsmanager:DescribeSecret",
              "secretsmanager:GetSecretValue",
              "secretsmanager:PutSecretValue",
              "ec2:CreateNetworkInterface",
              "ec2:DescribeNetworkInterfaces",
              "ec2:DeleteNetworkInterface"
            ],
            "Resource": "*"
          }
        ]
      }
      ```

------

   1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten. 

   1. Wählen Sie die **Netzwerkoptionen** aus, wenn Sie Ihr Netzwerk verwenden möchten. 

1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte. 

# Aus LinkedIn Entitäten lesen
<a name="linkedin-reading-from-entities"></a>

**Voraussetzungen** 

Ein LinkedIn Objekt, aus dem Sie lesen möchten. In der folgenden Tabelle mit unterstützten Entitäten können Sie die verfügbaren Entitäten überprüfen. 

 **Unterstützte Entitäten** 


| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | 
| --- | --- | --- | --- | --- | --- | 
| Anzeigenkonto | Ja | Ja | Ja | Ja | Nein | 
| Kampagnen | Ja | Ja | Ja | Ja | Nein | 
| Kampagnengruppen | Ja | Ja | Ja | Ja | Nein | 
| Creatives | Ja | Ja | Ja | Ja | Nein | 
| Anzeigenanalytik | Ja | Nein | Nein | Ja | Nein | 
| Ad Analytics Alle AdAcocunts | Ja | Nein | Nein | Ja | Nein | 
| Anzeigenanalytik Alle Kampagnen | Ja | Nein | Nein | Ja | Nein | 
| Ad Analytics Alle CampaignGroups | Ja | Nein | Nein | Ja | Nein | 
| Ad Analytics Alle AdCreatives | Ja | Nein | Nein | Ja | Nein | 
| Statistiken teilen | Ja | Nein | Nein | Ja | Nein | 
| Seitenstatistiken | Ja | Nein | Nein | Ja | Nein | 
| Follower-Statistiken | Ja | Nein | Nein | Ja | Nein | 

 **Beispiel** 

```
netsuiteerp_read = glueContext.create_dynamic_frame.from_options(
    connection_type="linkedin",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "adaccounts",
        "API_VERSION": "202406"
    }
)
```


**LinkedIn Entitäts- und Felddetails**  

|  **Felddatentyp**  |  **Unterstützte Filteroperatoren**  | 
| --- | --- | 
|  Zeichenfolge  |  =  | 
|  DateTime  |  BETWEEN, =  | 
|  Numerischer Wert  |  =  | 
|  Boolesch  |  =  | 

# LinkedIn Verbindungsoptionen
<a name="linkedin-connection-options"></a>

Im Folgenden finden Sie Verbindungsoptionen für LinkedIn:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Der Name Ihres Objekts in LinkedIn. Beispiel: adAccounts. 
+ `API_VERSION`(String) — (Erforderlich) Wird zum Lesen/Schreiben verwendet. LinkedIn Rest-API-Version, die Sie verwenden möchten. Der Wert wird 202406 sein, da LinkedIn derzeit nur Version 202406 unterstützt wird.
+ `SELECTED_FIELDS`(Liste<Zeichenfolge>) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für die ausgewählte Entität auswählen möchten. 
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen. 
+ `QUERY`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage. 

# Ein LinkedIn Konto erstellen
<a name="linkedin-create-account"></a>

**Eine LinkedIn App und OAuth Anmeldeinformationen erstellen**

1. Navigieren Sie zu Ihrer **LinkedIn Developer Network-Seite** und melden Sie sich mit Ihren LinkedIn Kontoanmeldeinformationen an. 

1. Navigieren Sie zur Seite **„Meine Apps**“ und wählen Sie „**Anwendung erstellen**“, um eine neue LinkedIn App zu erstellen.

1. Geben Sie die folgenden Details in das App-Registrierungsformular ein:
   + **Firmenname**: Wählen Sie ein bestehendes Unternehmen aus oder erstellen Sie ein neues Unternehmen.
   + **Name**: Geben Sie den Namen der Anwendung ein.
   + **Beschreibung**: Geben Sie die Beschreibung der Anwendung ein.
   + **Anwendungslogo**: Wählen Sie eine Bilddatei als Ihr Anwendungslogo aus.
   + **Anwendungszweck**: Wählen Sie den Anwendungszweck aus.
   + **Website-URL**: Geben Sie die URL der Website ein, die detaillierte Informationen zur Anwendung enthält.
   + **Geschäftliche E-Mail-Adresse**: Geben Sie Ihre geschäftliche E-Mail-Adresse ein.
   + **Geschäftliche Telefonnummer**: Geben Sie Ihre geschäftliche Telefonnummer ein.
   + **LinkedIn API-Nutzungsbedingungen** — Lesen Sie und stimmen Sie zu.

1. Gehen Sie nach dem Ausfüllen des App-Registrierungsformulars auf **Senden**.

   Sie werden zur **Authentifizierungsseite** weitergeleitet, auf der die Authentifizierungsschlüssel (Client-ID und geheimer Client-Schlüssel) sowie andere relevante Details angezeigt werden.

1. Wenn Ihre Webanwendung Zugriff auf die E-Mail-Adresse des Benutzers von seinem LinkedIn Konto aus benötigt, wählen Sie die `r_emailaddress` entsprechende Berechtigung aus. Darüber hinaus können Sie eine autorisierte Weiterleitung URLs für Ihre LinkedIn Anwendung angeben. 

**Eine Seite im LinkedIn Konto erstellen**

1. Navigieren Sie zu [LinkedIn Developer Products](https://developer.linkedin.com/).

1. Wählen Sie in der oberen rechten Ecke der Seite mit den **LinkedIn Entwicklerprodukten** die Option **Meine** Apps aus.

1. Wählen oben rechts auf der Seite **Meine Apps** die Option **App erstellen** aus.

1. Geben Sie auf der Seite **App erstellen** im Feld **Name** einen Namen für Ihre Anwendung ein.

1. Geben Sie im Feld **LinkedIn Seite** den Namen oder die URL Ihrer Unternehmensseite ein.
**Anmerkung**  
Wenn Sie noch keine LinkedIn Seite haben, können Sie eine erstellen, indem Sie **Neue erstellen** auswählen LinkedIn. 

1. Geben Sie im Feld **Datenschutzrichtlinien-URL** die Datenschutzrichtlinie-URL ein.

1. Wählen Sie **Logo hochladen**, um ein Bild hochzuladen, das Benutzern angezeigt werden soll, wenn sie sich mit Ihrer App autorisieren.

1. Wählen Sie im Abschnitt **Rechtliche Vereinbarung** die Option **Ich habe diese Bedingungen gelesen und stimme ihnen zu**.

1. Wählen Sie **App erstellen**. 

   Ihre neue App wird erstellt und ist unter dem Tab **Meine Apps** verfügbar.

**Veröffentlichung von Kampagnenanzeigen in LinkedIn**

1. Melden Sie sich beim **Kampagnenmanager** an. 

1. Wählen Sie eine vorhandene **Kampagnengruppe** aus oder klicken Sie auf **Erstellen**.

1. Wählen Sie Ihr Ziel aus.

1. Wählen Sie Ihre Gruppe, Ihr Budget und Ihren Zeitplan aus.

1. Bauen Sie Ihre Zielgruppe auf.

1. Wählen Sie Ihr Anzeigenformat aus.

1. Wählen Sie Ihr Budget und Ihren Zeitplan aus.

1. Richten Sie Ihre Anzeige(n) ein.

1. Überprüfen Sie alles und starten Sie.

# Einschränkungen
<a name="linkedin-connector-limitations"></a>

Für die Analytikfelder `ad_analytics_all_adAccounts`, `ad_analytics_all_campaigns`, `ad_analytics_all_campaign_groups`, und `ad_analytics_all_adCreatives` ist ein Filter erforderlich, um die Datensätze abzurufen.