Data lengkap Pull API

Premium

Direkomendasikan untuk

Pemasar

Tanggal terakhir diupdate:2 November, 2023 12:44

Sekilas: Gunakan API ini untuk mendapatkan laporan data lengkap dalam file CSV.

Data lengkap Pull API

Pull API memungkinkan Anda mendapatkan laporan data lengkap dalam file CSV. Pelajari lebih lanjut tentang laporan data lengkap
Filter berdasarkan opsi yang tersedia: Sumber media, rentang tanggal, nama peristiwa dalam aplikasi, dan geo.
Keunggulan tambahan dalam Pull API adalah:
- Pilih mata uang
- Pilih zona waktu

Laporan data lengkap tersedia melalui Pull API

Laporan	Deskripsi	Tingkat penyegaran
Laporan data lengkap (non-organik)
Instal	Mencatat penginstalan non-organik. Catatan dibuat saat pengguna membuka aplikasi untuk pertama kalinya.	Waktu sebenarnya
In-App Event	Mencatat event yang dilakukan pengguna.	Waktu sebenarnya
mencopot pemasangan	Mencatat saat pengguna meng-uninstall aplikasi.	Harian
Penginstalan ulang	Mencatat pengguna yang setelah meng-uninstall aplikasi, berinteraksi dengan sumber media UA, dan menginstal ulang aplikasi selama jendela atribusi ulang.	Waktu sebenarnya
Laporan data lengkap (organik)
Penginstalan Organik	Mencatat saat aplikasi dibuka oleh pengguna untuk pertama kalinya.	Berkelanjutan
In-app event organik	Mencatat detail tentang event yang dilakukan pengguna.	Berkelanjutan
Uninstall organik	Mencatat pengguna yang meng-uninstall aplikasi.	Harian
Penginstalan organik	Mencatat pendapatan iklan untuk pengguna yang diatribusikan ke sumber media penargetan ulang selama jendela interaksi ulang.	Harian
Data lengkap pendapatan iklan
Pendapatan iklan yang diatribusikan	Mencatat pendapatan iklan untuk pengguna yang diatribusikan ke sumber media.	Harian
Pendapatan iklan organik	Mencatat pendapatan iklan untuk pengguna yang tidak diatribusikan ke sumber media.	Harian
Penipuan Protect360
Install	Catatan penginstalan diidentifikasi sebagai penipuan dan oleh karena itu tidak diatribusikan ke sumber media apa pun.	Waktu sebenarnya
Instalasi pasca atribusi	Mencatat in-app event dari penginstalan palsu dan oleh karena itu tidak diatribusikan sama sekali.	Waktu sebenarnya
In-App Event	Mencatat in-app event yang diidentifikasi sebagai penipuan oleh Protect360.	Harian
In-app event pasca atribusi	Mencatat in-app event untuk penginstalan yang diidentifikasi sebagai penipuan setelah diatribusikan ke sumber media atau dinilai curang tanpa memperhatikan penginstalan itu sendiri.	Harian
Klik	Mencatat klik yang dilakukan pengguna yang diblokir oleh Protect360.	Harian
Postback instalasi yang diblokir	Mencatat salinan postback yang dikirim ke sumber media yang mengakibatkan penginstalan yang diblokir.	Waktu sebenarnya
Postback (postingan balik)
Postback penginstalan	Mencatat event penginstalan yang dihasilkan saat pengguna membuka aplikasi untuk pertama kalinya.	Harian
Postback in-app event	Mencatat postback in-app event yang dikirim ke sumber media.	Harian
Penargetan ulang postback in-app event	Mencatat in-app event yang dilakukan pengguna selama jendela interaksi ulang.	Waktu sebenarnya
Postback konversi penargetan ulang	Mencatat in-app event yang dilakukan pengguna selama jendela interaksi ulang.	Waktu sebenarnya

Menggunakan data lengkap Pull API

Untuk menggunakan data lengkap Pull API:

Dapatkan token API. Admin perlu mengambil token.
Berikan token API kepada pengembang Anda untuk digunakan di header autentikasi.
Beri programmer Anda parameter untuk diinput saat mereka melakukan panggilan API, seperti yang dijelaskan di bagian berikut. Parameter menentukan fokus laporan dan cara pengaturannya serta memberikan jangka waktu pelaporan.
Beri tahu pengembang Anda untuk mengikuti mereka instruksi data lengkap Pull API di hub programmer.

Parameter

Parameter	Deskripsi
from	Rentang tanggal terdiri dari parameter `dari`dan `hingga` . Tanggal terkait dengan tanggal aktivitas. Format: `yyyy-mm-dd`, `yyyy-mm-dd hh:mm`, atau `yyyy-mm-dd hh:mm:ss` Catatan: Ruang perlu dikodekan seperti yang ditunjukkan di sini `from=2020-04-01%2001:00:00` - Secara umum, browser akan menyandikan ruang. Contoh: 01-01-2010 atau 01-01-2010 20:15 (Parameter jam dan menit tersedia untuk laporan data lengkap).
ke	Tanggal selesai. Seperti untuk `dari`
media_source	`media_source`: Untuk membatasi (menyaring) panggilan ke sumber media tertentu. Tetapkan parameter `media_source` dan `category (kategori)` sebagai berikut: Untuk Meta ads, atur kategori dan sumber media ke facebook Untuk Twitter, atur kategori dan sumber media ke twitter Untuk semua sumber media lainnya, atur kategori ke standar dan sumber media ke nama sumber media. Contoh `media_source=facebook&category=facebook` `media_source=abc_example&category=standard`
maximum_rows	Jumlah maksimum baris yang dikembalikan oleh satu API call. [Default] jika tidak ada nilai yang dikirim, hingga 200 ribu baris 200000: Hingga 200 ribu baris yang kembali 1000000: Hingga 1 juta baris yang kembali Contoh: `maximum_rows=1000000` mengaktifkan hingga 1 juta baris.
event_name	Memfilter in-app event berdasarkan event tertentu. Pilih beberapaevent dengan menggunakan daftar yang dipisahkan tanda koma. Contoh: `event_name=af_purchase,ftd`
atribusi ulang	Atur data atribusi penargetan ulang [Default] Jika salah, kampanye data akuisisi pengguna (UA) kembali. Jika benar, data atribusi penargetan ulang kembali. Contoh:`reattr=true`
additional_fields	Untuk mendapatkan kolom tambahan selain kolom default. Contoh: `additional_fields=device_download_time,deeplink_url`
currency	Mata uang pendapatan dan biaya [Default] Jika parameter tidak dikirim, data kembali menggunakan USD. Artinya, tidak melakukan apa-apa dan hasilnya kembali dalam USD. Jika Anda mengirimkan, `currency=preferred`Mata uang khususaplikasi digunakan. Artinya mata uang diatur di pengaturan aplikasi. Contoh: Jika mata uang khusus aplikasi adalah EUR, dengan mengirimkan `currency=preferred`nilainya kembali dalam EUR.
zona waktu	[Default] Data kembali menggunakan UTC. Untuk mendapatkan data dalam zona waktu khusus aplikasi, tambahkan `zona waktu` seperti yang ditampilkan di bagian ini ke panggilan: `zona waktu=[Numerical value]` Contoh: Untuk zona waktu UTC+10:00 gunakan`zonawaktu=+10:00` Catatan: Tanda `+`,`-`, dan `:` harus dikodekan. Contoh: +10:00 dikodekan ke `%2B10% 3A00`
geo	Filter data berdasarkan kode negara. Batasan: Anda hanya dapat menyetel satu filter kode negara per API call. Contoh: `geo=ZA`
from_install time	Rentang tanggal terdiri dari parameter `dari`dan `hingga` . Tanggal terkait dengan tanggal aktivitas. Format: `hh-bb-tttt` Contoh: 01-01-2010
to_install_time	Tanggal selesai. Untuk `from_install time`
agency	Untuk membatasi (memfilter) panggilan ke agensi tertentu.

Bidang Protect360

Lihat panduan data lengkap Protect360

Bidang rentang waktu

Jika hasil API melebihi batas maksimum, pisahkan laporan menggunakan jam dan menit. Terapkan hal berikut ini:

dari/hingga: yyyy-mm-dd hh:mm
dari:
- Hanya tanggal = dari awal (00:00) tanggal yang dipilih
- Tanggal dan waktu = dari dan termasuk 00:00
Parameter hingga:
- Hanya tanggal = hingga akhir (24:00) hari yang dipilih
- Tanggal dan waktu = hingga, tetapi tidak termasuk, waktu yang ditampilkan

Contoh: Pemilik aplikasi memiliki 1,3 juta penginstalan harian dari semua sumber. Untuk mengatasi batas baris 1 juta, pemilik aplikasi membagi hari menjadi dua URI call 12 jam. Lihat tabel berikut untuk pilihan.

Panggilan API Dari Hingga

Panggilan API pertamal

dari =hh-bb-tttt

Contoh:

dari=29-12-2019
Dimulai pada tanggal ini di awal hari pukul 00:00

hingga=hh-bb-tttt 12:00

Contoh:

hingga=29-12-2019 12:00
Dilanjutkan hingga 11:59:59, bukan 12:00

Opsi A: Panggilan API kedua

Contoh:

&dari=29-12-2019 12:00&hingga=29-12-2019

Mulai tengah hari 29 Des 2019
Berakhir tengah malam 29 Des 2019

dari=hh-bb-tttt 12:00

Contoh:

dari=29-12-2019 12:00
Mulai dari dan termasuk pukul 12:00

hingga=yyyy-mm-dd

Contoh:

sampai=29-12-2019
Berakhir pada tengah malam

Opsi B: Panggilan API kedua

dari=hh-bb-tttt 12:00

Contoh:

dari=29-12-2019 12:00
Mulai dari dan termasuk pukul 12:00

hingga=hh-bb-tttt+1 00:00

+1 = esok harinya pada pukul 00:00

Contoh:

to= 30-12-2019 00:00
Artinya sebelum waktu berlalu pada 30 Des.

Catatan!:Gunakan opsi A atau B karena hasilnya sama.

Kolom Tambahan

Bidang laporan tambahan tidak ditambahkan ke daftar bidang default sehingga bidang baru tidak berdampak pada proses impor dan penyerapan yang ada. Gunakan parameter additional_fields untuk mendapatkan bidang non-default.

Hanya sekali mencantumkan bidang.
Lihat daftar bidang yang tersedia.
Contoh: additional_fields=device_download_time,deeplink_url

Bidang default

Kolom Pull API default
Attributed Touch Time
Install Time
Event Time
eventName
nilai event
Pendapatan Event
Mata Uang Pendapatan Event
Penghasilan Event USD
Sumber Event
Apakah Tanda Terima Divalidasi
Partner
Media Source
Channel
Keywords
Kampanye
ID kampanye
adset
ID adset
ad
ID iklan
Jenis Iklan
ID situs
ID Sub Situs
Sub Param 1
Sub Param 2
Sub Param 3
Sub Param 4
Sub Param 5
Model Biaya
Nilai Biaya
Mata Uang Biaya
Partner Kontributor 1
Sumber Media Kontributor 1
Kampanye Kontributor 1
Waktu Sentuh Kontributor 1
Waktu Sentuh Kontributor 1
Partner Kontributor 2
Sumber Media Kontributor 2
Kampanye Kontributor 2
Waktu Sentuh Kontributor 2
Waktu Sentuh Kontributor 2
Partner Kontributor 3
Sumber Media Kontributor 3
Kampanye Kontributor 3
Waktu Sentuh Kontributor 3
Waktu Sentuh Kontributor 3
Wilayah
Kode Negara
Negara
city
Kode Pos
DMA
ip
wifi
Operator
Carrier
bahasa
AppsFlyer ID
ID Iklan
idfa
ID Android
ID User Pelanggan
imei
IDFV
platform
Jenis perangkat
Versi OS
Versi aplikasi
Versi SDK
ID Aplikasi
Nama aplikasi
ID Bundle
Is Retargeting
Jenis Konversi Penargetan Ulang
Attribution Lookback
Reengagement Window
Is Primary Attribution
Agen User
HTTP Referrer
Original URL

Informasi Tambahan

Karakteristik dan batasan

Sifat	Komentar
Jenis token API diperlukan	Token V2.0
Akses jaringan iklan	Tidak
Akses agensi	Ya
Transparansi agensi	Ya. Namun, perhatikan bahwa jika Anda menggunakan filter agensi dan filter sumber media, filter sumber media tidak berlaku untuk agensi yang tidak transparan. Artinya, untuk instansi yang tidak transparan, semua data disertakan; bukan hanya data dari sumber media yang difilter.
Mata uang khusus aplikasi	Ya
Zona waktu khusus aplikasi	Ya
Kesegaran data	Setara dengan ketersediaan data di dashboard ikhtisar. Laporan diperbarui dengan jeda beberapa jam: In-app event organik Laporan diperbarui Setiap Hari: mencopot pemasangan In-app event pasca atribusi Pendapatan Iklan
Data historis	Ya. Menurut kebijakan retensi dan batasan tarif .
Data non-organik	Ya
Data organik	Ya
Batasan tingkat	Batasan API untuk data lengkap.
Keterbatasan ukuran	Maksimal pengembalian API call 200 ribu/1 juta baris. Jika laporan memiliki tepat 200 ribu/1 juta baris, maka anggaplah ada baris yang hilang. Gunakan parameter maximum_rows untuk memilih jumlah maksimal baris. Lakukan beberapa API call, menggunakan parameter dari/hingga yang menyertakan waktu.
Install_date from dan install_date_to	Rentang tanggal penginstalan harus lebih awal dari rentang tanggal aktivitas.

Pemecahan Masalah

Petunjuk/pesan	Solusi
Laporan tidak berisi data yang diharapkan menurut rentang waktu yang dipilih atau terdapat perbedaan antara laporan data lengkap dan laporan data teragregasi.	Pastikan Anda telah menetapkan parameter `zona waktu`. Jika tidak, data dikirim menggunakan UTC dan bukan zona waktu aplikasi Anda.

Lihat juga

Memilih alat pengiriman data yang tepat/API pelaporan