Transfer Search Ads 360

Dengan BigQuery Data Transfer Service untuk Search Ads 360, Anda dapat menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis untuk data pelaporan Search Ads 360.

Laporan yang didukung

BigQuery Data Transfer Service untuk Search Ads 360 mendukung Search Ads 360 Reporting API v0:

Untuk mendapatkan informasi tentang cara mengubah laporan Search Ads 360 menjadi tabel dan tabel virtual BigQuery Data Transfer Service, lihat Transformasi laporan Search Ads 360.

Opsi pelaporan Support
Versi API yang didukung

v0

Jadwal

Harian, pada saat transfer pertama kali dibuat (default)

Anda dapat mengonfigurasi waktu pada hari itu.

Periode pemuatan ulang

7 hari terakhir (default)

Dapat dikonfigurasi hingga 30 hari

Snapshot tabel pencocokan diambil sekali sehari dan disimpan di partisi untuk tanggal terakhir dijalankan. Snapshot Tabel Pencocokan tidak diperbarui untuk pengisian ulang atau selama hari yang dimuat menggunakan periode pemuatan ulang.

Durasi pengisian ulang maksimum

Tak terbatas

Jumlah ID Pelanggan per akun pengelola

2.000

BigQuery Data Transfer Service mendukung maksimum 2.000 ID Pelanggan untuk setiap akun pengelola Search Ads 360.

Untuk melihat panduan transfer Search Ads 360 yang menggunakan Search Ads 360 Reporting API versi lama, lihat Transfer Search Ads 360 (Tidak digunakan lagi).

Penyerapan data dari transfer Search Ads 360

Saat Anda mentransfer data dari Search Ads 360 ke BigQuery, data tersebut akan dimuat ke tabel BigQuery yang dipartisi menurut 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 di hari yang sama tidak menghasilkan data duplikat, dan partisi untuk tanggal lain tidak akan terpengaruh.

Batasan

  • Frekuensi maksimum yang dapat dikonfigurasi untuk transfer Search Ads 360 adalah sekali setiap 24 jam. Secara default, transfer dimulai saat Anda membuat transfer. Namun, Anda dapat mengonfigurasi waktu mulai transfer saat membuat transfer.
  • BigQuery Data Transfer Service tidak mendukung transfer inkremental selama transfer Search Ads 360. Saat Anda menentukan tanggal untuk transfer data, semua data yang tersedia untuk tanggal tersebut akan ditransfer.

Sebelum memulai

Sebelum Anda membuat transfer Search Ads 360:

Izin yang diperlukan

Pastikan penggunaan yang membuat transfer memiliki izin yang diperlukan berikut:

  • BigQuery Data Transfer Service:

    • bigquery.transfers.update izin untuk membuat transfer.
    • Izin bigquery.datasets.get dan bigquery.datasets.update pada set data target.

    Peran IAM bigquery.admin yang telah ditetapkan mencakup izin bigquery.transfers.update, bigquery.datasets.update, dan bigquery.datasets.get. Untuk mengetahui informasi selengkapnya tentang peran IAM dalam BigQuery Data Transfer Service, lihat Kontrol akses.

  • Google Cloud:

    • Izin serviceusage.services.use untuk mendownload data dari Search Ads 360 di project.

    Peran IAM editor, owner, dan serviceusage.serviceUsageConsumer yang telah ditetapkan mencakup izin serviceusage.services.use. Untuk mengetahui informasi selengkapnya tentang peran IAM dalam Service Usage, lihat Referensi kontrol akses.

  • Search Ads 360:

    • Akses baca ke ID Pelanggan atau akun pengelola Search Ads 360 yang digunakan dalam konfigurasi transfer.

Membuat transfer data Search Ads 360

Untuk membuat transfer data bagi pelaporan Search Ads 360, Anda memerlukan ID Pelanggan atau akun pengelola Search Ads 360. Pilih salah satu opsi berikut:

Konsol

  1. Buka halaman BigQuery di konsol Google Cloud.

Buka halaman BigQuery

  1. Klik Data transfers.

  2. Klik Create transfer.

  3. Di bagian Source type, untuk Source, pilih Search Ads 360 - Preview.

  4. Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer, misalnya My Transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.

  5. Di bagian Schedule options:

    • Untuk Repeat frequency, pilih opsi untuk seberapa sering transfer dijalankan. Jika Anda memilih Days, berikan waktu yang valid dalam UTC.
      • Jam
      • Hari
      • Sesuai permintaan
    • Jika berlaku, pilih Start now atau Start at set time dan masukkan tanggal mulai dan waktu proses.
  6. Di bagian Destination settings, untuk Dataset, pilih set data yang Anda buat untuk menyimpan data Anda.

  7. Di bagian Data source details:

  8. Untuk ID Pelanggan, masukkan ID pelanggan Search Ads 360 Anda:

  9. Opsional: Masukkan ID Agensi dan ID Pengiklan (keduanya harus disebutkan) untuk mengambil tabel pemetaan ID.

  10. Opsional: Masukkan daftar tabel yang dipisahkan koma untuk disertakan, misalnya Campaign, AdGroup. Awali daftar ini dengan karakter - untuk mengecualikan tabel tertentu, misalnya -Campaign, AdGroup. Semua tabel disertakan secara default.

  11. Opsional: Untuk Periode pemuatan ulang, masukkan nilai antara 1 dan 30. Jika tidak ditetapkan, periode pemuatan ulang ditetapkan secara default ke 7 hari.

  12. Di menu Service Account, pilih sebuah akun layanan dari akun layanan yang terkait dengan project Google Cloud Anda. Anda dapat mengaitkan akun layanan dengan transfer Anda, bukan menggunakan kredensial pengguna. Untuk informasi selengkapnya tentang menggunakan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

  13. 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 topik Anda atau klik Create a topic. Opsi ini mengonfigurasi notifikasi operasi Pub/Sub atas transfer yang dilakukan.

  14. Klik Simpan.

bq

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

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

Flag berikut bersifat opsional:

  • --project_id: Menentukan project yang akan digunakan. Jika flag tersebut tidak ditentukan, project default akan digunakan.
  • --table_filter: Menentukan tabel yang akan disertakan dalam transfer. Jika flag tidak ditentukan, semua tabel akan disertakan. Untuk menyertakan tabel tertentu saja, gunakan daftar nilai yang dipisahkan koma (misalnya, Ad, Campaign, AdGroup). Untuk mengecualikan tabel tertentu, awali nilai dengan tanda hubung (-) (misalnya, -Ad, Campaign, AdGroup).
  • --service_account_name - Menentukan akun layanan yang akan digunakan untuk autentikasi transfer Search Ads 360, bukan akun pengguna Anda.
bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source \
--service_account_name=service_account_name

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. Contoh: --params='{"param":"param_value"}'. Anda harus menyediakan parameter customer_id.
  • data_source: sumber data — search_ads.
  • service_account_name adalah nama akun layanan yang digunakan untuk mengautentikasi transfer. Akun layanan harus dimiliki oleh project_id yang sama dengan yang digunakan untuk membuat transfer dan harus memiliki semua izin yang diperlukan.

Misalnya, perintah berikut membuat transfer Search Ads 360 bernama My Transfer menggunakan ID Pelanggan 123-123-1234 dan set data target mydataset. Transfer dibuat di project default:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"customer_id":"123-123-1234"}' \
--data_source=search_ads

Saat pertama kali menjalankan perintah ini, 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.

Memicu transfer Search Ads 360 secara manual

Saat Anda memicu transfer secara manual untuk Search Ads 360, snapshot tabel pencocokan diambil sekali sehari dan disimpan dalam partisi untuk tanggal terakhir dijalankan. Saat Anda memicu transfer manual, snapshot Tabel Pencocokan untuk tabel berikut tidak diperbarui:

  • Akun
  • Ad
  • AdGroup
  • AdGroupCriterion
  • Semua tabel pemetaan ID
  • Asset
  • BidStrategy
  • Campaign
  • CampaignCriterion
  • ConversionAction
  • Keyword
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup

Dukungan untuk akun pengelola Search Ads 360

Menggunakan akun pengelola Search Ads 360 memberikan beberapa manfaat dibandingkan penggunaan ID Pelanggan individual:

  • Anda tidak perlu mengelola beberapa transfer untuk melaporkan beberapa ID Pelanggan.
  • Kueri lintas pelanggan lebih mudah ditulis karena semua ID Pelanggan disimpan dalam tabel yang sama.
  • Menggunakan akun pengelola akan mengurangi masalah kuota pemuatan BigQuery Data Transfer Service karena beberapa ID Pelanggan dimuat di tugas yang sama.

Untuk pelanggan lama yang memiliki beberapa transfer Search Ads 360 khusus ID Pelanggan, sebaiknya Anda beralih ke akun pengelola Search Ads 360. Anda dapat melakukannya melalui langkah-langkah berikut:

  1. Siapkan satu transfer Search Ads 360 di tingkat akun pengelola atau sub-pengelola.
  2. Jadwalkan pengisian ulang.
  3. Nonaktifkan transfer Search Ads 360 khusus ID Pelanggan individual.

Untuk informasi selengkapnya tentang akun pengelola Search Ads 360, lihat Tentang akun pengelola di Search Ads 360 versi baru dan Melihat cara akun ditautkan ke akun pengelola.

Contoh

Daftar berikut menunjukkan ID Pelanggan yang ditautkan ke akun pengelola Search Ads 360 tertentu:

  • 1234567890 — akun pengelola root
    • 1234 — akun sub-pengelola
      • 1111 — ID Pelanggan
      • 2222 — ID Pelanggan
      • 3333 — ID Pelanggan
      • 4444 — ID Pelanggan
      • 567 — akun sub-pengelola
        • 5555 — ID Pelanggan
        • 6666 — ID Pelanggan
        • 7777 — ID Pelanggan
    • 89 — akun sub-pengelola
      • 8888 — ID Pelanggan
      • 9999 — ID Pelanggan
    • 0000 — ID Pelanggan

Setiap ID Pelanggan yang ditautkan ke akun pengelola akan muncul di setiap laporan. Untuk mengetahui informasi selengkapnya tentang struktur pelaporan Search Ads 360 di BigQuery Data Transfer Service, lihat transformasi laporan Search Ads 360.

Konfigurasi transfer untuk ID Pelanggan 1234567890

Konfigurasi transfer untuk akun pengelola root (ID Pelanggan 1234567890) akan menghasilkan proses transfer yang menyertakan ID Pelanggan berikut:

  • 1111 (melalui akun sub-pengelola 1234)
  • 2222 (melalui akun sub-pengelola 1234)
  • 3333 (melalui akun sub-pengelola 1234)
  • 4444 (melalui akun sub-pengelola 1234)
  • 5555 (melalui akun sub-pengelola 567 dan akun sub-pengelola 1234)
  • 6666 (melalui akun sub-pengelola 567 dan akun sub-pengelola 1234)
  • 7777 (melalui akun sub-pengelola 567 dan akun sub-pengelola 1234)
  • 8888 (melalui akun sub-pengelola 89)
  • 9999 (melalui akun sub-pengelola 89)
  • 0000 (ID Pelanggan individual)

Konfigurasi transfer untuk ID Pelanggan 1234

Konfigurasi transfer untuk akun sub-pengelola 123 (ID Pelanggan 1234) menghasilkan proses transfer yang menyertakan ID Pelanggan berikut:

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (melalui akun sub-pengelola 567)
  • 6666 (melalui akun sub-pengelola 567)
  • 7777 (melalui akun sub-pengelola 567)

Konfigurasi transfer untuk ID Pelanggan 567

Konfigurasi transfer untuk akun sub-pengelola 567 (ID Pelanggan 567) menghasilkan proses transfer yang menyertakan ID Pelanggan berikut:

  • 5555
  • 6666
  • 7777

Konfigurasi transfer untuk ID Pelanggan 89

Konfigurasi transfer untuk akun sub-pengelola 89 (ID Pelanggan 89) menghasilkan proses transfer yang menyertakan ID Pelanggan berikut:

  • 8888
  • 9999

Konfigurasi transfer untuk ID Pelanggan 0000

Konfigurasi transfer untuk ID Pelanggan 0000 menghasilkan proses transfer yang hanya menyertakan ID Pelanggan individual:

  • 0000

Membuat kueri terhadap data

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

Jika membuat kueri tabel secara langsung, bukan menggunakan tabel virtual yang dihasilkan secara otomatis, Anda harus menggunakan kolom semu _PARTITIONTIME dalam kueri. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri tabel berpartisi.

Contoh kueri Search Ads 360

Anda dapat menggunakan contoh kueri Search Ads 360 berikut untuk menganalisis data yang ditransfer. Anda juga dapat melihat kueri dalam alat visualisasi seperti Looker Studio.

Kueri berikut adalah contoh untuk mulai membuat kueri data Search Ads 360 Anda dengan BigQuery Data Transfer Service. Untuk pertanyaan lain tentang apa yang dapat Anda lakukan dengan laporan ini, hubungi perwakilan teknis Search Ads 360 Anda.

Jika membuat kueri tabel secara langsung, bukan menggunakan tabel virtual yang dihasilkan secara otomatis, Anda harus menggunakan kolom semu _PARTITIONTIME dalam kueri. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri tabel berpartisi.

Performa kampanye

Contoh kueri berikut menganalisis performa kampanye Search Ads 360 selama 30 hari terakhir.

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Ganti kode berikut:

  • DATASET: nama set data
  • CUSTOMER_ID: ID pelanggan Search Ads 360

Jumlah kata kunci

Contoh kueri berikut menganalisis kata kunci berdasarkan kampanye, grup iklan, dan status kata kunci.

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

Ganti kode berikut:

  • DATASET: nama set data
  • CUSTOMER_ID: ID pelanggan Search Ads 360

Tabel pemetaan ID

Entity di Search Ads 360 versi baru, seperti pelanggan, kampanye, dan grup iklan, memiliki ruang ID yang berbeda dari Search Ads 360 versi terdahulu. Untuk pengguna transfer Search Ads 360 lama yang ingin menggabungkan data dari Search Ads 360 versi lama dengan Search Ads 360 API versi baru, Anda dapat menggunakan BigQuery Data Transfer Service untuk mentransfer tabel pemetaan ID jika Anda berikan ID agensi dan ID pengiklan yang valid dalam konfigurasi transfer.

Entity yang didukung berisi dua kolom, legacy_id dan new_id, yang masing-masing menentukan pemetaan ID untuk entity di Search Ads 360 versi lama dan baru. Berikut adalah daftar tabel pemetaan ID.

  • IdMapping_AD
  • IdMapping_AD_GROUP
  • IdMapping_CAMPAIGN
  • IdMapping_CAMPAIGN_CRITERION
  • IdMapping_CAMPAIGN_GROUP
  • IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
  • IdMapping_CRITERION
  • IdMapping_CUSTOMER
  • IdMapping_FEED_ITEM
  • IdMapping_FEED_TABLE

Contoh kueri

Kueri berikut menggunakan tabel pemetaan ID untuk menggabungkan metrik per kampanye di seluruh tabel dari transfer Search Ads 360 versi terdahulu dan versi baru dalam ruang ID yang baru.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Ganti kode berikut:

  • DATASET: nama set data
  • CUSTOMER_ID: ID pelanggan Search Ads 360
  • ADVERTISER_ID: ID pengiklan Search Ads 360
  • NEW_DATA_DATE: tanggal data untuk tabel Search Ads 360 versi baru
  • OLD_DATA_DATE: tanggal data untuk tabel Search Ads 360 versi terdahulu

Kueri berikut menggunakan tabel pemetaan ID untuk menggabungkan metrik per kampanye di seluruh tabel dari transfer Search Ads 360 versi terdahulu dan versi baru di ruang ID lama.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Ganti kode berikut:

  • DATASET: nama set data
  • CUSTOMER_ID: ID pelanggan Search Ads 360
  • ADVERTISER_ID: ID pengiklan Search Ads 360
  • NEW_DATA_DATE: tanggal data untuk tabel Search Ads 360 versi baru
  • OLD_DATA_DATE: tanggal data untuk tabel Search Ads 360 versi terdahulu

Potensi masalah kuota

Search Ads 360 Reporting API menetapkan kuota harian untuk jumlah permintaan yang dapat dikirim project Google. Jika Anda menggunakan satu project untuk BigQuery Data Transfer Service dan layanan lainnya, semua layanan berbagi kuota yang sama dan berpotensi mencapai batas kuota di layanan mana pun.

Untuk mencegah masalah potensial ini tanpa memengaruhi alur kerja yang ada, pertimbangkan opsi berikut:

  • Siapkan project terpisah untuk BigQuery Data Transfer Service. Penggabungan tabel lintas project mungkin terlihat seperti berikut:

      #standardSQL
      select count(a.item1)
      from (select item1, item2 from project-A.data_set_a.table_name_a) a
      inner join
      (select item3, item4 from project-B.data_set_b.table_name_b) b
      on a.item1 = b.item3
    

  • Hubungi dukungan Search Ads 360 dan minta kuota tambahan.