Menjadwalkan transfer Display & Video 360

BigQuery Data Transfer Service untuk Display & Video 360 memungkinkan Anda menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis untuk data konfigurasi dan pelaporan 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 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
Jadwal	Harian, pada saat transfer pertama kali dibuat (default) Anda dapat mengonfigurasi waktu pada hari itu.
Frekuensi pemuatan ulang	2 hari terakhir Tidak dapat dikonfigurasi
Durasi pengisian ulang maksimum	60 hari terakhir

Opsi pelaporan

Dukungan

Jadwal

Harian, pada saat transfer pertama kali dibuat (default)

Anda dapat mengonfigurasi waktu pada hari itu.

Frekuensi pemuatan ulang

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:

Sebelum memulai

Tinjau prasyarat dan informasi berikut sebelum Anda membuat transfer 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 Display & Video 360 atau ID Pengiklan. ID partner adalah induk dalam hierarki.
Pastikan Anda memiliki izin baca untuk mengakses data partner atau pengiklan dari Display & Video API.
Pastikan organisasi Anda memiliki akses ke file Transfer Data Display & Video 360 v2 (Display & Video 360 DTv2). File ini dikirim 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 Display & Video 360 DTv2.
- Jika Anda tidak memiliki kontrak dengan Display & Video 360, hubungi agensi Anda untuk mendapatkan akses ke file Display & Video 360 DTv2.
- Setelah menyelesaikan langkah ini, Anda akan menerima salah satu nama bucket Cloud Storage berikut, tergantung 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 Display & Video 360 DTv2 atas nama Anda. Hubungi dukungan Display & Video 360 atau agensi Anda untuk mendapatkan akses ke file Display & Video 360 DTv2.
Untuk menyiapkan notifikasi proses 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 Buckets 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 tidak standar 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

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery
Di menu navigasi BigQuery, klik Transfer data.
Klik Buat transfer.
Di halaman Buat transfer, lakukan tindakan berikut:
- Di bagian Source type, untuk Source, pilih Display & Video 360 - Preview.
- Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
Di bagian Schedule options:
- Pilih Mulai sekarang atau Mulai pada waktu yang ditetapkan, lalu berikan tanggal mulai dan waktu proses.
- Untuk Repeats, pilih opsi seberapa sering transfer dijalankan. Jika Anda memilih Days, berikan waktu yang valid dalam UTC.
  - Jam
  - Hari
  - Sesuai permintaan
Di bagian Setelan tujuan, di menu Set data tujuan, pilih set data yang Anda buat untuk menyimpan data.
Di bagian Data source details:
- Di kolom ID Display & Video 360, masukkan ID Partner atau ID Pengiklan.
- Opsional: Di bagian Opsi notifikasi:
  - 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 Simpan.

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.
NAME: nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
PARAMETERS: parameter untuk konfigurasi transfer 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 digunakan hanya untuk nama file kustom yang langka.
DATA_SOURCE: sumber data — displayvideo.

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

Transfer 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 di command line.

API

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

Membuat kueri terhadap data

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

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