Fitur dalam versi Beta mungkin tidak tersedia di jaringan Anda. Lihat catatan rilis untuk mengetahui kapan fitur ini tersedia secara umum.
File laporan Transfer Data memberikan data tingkat peristiwa dari kampanye iklan Anda tanpa agregasi. Data ini pada dasarnya merupakan konten mentah dari log server iklan Ad Manager, dengan file terpisah yang dibuat untuk setiap jenis peristiwa. File Transfer Data berisi data peristiwa yang sangat akurat, dan Anda dapat menyertakan informasi lainnya dalam file untuk melihat informasi perangkat, geografis, dan hal lainnya yang terkait dengan peristiwa. Partner harus menyetujui unit iklan di Ad Manager agar ditampilkan di file Transfer Data mereka.
Memulai
File laporan Transfer Data dikenai biaya tambahan. Hubungi Account Manager Anda untuk mengaktifkan fitur tersebut. Setelah fitur ini diaktifkan, Anda dapat menyiapkan jenis file Transfer Data Anda. Google Ad Manager menawarkan dua opsi untuk transfer data, CSV dan Parquet.
Jika organisasi Anda tidak memiliki kemampuan untuk mengelola proses ekstraksi, transformasi, dan pemuatan (ETL). memanipulasi file teks, mendukung file berukuran besar, merancang dan mengelola penyimpanan data berukuran sedang, serta merancang dan menerapkan skrip, pertimbangkan untuk bekerja sama dengan partner Google Marketing Platform yang disetujui.
File laporan Transfer Data yang tersedia
Setiap file Transfer Data berisi informasi tentang berbagai peristiwa. Anda dapat menambahkan kolom ke setiap jenis file untuk melihat informasi kontekstual terkait peristiwa tersebut.
Backfill
yang sesuai, file Network
tidak akan menyertakan tayangan yang dihasilkan dari Ad Exchange atau AdSense melalui alokasi dinamis. Gunakan file Backfill
untuk mendapatkan informasi tentang tayangan alokasi dinamis.Tentang data yang ada dalam file Transfer Data
- Data yang terlambat
Penundaan selama beberapa jam merupakan hal yang normal, tetapi terkadang pemrosesan file Transfer Data memerlukan waktu yang lebih lama dari biasanya. Jika terlambat, data akan muncul di file batch jam berikutnya dengan stempel waktu yang akurat. Ini dapat berarti bahwa jika prosesnya tertunda, file akan sebagian besar berisi stempel waktu misalnya antara pukul 08.00 hingga 09.00, dengan tambahan beberapa stempel waktu yang lebih awal. -
Jam tanpa aktivitas
Jika tidak ada aktivitas selama jam tertentu, file Transfer Data kosong yang hanya berisi data header akan diposting. - Batas tanggal dan hari
File per jam pertama untuk hari tertentu biasanya berisi peristiwa dari pukul 00.00 hingga 01.00 Waktu Pasifik, tetapi stempel waktu peristiwanya akan mengikuti zona waktu jaringan penayang. Misalnya, jika berada di zona Waktu Timur, penayang akan melihat peristiwa dari pukul 03.00 hingga 04.00 di file per jam pertama. Data untuk tiga jam sebelumnya akan ada di file hari sebelumnya. Oleh karena itu, tanggal stempel waktunya bisa saja lain dengan yang tanggal yang ditunjukkan oleh nama file. Selalu lihat stempel waktu peristiwa di file, bukan yang ada di nama file atau stempel waktu posting file. - Pelaporan master/pengiring di Transfer Data
File Transfer Data menampilkan tayangan materi iklan master dan pengiring, tetapi alat kueri hanya menghitung tayangan yang disajikan untuk kumpulan materi iklan master/pengiring (bukan tayangan untuk setiap materi iklan), kecuali jika informasi dikelompokkan menurut master/pengiring.
Nilai IsCompanion adalah “TRUE” untuk tayangan materi iklan Pengiring. Kolom CreativeId berisi ID materi iklan untuk masing-masing materi iklan Master dan Pengiring, bukan ID Kumpulan Materi Iklan. Di Transfer Data, tidak ada kolom tambahan untuk ID Kumpulan Materi Iklan guna mengaitkan tayangan pengiring dengan tayangan master. - Perbedaan dengan pelaporan Ad Manager
Traffic yang buruk atau data spam dihapus secara berkala dari laporan Ad Manager atau laporan yang dibuat API. Karena jadwal penerbitan file Transfer Data, sebagian dari penghapusan ini mungkin tidak terefleksikan di file. Oleh karena itu, Transfer Data dapat menampilkan sedikit lebih banyak tayangan, klik, atau peristiwa lain. Jika terjadi, perbedaan ini biasanya sebesar ~1%.File Transfer Data
CodeServes
mungkin menampilkan nilai yang lebih tinggi dibandingkan metrik "Jumlah kode yang ditayangkan" di laporan Ad Manager. Hal ini dikarenakan Transfer Data menghitung penayangan kode untuk setiap tayangan yang disajikan, tetapi laporan hanya menghitung satu penayangan kode untuk setiap permintaan. Beberapa format materi iklan, seperti iklan teks Google Ads, dapat berisi beberapa tayangan untuk satu permintaan. Kelompokkan file Transfer Data Anda berdasarkan nilai kolomKeyPart
guna menemukan tayangan unik untuk perbandingan.
Keunggulan dan kekurangan format output CSV dan Parquet
CSV (Comma Separated Values) | Parquet (Columnar Storage) | |
---|---|---|
Keterbacaan dan aksesibilitas | Sangat mudah dibaca manusia; dapat dibuka dan diedit dengan mudah menggunakan editor teks dasar atau software spreadsheet. | Memerlukan alat khusus untuk melihat dan mengedit; tidak mudah diakses oleh pengguna nonteknis. |
Universalitas dan kompatibilitas | Didukung secara luas oleh hampir semua alat pemrosesan dan analisis data. | Mungkin memerlukan library atau software tambahan untuk kompatibilitas penuh, terutama di sistem lama. |
Kesederhanaan dan kemudahan penggunaan | Struktur sederhana; mudah dipahami dan digunakan, terutama untuk set data yang lebih kecil atau analisis ad hoc cepat. | Penerapannya mungkin lebih rumit di awal, terutama bagi pengguna yang tidak terbiasa dengan penyimpanan berdasarkan kolom. |
Performa dan efisiensi | Dapat lebih lambat untuk set data besar karena penyimpanan berbasis baris dan kurangnya kompresi. | Menawarkan performa yang unggul untuk pemrosesan dan analisis data berskala besar karena penyimpanan berdasarkan kolom dan teknik kompresi yang efisien. |
Efisiensi penyimpanan | Penyimpanan kurang efisien karena kurangnya kompresi bawaan dan potensi penyimpanan data redundan. | Sangat efisien dalam penyimpanan karena penyimpanan kolom dan algoritma kompresi lanjutan, sehingga mengurangi biaya penyimpanan. Parquet dapat 50-75% lebih kecil daripada file CSV, terutama untuk dataset besar. |
Jika Anda sudah mengaktifkan Transfer Data dalam CSV, hubungi Account Manager Anda untuk mendapatkan akses ke Parquet.
Mendownload file contoh
Anda dapat mendownload contoh file ini sebagai CSV atau Parquet untuk melihat pratinjau data dan kolom yang ada di setiap file laporan Transfer Data.
Jenis peristiwa | Nama dan jenis file | Informasi yang ditampilkan | Contoh file |
---|---|---|---|
Bid yang Dapat Digabungkan | NetworkBackfillBidsJoinable |
Informasi tentang bid. Dapat digabungkan dengan file Transfer Data lainnya. 1 file per jam. |
|
CodeServe | NetworkCodeServes |
Mencatat setiap respons dari Ad Manager, baik yang didownload maupun tidak. 2 file per jam. Catatan: File Permintaan dan CodeServe disertakan dengan file Tayangan tanpa biaya tambahan. |
|
Tayangan | NetworkImpressions |
Informasi tentang tayangan yang didownload. 2 file per jam. |
|
Permintaan | NetworkRequests |
Mencatat setiap permintaan iklan yang diterima Ad Manager, baik yang terisi maupun tidak. 2 file per jam. Catatan: File Permintaan dan CodeServe disertakan dengan file Tayangan Iklan tanpa biaya tambahan. |
|
Tampilan aktif | NetworkActiveViews |
Informasi tentang tayangan berbasis Ad Manager yang memenuhi syarat untuk Tampilan Aktif. 2 file per jam. |
|
Bid | NetworkBackfillBids (Beta) |
Informasi tentang bid lelang Authorized Buyers dan Bidding Terbuka. 1 file per jam. |
|
Klik | NetworkClicks |
Informasi tentang klik. 2 file per jam. |
|
Bid minimum untuk menang | NetworkMinimumBidToWin (Beta) |
Melaporkan bid minimum yang diperlukan oleh pembeli untuk memenangkan lelang saat setidaknya satu item baris sisa bersaing. 1 file per jam. |
|
Konversi Rich Media | NetworkRichMediaConversions |
Informasi tentang acara Studio, termasuk tindakan standar dan kustom (suka, putar dan jeda), durasi tindakan, dan lainnya. 2 file per jam. |
|
Konversi video | NetworkVideoConversions |
Informasi tentang peristiwa khusus video, termasuk tindakan (suka, putar, dan jeda), ID konten, penentuan posisi pod, dan lainnya. Lihat semua peristiwa video. 2 file per jam. |
|
Cara pengiriman file
File Transfer Data diteruskan ke bucket penyimpanan cloud Ad Manager setiap jam. Sebaiknya lakukan pemeriksaan secara berkala untuk melihat apakah ada pembaruan. Data dikirimkan dan menjadi tersedia antara 5 hingga 15 jam setelah jam tercatatnya untuk sebagian besar data dan hingga 8 hari setelah peristiwa terjadi untuk beberapa peristiwa yang tertunda. Ad Manager tidak memberikan informasi transfer data kepada server pihak ketiga.
Nama file mencakup jam mulai peristiwa dalam zona waktu Pasifik AS (dengan memperhitungkan Waktu musim panas), tetapi stempel waktu yang muncul di file tersebut akan selalu mengikuti zona waktu jaringan Ad Manager (yang mungkin tidak memperhitungkan Waktu musim panas). Hal ini dapat menyebabkan file kosong/terlewat atau file yang berisi data selama lebih dari satu jam, bergantung pada keterkaitan antarsetelan zona waktu ini.
Nama file
Nama file Transfer Data mengikuti konvensi yang dapat diprediksi:
- CSV:
[Type]_[Network ID]_[YYYYMMDD]_[HH].gz
- Parquet:
[Type][Network ID][YYYYMMDD]_[HH]-[Partition Index]-of-[Total Number of Partitions].parquet
YYYYMMDD
adalah tahun, bulan, dan tanggal.HH
adalah jam mulai dalam format 24 jam.Angka jam (01, 02, 03) yang ditentukan di setiap nama file adalah dalam zona waktu Pasifik, tetapi penayang mendapatkan data khusus zona waktu jaringan mereka sendiri dari stempel waktu yang terdapat dalam file Transfer Data. Perhatikan perbedaan ini saat Anda memperhitungkan pengiriman file.
[Partition Index]
partisi file yang terkait dengan jumlah total file (partisi) yang dibuat, dimulai dari nol[Total Number of Partitions]
adalah jumlah file (partisi) yang digunakan untuk membuat file
File Transfer Data dalam proses permintaan iklan
Tinjau grafik berikut untuk memahami jenis file Transfer Data yang terkait dengan berbagai tahap proses permintaan iklan.
Menggunakan file laporan Transfer Data
Setelah Anda menyiapkan Transfer Data, file disimpan di bucket penyimpanan cloud Ad Manager. Anda dapat mengaksesnya di web, menggunakan alat command line, atau melalui API. Pelajari lebih lanjut cara mengakses bucket penyimpanan cloud Ad Manager
Jika membatasi penyerapan dan analisis data pada kumpulan file Transfer Data tertentu berdasarkan jam mulai di nama file, Anda mungkin mengabaikan data yang diberikan di file berikutnya karena waktu musim panas, pengumpulan data yang terlambat, atau skenario serupa lainnya. Pendekatan yang lebih baik adalah membaca semua file Transfer Data ke dalam sistem yang terpisah (seperti data warehouse atau mesin kueri) dan membatasi analisis berdasarkan stempel waktu peristiwa.
File Transfer Data tersedia dalam dua format: file CSV atau Parquet.
Pengguna dapat memilih CSV, Parquet, atau kedua output untuk setiap file. Parquet adalah format yang optimal untuk kasus penggunaan dan penyerapan data warehouse, sedangkan file CSV dapat digunakan di editor spreadsheet, bergantung pada ukuran file. Berikut beberapa contoh cara umum yang mungkin Anda pilih untuk menerapkan informasi Transfer Data:
- Agregasi peristiwa dan aktivitas pengguna dimensional (misalnya, per materi iklan)
- Menghitung konversi unik dalam beberapa hari
- Mencocokkan pengguna dengan database pelanggan
- Melaporkan informasi geografis dan demografis pengguna
Anda dapat menggunakan tabel pencocokan untuk menyediakan pencarian nama hingga ID bagi nilai yang ada dalam file Transfer Data, sehingga Anda dapat mencocokkan informasi penayangan iklan (seperti unit iklan atau item baris) dengan nilai yang ditetapkan terlebih dahulu yang tersimpan di database.
Simpan file secara lokal
Aturan umumnya adalah setiap peristiwa harus berukuran 25 hingga 35 byte dalam bentuk file yang dikompresi. Dengan demikian, 10 juta tayangan akan memerlukan kapasitas disk sekitar 300 MB dalam bentuk file CSV yang dikompresi. Anda akan melihat ukuran file yang lebih kecil dengan format output Parquet. Perlu diperhatikan bahwa ini adalah perkiraan, dan ukuran file Anda mungkin lebih besar. Selain itu, karena ini adalah ukuran data yang dikompresi, Anda perlu ruang untuk melakukan dekompresi dan menggunakan file.
File Transfer Data yang lebih lama dari 60 hari akan dihapus dari Ad Manager. Jika ingin menyimpan file selama lebih dari 60 hari, sebaiknya Anda menyimpan file secara lokal atau berpindah ke solusi penyimpanan cloud permanen, yang dapat menyertakan akun Google Cloud Storage independen yang dapat Anda kontrol sepenuhnya.
Mempelajari tentang BigQuery Data Transfer Service
Memudahkan pemrosesan file Transfer Data berukuran besar
Google Code telah merilis toolkit open-source yang disebut CRUSH (Custom Reporting Utilities for Shell) untuk memproses data teks dengan pembatas dari command line atau dalam skrip shell. Alat CRUSH telah dikembangkan serta diuji secara luas, dan alat ini dapat berfungsi secara optimal di sistem operasi Linux atau Unix. Dukungan untuk CRUSH tersedia di komunitas open source.
Sebagai alat alternatif non-open source, Anda dapat menggunakan software integrasi data buatan Syncsort yang disebut DMX.