

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menghubungkan ke LinkedIn
<a name="connecting-to-linkedin"></a>

LinkedIn adalah alat pemasaran berbayar yang menawarkan akses ke jejaring LinkedIn sosial melalui berbagai posting bersponsor dan metode lainnya. LinkedIn adalah alat pemasaran yang kuat bagi perusahaan B2B untuk membangun prospek, pengakuan online, berbagi konten, dan banyak lagi.

**Topics**
+ [AWS Glue dukungan untuk LinkedIn](linkedin-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](linkedin-configuring-iam-permissions.md)
+ [Mengkonfigurasi LinkedIn](linkedin-configuring.md)
+ [Mengkonfigurasi koneksi LinkedIn](linkedin-configuring-connections.md)
+ [Membaca dari LinkedIn entitas](linkedin-reading-from-entities.md)
+ [LinkedIn opsi koneksi](linkedin-connection-options.md)
+ [Membuat LinkedIn akun](linkedin-create-account.md)
+ [Batasan](linkedin-connector-limitations.md)

# AWS Glue dukungan untuk LinkedIn
<a name="linkedin-support"></a>

AWS Glue mendukung LinkedIn sebagai berikut:

**Didukung sebagai sumber?**  
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari LinkedIn.

**Didukung sebagai target?**  
Tidak.

**Versi LinkedIn API yang didukung**  
**202406 (Juni 2024)**

# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
<a name="linkedin-configuring-iam-permissions"></a>

Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut: 

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

****  

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

------

Jika Anda tidak ingin menggunakan metode sebelumnya, sebagai alternatif, gunakan kebijakan IAM terkelola berikut:
+  [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan. 
+  [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol. 

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

Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari LinkedIn, Anda harus memenuhi persyaratan berikut:

## Persyaratan minimum
<a name="linkedin-configuring-min-requirements"></a>
+ Anda memiliki LinkedIn akun. Untuk informasi selengkapnya tentang membuat akun, lihat [Membuat LinkedIn akun](linkedin-create-account.md). 
+  LinkedIn Akun Anda diaktifkan untuk akses API. 
+ Anda telah membuat `OAuth2 API` integrasi di LinkedIn akun Anda. Integrasi ini menyediakan kredensi klien yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan yang diautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat [Membuat LinkedIn akun](linkedin-create-account.md).

Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke LinkedIn akun Anda. Untuk koneksi biasa, Anda tidak perlu melakukan hal lain LinkedIn.

# Mengkonfigurasi koneksi LinkedIn
<a name="linkedin-configuring-connections"></a>

 LinkedIn mendukung jenis `AUTHORIZATION_CODE` hibah untuk OAuth2. 

Jenis hibah ini dianggap “berkaki tiga” `OAuth` karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Pengguna dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung LinkedIn dan memberikan ID klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue konsol. Dalam skenario ini, mereka masih akan diarahkan ke login dan memberi wewenang LinkedIn AWS Glue untuk mengakses sumber daya mereka. 

Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses kedaluwarsa 60 hari setelah pembuatan. Token akses baru dapat diperoleh dengan menggunakan token penyegaran.

Untuk LinkedIn dokumentasi publik tentang cara membuat aplikasi yang terhubung untuk `Authorization Code OAuth` alur, lihat Alur [Kode Otorisasi (berkaki 3 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).

**Mengkonfigurasi koneksi LinkedIn**

1.  Di AWS Secrets Manager, buat rahasia dengan detail berikut: 
   + Untuk aplikasi terhubung yang dikelola pelanggan — Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai. 
   + Untuk aplikasi terhubung AWS Terkelola — Kosongkan rahasia atau rahasia dengan beberapa nilai sementara.
**catatan**  
Ini adalah suatu keharusan untuk membuat rahasia per koneksi di AWS Glue.

1. Dalam AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini: 

   1. Saat memilih **jenis Koneksi**, pilih **LinkedIn**.

   1. Menyediakan LinkedIn lingkungan.

   1. Pilih peran IAM yang AWS Glue dapat diasumsikan dan memiliki izin untuk tindakan berikut: 

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

****  

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

------

   1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token. 

   1. Pilih **opsi Jaringan** jika Anda ingin menggunakan jaringan Anda. 

1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`. 

# Membaca dari LinkedIn entitas
<a name="linkedin-reading-from-entities"></a>

**Prasyarat** 

 LinkedIn Objek yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia. 

 **Entitas yang didukung** 


| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih \$1 | Mendukung Partisi | 
| --- | --- | --- | --- | --- | --- | 
| Akun Iklan | Ya | Ya | Ya | Ya | Tidak | 
| Kampanye | Ya | Ya | Ya | Ya | Tidak | 
| Grup Kampanye | Ya | Ya | Ya | Ya | Tidak | 
| Materi Iklan | Ya | Ya | Ya | Ya | Tidak | 
| Analisis Iklan | Ya | Tidak | Tidak | Ya | Tidak | 
| Analisis Iklan Semua AdAcocunts | Ya | Tidak | Tidak | Ya | Tidak | 
| Analisis Iklan Semua Kampanye | Ya | Tidak | Tidak | Ya | Tidak | 
| Analisis Iklan Semua CampaignGroups | Ya | Tidak | Tidak | Ya | Tidak | 
| Analisis Iklan Semua AdCreatives | Ya | Tidak | Tidak | Ya | Tidak | 
| Bagikan Statistik | Ya | Tidak | Tidak | Ya | Tidak | 
| Statistik Halaman | Ya | Tidak | Tidak | Ya | Tidak | 
| Statistik Pengikut | Ya | Tidak | Tidak | Ya | Tidak | 

 **Contoh** 

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


**LinkedIn detail entitas dan bidang**  

|  **Tipe Data Bidang**  |  **Operator Filter yang Didukung**  | 
| --- | --- | 
|  String  |  =  | 
|  DateTime  |  ANTARA, =  | 
|  Numerik  |  =  | 
|  Boolean  |  =  | 

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

Berikut ini adalah opsi koneksi untuk LinkedIn:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Objek Anda di LinkedIn. Misalnya, AdAccounts. 
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. LinkedIn Rest versi API yang ingin Anda gunakan. Nilainya akan menjadi 202406, karena LinkedIn saat ini hanya mendukung versi 202406.
+ `SELECTED_FIELDS`(Daftar<String>) — Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk entitas yang dipilih. 
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL. 
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh. 

# Membuat LinkedIn akun
<a name="linkedin-create-account"></a>

**Membuat LinkedIn Aplikasi dan OAuth kredensialnya**

1. Arahkan ke halaman **Jaringan LinkedIn Pengembang** Anda dan masuk dengan kredensi LinkedIn akun Anda. 

1. Arahkan ke halaman **Aplikasi Saya** dan pilih **Buat Aplikasi** untuk membuat LinkedIn Aplikasi baru.

1. Masukkan detail berikut ke dalam formulir pendaftaran aplikasi:
   + **Nama Perusahaan** — Pilih perusahaan yang sudah ada atau buat perusahaan baru.
   + **Nama** — Masukkan nama aplikasi.
   + **Deskripsi** — Masukkan deskripsi aplikasi.
   + **Logo Aplikasi** - Pilih file gambar sebagai logo aplikasi Anda.
   + **Penggunaan Aplikasi** — Pilih penggunaan aplikasi Anda.
   + **URL situs web** — Masukkan URL websiute yang berisi informasi rinci tentang aplikasi Anda.
   + **Email Bisnis** — Masukkan alamat email bisnis Anda.
   + **Telepon Bisnis** — Masukkan nomor telepon bisnis Anda.
   + **LinkedIn Ketentuan Penggunaan API** — Baca dan setujui.

1. Setelah mengisi formulir pendaftaran aplikasi, pilih **Kirim**.

   Anda akan diarahkan ke halaman **Otentikasi**, di mana Kunci Otentikasi (ID Klien dan Rahasia Klien) dan detail relevan lainnya akan ditampilkan.

1. Jika aplikasi web Anda memerlukan akses ke alamat email pengguna dari LinkedIn akun mereka, pilih `r_emailaddress` izin. Selain itu, Anda dapat menentukan Authorized Redirect URLs untuk LinkedIn aplikasi Anda. 

**Membuat halaman di LinkedIn akun**

1. Arahkan ke [Produk LinkedIn Pengembang](https://developer.linkedin.com/).

1. **Di sudut kanan atas halaman **Produk LinkedIn Pengembang**, pilih Aplikasi saya.**

1. **Di sudut kanan atas halaman **Aplikasi saya, pilih Buat aplikasi**.**

1. Pada halaman **Buat aplikasi**, masukkan nama aplikasi Anda di bidang **Nama aplikasi**.

1. Di bidang **LinkedIn Halaman**, masukkan nama atau URL halaman perusahaan Anda.
**catatan**  
Jika Anda tidak memiliki LinkedIn Halaman, Anda dapat membuatnya dengan memilih **Buat yang baru LinkedIn**. 

1. Di bidang **URL kebijakan privasi**, masukkan URL kebijakan privasi Anda.

1. Pilih **Unggah logo** untuk mengunggah gambar yang akan ditampilkan kepada pengguna saat mereka mengotorisasi dengan aplikasi Anda.

1. Di bagian **Perjanjian hukum**, pilih **Saya telah membaca dan menyetujui persyaratan ini**.

1. Pilih **Buat aplikasi**. 

   Aplikasi baru Anda akan dibuat dan akan tersedia di bawah tab **Aplikasi saya**.

**Menerbitkan iklan kampanye di LinkedIn**

1. Masuk ke **Manajer Kampanye**. 

1. Pilih **Grup Kampanye** yang ada, atau pilih **Buat** untuk membuat yang baru.

1. Pilih tujuan Anda.

1. Pilih grup, anggaran, dan jadwal Anda.

1. Bangun audiens target Anda.

1. Pilih format iklan Anda.

1. Pilih anggaran dan jadwal Anda.

1. Siapkan iklan Anda.

1. Tinjau dan Luncurkan.

# Batasan
<a name="linkedin-connector-limitations"></a>

Untuk bidang Analytics `ad_analytics_all_adAccounts` `ad_analytics_all_campaigns``ad_analytics_all_campaign_groups`,,, dan `ad_analytics_all_adCreatives` filter wajib untuk mengambil catatan.