Halaman ini diterjemahkan oleh Cloud Translation API.

Menjadwalkan transfer Display & Video 360

Dengan konektor BigQuery Data Transfer Service untuk Display & Video 360, Anda dapat menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis untuk data pelaporan dan konfigurasi Display & Video 360.

Laporan yang didukung

BigQuery Data Transfer Service untuk Display & Video 360 mendukung opsi pelaporan berikut:

File Transfer Data v2 (Display & Video DTv2)

Untuk mengetahui informasi tentang cara mengubah laporan Display & Video 360 menjadi tabel dan tampilan BigQuery, lihat Transformasi data Display & Video 360.

Display & Video 360 menyimpan file transfer data hingga 60 hari.

Opsi pelaporan	Dukungan
Frekuensi pengulangan	Harian, pada saat transfer data pertama kali dibuat (default) Anda dapat mengonfigurasi waktu pada hari itu.
Jendela refresh	2 hari terakhir Tidak dapat dikonfigurasi
Durasi pengisian ulang maksimum	60 hari terakhir

Opsi pelaporan

Dukungan

Frekuensi pengulangan

Harian, pada saat transfer data pertama kali dibuat (default)

Anda dapat mengonfigurasi waktu pada hari itu.

Jendela refresh

2 hari terakhir

Tidak dapat dikonfigurasi

Durasi pengisian ulang maksimum

60 hari terakhir

Data konfigurasi yang didukung

Selain data pelaporan, BigQuery Data Transfer Service juga mentransfer data konfigurasi berikut dari Display & Video 360. Data konfigurasi diambil dari Display & Video 360 API v3.

Untuk informasi selengkapnya tentang setiap jenis data konfigurasi, lihat link berikut:

Proses transfer data dari Display & Video 360

Saat Anda mentransfer data dari Display & Video 360 ke BigQuery, data tersebut akan dimuat ke dalam tabel BigQuery yang dipartisi berdasarkan tanggal. Partisi tabel tempat data dimuat sesuai dengan tanggal dari sumber data. Jika Anda menjadwalkan beberapa transfer untuk tanggal yang sama, BigQuery Data Transfer Service akan menimpa partisi untuk tanggal tertentu tersebut dengan data terbaru. Beberapa transfer dalam satu hari atau menjalankan pengisian ulang tidak akan menghasilkan data duplikat, dan partisi untuk tanggal lain tidak akan terpengaruh.

Memuat ulang jendela

Periode refresh adalah jumlah hari yang diperlukan transfer data untuk mengambil data saat transfer data terjadi. Misalnya, jika periode pembaruan adalah tiga hari dan transfer harian terjadi, BigQuery Data Transfer Service akan mengambil semua data dari tabel sumber Anda selama tiga hari terakhir. Dalam contoh ini, saat transfer harian terjadi, BigQuery Data Transfer Service akan membuat partisi tabel tujuan BigQuery baru dengan salinan data tabel sumber Anda dari hari ini, lalu otomatis memicu pengisian ulang untuk memperbarui partisi tabel tujuan BigQuery dengan data tabel sumber Anda dari dua hari terakhir. Proses pengisian ulang yang dipicu secara otomatis akan menimpa atau memperbarui tabel tujuan BigQuery secara bertahap, bergantung pada apakah update inkremental didukung di konektor BigQuery Data Transfer Service atau tidak.

Saat Anda menjalankan transfer data untuk pertama kalinya, transfer data akan mengambil semua data sumber yang tersedia dalam periode refresh. Misalnya, jika periode pembaruan adalah tiga hari dan Anda menjalankan transfer data untuk pertama kalinya, BigQuery Data Transfer Service akan mengambil semua data sumber dalam tiga hari.

Periode pembaruan dipetakan ke kolom API TransferConfig.data_refresh_window_days.

Untuk mengambil data di luar periode pembaruan, seperti data historis, atau untuk memulihkan data dari gangguan atau kesenjangan transfer, Anda dapat memulai atau menjadwalkan operasi pengisian ulang.

Sebelum memulai

Tinjau prasyarat dan informasi berikut sebelum Anda membuat transfer data Display & Video 360.

Prasyarat

Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
Buat set data BigQuery untuk menyimpan data Display & Video 360.
Pastikan Anda memiliki ID Partner atau ID Pengiklan Display & Video 360. ID partner adalah induk dalam hierarki.
Pastikan Anda memiliki izin baca untuk mengakses data partner atau pengiklan dari Display dan Video API.
Pastikan organisasi Anda memiliki akses ke file Transfer Data Display & Video 360 v2 (DTv2 Display & Video 360). File ini dikirimkan oleh tim Display & Video 360 di bucket Cloud Storage. Permintaan akses ke file DTv2 Display & Video 360 bergantung pada apakah Anda memiliki kontrak langsung dengan Display & Video 360 atau tidak. Dalam kedua kasus tersebut, biaya tambahan mungkin berlaku.
- Jika Anda memiliki kontrak dengan Display & Video 360, hubungi dukungan Display & Video 360 untuk menyiapkan file DTv2 Display & Video 360.
- Jika Anda tidak memiliki kontrak dengan Display & Video 360, hubungi agensi iklan Anda untuk mendapatkan akses ke file DTv2 Display & Video 360.
- Setelah menyelesaikan langkah ini, Anda akan menerima salah satu nama bucket Cloud Storage berikut, bergantung pada apakah penyiapan Anda ditujukan untuk partner atau pengiklan:
  - gs://dcdt_-dbm_partnerPARTNER_ID
  - gs://dcdt_-dbm_advertiserADVERTISER_ID
Catatan: Tim Google Cloud tidak memiliki kemampuan untuk membuat atau memberikan akses ke file DTv2 Display & Video 360 atas nama Anda. Hubungi dukungan Display & Video 360 atau agensi Anda untuk mendapatkan akses ke file DTv2 Display & Video 360.
Untuk menyiapkan notifikasi operasi transfer untuk Pub/Sub, Anda harus memiliki izin pubsub.topics.setIamPolicy. Untuk mengetahui informasi selengkapnya, lihat Notifikasi operasi BigQuery Data Transfer Service.

Menemukan ID Display & Video 360

Untuk mengambil ID Display & Video 360, buka halaman Bucket Cloud Storage di konsol Google Cloud dan periksa file di bucket Cloud Storage transfer data Display & Video 360. ID Display & Video 360 digunakan untuk mencocokkan file di bucket Cloud Storage yang disediakan. ID disematkan dalam nama file, bukan nama bucket Cloud Storage. Contoh:

Dalam file bernama dbm_partner123_activity_*, ID-nya adalah 123.
Dalam file bernama dbm_advertiser567_activity_*, ID-nya adalah 567.

Menemukan awalan nama file Anda

Dalam beberapa kasus, file di bucket Cloud Storage Anda mungkin memiliki nama file kustom nonstandar yang disiapkan oleh tim layanan Google Marketing Platform untuk Anda. Contoh:

Dalam file bernama dbm_partner123456custom_activity_*, awalannya adalah dbm_partner123456custom.

Untuk mendapatkan bantuan terkait awalan nama file, hubungi dukungan Display & Video 360.

Menyiapkan transfer data Display & Video 360

Pilih salah satu opsi berikut:

Konsol

Buka halaman Data transfers di konsol Google Cloud.

Buka Data transfers
Klik Create transfer.
Di halaman Buat transfer, lakukan tindakan berikut:
- Di bagian Source type, untuk Source, pilih Display & Video 360.
- Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer data. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
Di bagian Schedule options:
- Pilih Start now atau Start at set time, lalu masukkan tanggal mulai dan waktu proses.
- Untuk Repeats, pilih opsi seberapa sering transfer data dijalankan. Jika Anda memilih Days, berikan waktu yang valid dalam UTC.
  - Jam
  - Hari
  - Sesuai permintaan
Di bagian Destination settings, di menu Destination dataset, pilih set data yang Anda buat untuk menyimpan data.
Di bagian Data source details:
- Di kolom DV360 DTV2 Cloud Storage bucket, masukkan bucket Cloud Storage yang berisi file DTv2 Display & Video 360. Jika Anda perlu menyiapkan bucket ini, hubungi dukungan Display & Video 360.
- Di kolom DV360 Partner/Advertiser ID, masukkan Partner ID atau Advertiser ID.
- Opsional: Di bagian Notification options:
  - Klik tombol untuk mengaktifkan notifikasi email. Saat Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email saat proses transfer gagal.
  - Klik tombol untuk mengaktifkan notifikasi Pub/Sub. Untuk Select a Cloud Pub/Sub topic, pilih nama topic Anda atau klik Create a topic. Opsi ini mengonfigurasi notifikasi operasi Pub/Sub atas transfer yang dilakukan.
Klik Save.

bq

Masukkan perintah bq mk dan berikan flag pembuatan transfer — --transfer_config. Flag berikut diperlukan:

--data_source
--target_dataset
--display_name
--params

  bq mk --transfer_config \
  --project_id=PROJECT_ID \
  --target_dataset=DATASET \
  --display_name=NAME \
  --params='PARAMETERS' \
  --data_source=DATA_SOURCE

Dengan keterangan:

PROJECT_ID: project ID Anda.
DATASET: set data target untuk konfigurasi transfer data.
NAME: nama tampilan untuk konfigurasi transfer data. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
PARAMETERS: parameter untuk konfigurasi transfer data yang dibuat dalam format JSON. Misalnya—--params='{"param":"param_value"}'. Untuk transfer Display & Video 360, parameter bucket dan displayvideo_id diperlukan. Parameter file_name_prefix bersifat opsional dan hanya digunakan untuk nama file kustom yang langka.
DATA_SOURCE: sumber data — displayvideo.

Misalnya, perintah berikut akan membuat transfer data Display & Video 360 bernama My Transfer menggunakan ID Display & Video 360 123456, bucket Cloud Storage dcdt_-dbm_partner123456, dan set data target mydataset.

Transfer data dibuat di project default:

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

Setelah menjalankan perintah, Anda akan menerima pesan seperti berikut:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Ikuti petunjuk dalam pesan, lalu tempel kode autentikasi pada command line.

API

Gunakan metode projects.locations.transferConfigs.create dan berikan instance resource TransferConfig.

Membuat kueri data Anda

Saat data Anda ditransfer ke BigQuery, data tersebut akan ditulis ke tabel berpartisi berdasarkan waktu penyerapan. Untuk informasi selengkapnya, lihat Pengantar tabel berpartisi.

Sebaiknya buat kueri tampilan yang dibuat secara otomatis, bukan membuat kueri tabel secara langsung. Namun, jika ingin membuat kueri tabel secara langsung, Anda harus menggunakan kolom semu _PARTITIONTIME dalam kueri. Untuk informasi selengkapnya, lihat Membuat kueri tabel berpartisi.