Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Iklan Snapchat di AWS Glue Studio
Snapchat adalah aplikasi dan layanan pesan instan multimedia yang dikembangkan oleh Snap Inc., awalnya Snapchat Inc. Salah satu fitur utama Snapchat adalah bahwa gambar dan pesan biasanya hanya tersedia untuk waktu yang singkat sebelum mereka menjadi tidak dapat diakses oleh penerima mereka. Pemasaran Snapchat adalah posting yang dapat dibayar bisnis untuk melayani pengguna Snapchat.
**Topics**
+ [AWS Glue dukungan untuk Iklan Snapchat](snapchat-ads-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](snapchat-ads-configuring-iam-permissions.md)
+ [Mengkonfigurasi Iklan Snapchat](snapchat-ads-configuring.md)
+ [Mengonfigurasi koneksi Iklan Snapchat](snapchat-ads-configuring-connections.md)
+ [Membaca dari entitas Iklan Snapchat](snapchat-ads-reading-from-entities.md)
+ [Opsi koneksi Iklan Snapchat](snapchat-ads-connection-options.md)
+ [Membuat akun Iklan Snapchat dan mengonfigurasi aplikasi klien](connecting-to-data-snapchat-ads-new-account.md)
+ [Membuat aplikasi di akun Iklan Snapchat](connecting-to-data-snapchat-ads-managed-client-application.md)
# AWS Glue dukungan untuk Iklan Snapchat
AWS Glue mendukung Iklan Snapchat sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Iklan Snapchat.
**Didukung sebagai target?**
Tidak.
**Versi API Iklan Snapchat yang didukung**
v1.
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
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": "*"
}
]
}
```
------
Anda juga dapat menggunakan kebijakan IAM terkelola berikut untuk mengizinkan akses:
+ [ 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,, dan Amazon EC2. Amazon CloudWatch Logs 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 Iklan Snapchat
Sebelum dapat digunakan AWS Glue untuk mentransfer dari Iklan Snapchat, Anda harus memenuhi persyaratan berikut:
## Persyaratan minimum
+ Anda memiliki akun Iklan Snapchat. Untuk informasi selengkapnya tentang membuat akun, lihat[Membuat akun Iklan Snapchat dan mengonfigurasi aplikasi klien](connecting-to-data-snapchat-ads-new-account.md).
+ Anda telah membuat OAuth2 aplikasi di akun Iklan Snapchat Anda. Integrasi ini menyediakan kredensi yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan yang diautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat [Membuat aplikasi di akun Iklan Snapchat](connecting-to-data-snapchat-ads-managed-client-application.md).
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Iklan Snapchat Anda. Di Iklan Snapchat, aplikasi yang terhubung adalah kerangka kerja yang mengizinkan aplikasi eksternal, seperti AWS Glue, untuk mengakses data Iklan Snapchat Anda.
# Mengonfigurasi koneksi Iklan Snapchat
Iklan Snapchat hanya mendukung jenis `AUTHORIZATION_CODE` hibah.
Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue Konsol. Pengguna yang membuat koneksi mungkin secara default mengandalkan aplikasi terhubung yang AWS Glue dimiliki (aplikasi klien AWS Glue terkelola) di mana mereka tidak perlu memberikan informasi OAuth terkait apa pun kecuali URL instance Iklan Snapchat mereka. AWS Glue Konsol akan mengarahkan pengguna ke Iklan Snapchat di mana pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance Iklan Snapchat mereka.
Pengguna masih dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung di Iklan Snapchat dan memberikan id klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue Konsol. Dalam skenario ini, mereka masih akan diarahkan ke Iklan Snapchat untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka.
Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses kedaluwarsa setelah 1 jam pembuatan. Token akses baru dapat diambil menggunakan token penyegaran.
Untuk informasi selengkapnya tentang membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi, lihat [API Iklan](https://marketingapi.snapchat.com/docs/#authentication).
Untuk mengonfigurasi koneksi Iklan Snapchat:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut. Diperlukan untuk membuat rahasia untuk setiap koneksi di AWS Glue.
1. Untuk aplikasi terhubung yang dikelola pelanggan — Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Iklan Snapchat.
1. Menyediakan lingkungan Iklan Snapchat.
1. Pilih peran IAM yang AWS Glue dapat mengasumsikan 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 entitas Iklan Snapchat
**Prasyarat**
+ Objek Iklan Snapchat 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 |
| --- | --- | --- | --- | --- | --- |
| Organisasi | Tidak | Tidak | Tidak | Ya | Tidak |
| Akun Iklan | Tidak | Tidak | Tidak | Ya | Tidak |
| Kreatif | Tidak | Tidak | Tidak | Ya | Tidak |
| Media | Tidak | Tidak | Tidak | Ya | Tidak |
| Kampanye | Ya | Tidak | Tidak | Ya | Tidak |
| Iklan Di Bawah Akun Iklan | Ya | Tidak | Tidak | Ya | Tidak |
| Kampanye Iklan Di Bawah | Tidak | Tidak | Tidak | Ya | Tidak |
| Skuad Iklan | Ya | Tidak | Tidak | Ya | Tidak |
| Segment | Tidak | Tidak | Tidak | Ya | Tidak |
**Contoh**
```
snapchatads_read = glueContext.create_dynamic_frame.from_options(
connection_type="snapchatAds",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "organization",
"API_VERSION": "v1"
}
)
```
**Entitas dan detail bidang Iklan Snapchat**
Iklan Snapchat memuat bidang yang tersedia secara dinamis di bawah entitas yang dipilih. Tergantung pada tipe data bidang, ini mendukung operator filter berikut.
| Tipe Data Bidang | Operator Filter yang Didukung |
| --- | --- |
| Boolean | = |
**Mempartisi kueri**
+ Partisi berbasis lapangan: Tidak didukung.
+ Partisi berbasis rekaman: Tidak didukung.
# Opsi koneksi Iklan Snapchat
Berikut ini adalah opsi koneksi untuk Iklan Snapchat:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama entitas Iklan Snapchat. Contoh:` campaign `.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Snapchat Ads Rest versi API yang ingin Anda gunakan. Nilainya akan menjadi v1, karena Iklan Snapchat saat ini hanya mendukung versi v1.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Daftar kolom yang dipisahkan koma 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 akun Iklan Snapchat dan mengonfigurasi aplikasi klien
**Topics**
+ [Mendaftar untuk Iklan Snapchat](#snapchat-ads-sign-up)
+ [Langkah-langkah untuk membuat akun Iklan Snapchat](#snapchat-ads-create-ad-account)
## Mendaftar untuk Iklan Snapchat
**Untuk mendaftar ke Iklan Snapchat:**
1. Arahkan ke [Manajer Iklan Snapchat](https://ads.snapchat.com/). Pilih **Daftar di** samping **Baru ke Snapchat?** .
1. Pada layar **Buat Akun**, ikuti petunjuk untuk memasukkan Nama Bisnis, Email, Kata Sandi, dll. Pilih **Berikutnya**.
1. Pada layar **Buat Profil Anda**, masukkan nilai untuk Nama Pengguna, Situs Web (Opsional), dan pilih **Buat Akun**. Ini akan memberi Anda opsi untuk menambahkan foto profil dan bio di layar **Edit Profil Anda**. Pilih **Konfirmasi**.
1. **Pada layar **Info Bisnis**, isi kolom wajib seperti Negara, Mata Uang, Nomor Telepon, GSTIN dll, dan selesaikan proses pembuatan akun dengan memilih Berikutnya.**
## Langkah-langkah untuk membuat akun Iklan Snapchat
**Untuk membuat akun Iklan Snapchat:**
1. Masuk ke **Manajer Iklan**. Kemudian klik navigasi di sudut atas dan pilih **Akun Iklan**.
1. Pilih **\$1 Akun Iklan Baru**. Masukkan detail pengiklan Anda:
+ Pilih apakah Anda agen yang membeli iklan atas nama pengiklan atau tidak. Jika Anda memilih 'Ya', iklan Anda mungkin ditolak jika menggunakan parameter penargetan yang dapat mencakup usia, jenis kelamin, atau tingkat penargetan kode pos. Penargetan usia minimum dapat diterapkan hingga usia 21 tahun.
+ Pilih apakah akun iklan Anda akan menjalankan iklan perumahan, kredit, atau pekerjaan atau tidak. Jika Anda memilih 'Ya', iklan Anda mungkin ditolak jika menggunakan parameter penargetan yang dapat mencakup usia, jenis kelamin, atau tingkat penargetan kode pos. Penargetan usia minimum dapat diterapkan hingga usia 21 tahun.
+ Pilih apakah Anda akan menggunakan akun iklan untuk iklan politik. Jika Anda menjalankan iklan politik, masukkan organisasi politik sponsor atau kelompok advokasi yang membayar iklan tersebut. Jika Anda tidak secara akurat memasukkan organisasi politik, iklan Anda mungkin ditolak. Anda juga harus mengisi 'Formulir Tinjauan Iklan Politik' yang ditautkan wajib sebelum mengirimkan iklan.
1. Pilih **Detail Akun** dan isi info akun iklan Anda:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/connecting-to-data-snapchat-ads-new-account.html)
1. Pilih **Buat Akun**. Akun iklan Anda akan dibuat, dan Anda dapat menemukannya di bagian Akun Iklan Manajer Iklan. Untuk mulai meluncurkan iklan, Anda harus memasukkan metode pembayaran. Anda juga dapat menambahkan anggota ke akun iklan Anda.
1. Pilih apakah Anda ingin menggunakan pembayaran yang sudah ada atau membuat yang baru. Kemudian, pilih **Save Payment Method**.
1. Pilih [anggota yang Anda undang](https://businesshelp.snapchat.com/s/article/manage-members?language=en_US) ke bisnis Anda untuk ditambahkan ke akun iklan. Untuk informasi selengkapnya tentang peran dan izin yang dapat ditetapkan, lihat Ikhtisar [Peran dan Izin](https://businesshelp.snapchat.com/s/article/roles-permissions?language=en_US). Anggota yang ditambahkan kemudian akan dapat masuk ke Manajer Iklan dan mengakses akun iklan ini. Setelah selesai, selamatkan anggota Anda.
Untuk informasi selengkapnya tentang akun iklan, lihat izin [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/ artikel/peran? language=En\$1US
# Membuat aplikasi di akun Iklan Snapchat
Untuk mengaktifkan akses ke API Pemasaran Snapchat, pastikan Anda telah menyiapkan akun bisnis. Kemudian ikuti langkah-langkah di bawah ini.
1. Masuk ke Manajer Iklan. Kemudian pilih menu di pojok kiri atas dan pilih **Dasbor Bisnis**, lalu pilih **Detail Bisnis**.
1. Pilih **\$1 OAuth Aplikasi**.
1. Masukkan Nama Aplikasi Anda dan Tambahkan URL berikut sebagai Snap Redirect URI. `https://.console.aws.amazon.com/gluestudio/oauth` Misalnya, jika menggunakan wilayah us-west-1, URL-nya akan menjadi. `https://us-west-1.console.aws.amazon.com/gluestudio/oauth) and choose Create OAuth App` Pilih **Buat OAuth Aplikasi**.
1. Kredensi aplikasi Anda (ID Klien dan Rahasia klien) akan ditampilkan. Simpan mereka karena mereka akan diminta untuk membuat koneksi.