Transfer Search Ads 360

Dengan konektor 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:

• Laporan Search Ads 360 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	Dukungan
Versi API yang didukung	v0
Frekuensi pengulangan	Harian, pada saat transfer data pertama kali dibuat (default) Anda dapat mengonfigurasi waktu pada hari itu.
Jendela refresh	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 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 refresh dipetakan ke kolom API TransferConfig.data_refresh_window_days.

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

Batasan

• Frekuensi maksimum yang dapat Anda konfigurasikan untuk transfer data Search Ads 360 adalah sekali setiap 24 jam. Secara default, transfer dimulai saat Anda membuat transfer. Namun, Anda dapat mengonfigurasi waktu mulai transfer data saat membuat transfer.
• BigQuery Data Transfer Service tidak mendukung transfer data 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 data Search Ads 360:

• Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
• Buat set data BigQuery Data Transfer Service untuk menyimpan data pelaporan Search Ads 360.
• Jika ingin menyiapkan notifikasi proses transfer untuk Pub/Sub, Anda harus memiliki izin pubsub.topics.setIamPolicy. Izin Pub/Sub tidak diperlukan jika Anda baru saja menyiapkan notifikasi email. Untuk mengetahui informasi selengkapnya, lihat Notifikasi operasi BigQuery Data Transfer Service.
• Aktifkan akses ke Search Ads 360 Reporting API di project Anda.

Izin yang diperlukan

Pastikan pengguna yang membuat transfer data memiliki izin yang diperlukan berikut:

• BigQuery Data Transfer Service:

  • Izin bigquery.transfers.update untuk membuat transfer data.
  • 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 Data transfers di konsol Google Cloud.

   Buka Data transfers

2. Klik Create transfer.

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

4. Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer data, seperti 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 seberapa sering transfer data 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.

   1. Di bagian Data source details:

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

   3. Opsional: Masukkan ID Agensi dan ID Pengiklan untuk mengambil tabel pemetaan ID.

   4. Opsional: Di kolom Custom Floodlight Variables, masukkan variabel Floodlight kustom yang akan disertakan dalam transfer data. Variabel Floodlight kustom harus dimiliki oleh akun Search Ads 360 yang ditentukan oleh ID Pelanggan di konfigurasi transfer. Parameter ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa variabel Floodlight kustom. Di setiap item array JSON, parameter berikut diperlukan:

      • id: ID numerik variabel Floodlight kustom. ID ini ditetapkan saat variabel Floodlight kustom dibuat di Search Ads 360. Jika Anda telah menentukan id, name tidak diperlukan.
      • name: nama variabel floodlight kustom yang ditentukan pengguna di Search Ads 360. Jika Anda telah menentukan name, id tidak diperlukan.
      • cfv_field_name: nama kolom variabel Floodlight kustom yang tepat berdasarkan kasus penggunaan Anda. Nilai yang didukung adalah conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics, dan raw_event_conversion_dimensions.
      • destination_table_name: daftar tabel BigQuery untuk menyertakan variabel floodlight kustom. Saat BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer akan menyertakan variabel Floodlight kustom dalam kueri.

      • bigquery_column_name_suffix: nama kolom yang mudah dibaca dan ditentukan pengguna. BigQuery Data Transfer Service menambahkan akhiran setelah nama kolom standar untuk membedakan berbagai variabel Floodlight kustom. Bergantung pada kasus penggunaan, BigQuery Data Transfer Service akan menghasilkan nama kolom BigQuery sebagai berikut:

        	Variabel Floodlight kustom sebagai metrik dan segmen	Variabel Floodlight kustom sebagai Atribut Peristiwa Mentah di Resource Konversi
        metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
        dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      Berikut adalah contoh entri Custom Floodlight Variable yang menentukan dua variabel Floodlight kustom:

      [{
        "id": "1234",
        "cfv_field_name": "raw_event_conversion_metrics",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name_suffix": "suffix1"
      },{
        "name": "example name",
        "cfv_field_name": "conversion_custom_metrics",
        "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
        "bigquery_column_name_suffix": "suffix2"
      }]

   5. Opsional: Di kolom Custom Columns, masukkan kolom kustom yang akan disertakan dalam transfer data. Kolom kustom harus dimiliki oleh akun Search Ads 360 yang ditentukan oleh ID Pelanggan di konfigurasi transfer. Kolom ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa kolom. Di setiap item array JSON, parameter berikut diperlukan:

      • id: ID numerik kolom kustom. ID ini ditetapkan saat kolom kustom dibuat. Jika Anda telah menentukan id, name tidak diperlukan.
      • name: nama kolom kustom yang ditentukan pengguna di Search Ads 360. Jika Anda telah menentukan name, id tidak diperlukan.
      • destination_table_name: daftar tabel BigQuery yang akan menyertakan kolom kustom. Saat BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer akan menyertakan kolom kolom kustom dalam kueri.
      • bigquery_column_name: nama kolom yang mudah dipahami yang ditentukan pengguna. Ini adalah nama kolom kustom di tabel tujuan yang ditentukan di destination_table_name. Nama kolom harus mengikuti persyaratan format untuk nama kolom BigQuery dan harus unik untuk kolom lain dalam skema standar tabel atau kolom kustom lainnya.

      Berikut adalah contoh entri Custom Columns yang menentukan dua kolom kustom:

        [{
          "id": "1234",
          "destination_table_name": ["Conversion"],
          "bigquery_column_name": "column1"
        },{
          "name": "example name",
          "destination_table_name": ["AdGroupStats","CampaignStats"],
          "bigquery_column_name": "column2"
        }]
        

   6. Opsional: Di kolom Filter Tabel, 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.

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

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

   • Jika Anda login dengan identitas gabungan, akun layanan diperlukan untuk membuat transfer. Jika Anda login dengan Akun Google, akun layanan untuk transfer bersifat opsional.
   • Akun layanan harus memiliki izin yang diperlukan.

8. 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.

9. Klik Save.

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.
• --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 \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Dengan keterangan:

• PROJECT_ID (Opsional): menentukan project yang akan digunakan. Jika flag tersebut tidak ditentukan, project default akan digunakan.
• DATASET: set data target untuk konfigurasi transfer.

• NAME: nama tampilan untuk konfigurasi transfer. Nama transfer data dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.

• DATA_SOURCE: sumber data — search_ads.

• SERVICE_ACCOUNT_NAME (Opsional): nama akun layanan yang digunakan untuk mengautentikasi transfer data Anda. Akun layanan harus dimiliki oleh project_id yang sama yang digunakan untuk membuat transfer dan harus memiliki semua izin yang diperlukan.

• PARAMETERS: parameter untuk konfigurasi transfer yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'. Anda harus menyediakan parameter customer_id.

  • table_filter: Menentukan tabel yang akan disertakan dalam transfer data. 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 yang dikecualikan dengan tanda hubung (-) (misalnya, menggunakan -Ad, Campaign, AdGroup akan mengecualikan ketiga nilai tersebut.)
  • custom_columns: menentukan kolom kustom ke laporan Anda. Parameter ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa kolom. Di setiap item array JSON, parameter berikut diperlukan:
    • CC_ID: ID numerik kolom kustom. ID ini ditetapkan saat kolom kustom dibuat.
    • CC_DESTINATION_TABLE: daftar tabel BigQuery untuk menyertakan kolom kustom. Saat BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer data akan menyertakan kolom kolom kustom dalam kueri.
    • CC_COLUMN: nama kolom yang mudah dipahami yang ditentukan pengguna. Ini adalah nama kolom kustom di tabel tujuan yang ditentukan dalam destination_table_name. Nama kolom harus mengikuti persyaratan format untuk nama kolom BigQuery dan harus unik untuk kolom lain dalam skema standar tabel atau kolom kustom lainnya.
  • custom_floodlight_variables: Menentukan variabel Floodlight kustom dalam transfer Anda. Parameter ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa variabel Floodlight kustom. Di setiap item array JSON, parameter berikut diperlukan:
    • CFV_ID: ID numerik variabel Floodlight kustom. ID ini ditetapkan saat variabel Floodlight kustom dibuat di Search Ads 360.
    • CFV_FIELD_NAME: nama kolom variabel Floodlight kustom yang tepat berdasarkan kasus penggunaan Anda. Nilai yang didukung adalah conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics, dan raw_event_conversion_dimensions. Untuk informasi selengkapnya, lihat Metrik Floodlight kustom.
    • CFV_DESTINATION_TABLE: daftar tabel BigQuery untuk menyertakan variabel floodlight kustom. Saat BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer data akan menyertakan variabel Floodlight kustom dalam kueri.
    • CFV_COLUMN_SUFFIX: nama kolom yang mudah dipahami yang ditentukan pengguna. BigQuery Data Transfer Service menambahkan akhiran setelah nama kolom standar untuk membedakan berbagai variabel Floodlight kustom. Bergantung pada kasus penggunaan, BigQuery Data Transfer Service akan membuat nama kolom BigQuery sebagai berikut:

  	Variabel Floodlight kustom sebagai metrik dan segmen	Variabel Floodlight kustom sebagai Atribut Peristiwa Mentah di Resource Konversi
  metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
  dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Perhatian: Anda tidak dapat mengonfigurasi notifikasi menggunakan alat command line.

Misalnya, perintah berikut akan membuat transfer data Search Ads 360 bernama My Transfer menggunakan ID Pelanggan 6828088731 dan set data target mydataset. Transfer juga menentukan variabel Floodlight kustom. Transfer data dibuat di project default:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

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 pada command line.

Perhatian: Saat Anda membuat transfer data Search Ads 360 menggunakan alat command line, konfigurasi transfer akan disiapkan menggunakan nilai default untuk Jadwal (setiap 24 jam pada waktu pembuatan) dan Periode pemuatan ulang (0 — mengonfigurasi periode pemuatan ulang default 7 hari).

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 data 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 data 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 data 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.

Catatan: BigQuery Data Transfer Service mengambil laporan untuk semua ID Pelanggan yang tercantum, tetapi Anda mungkin tidak melihat ID Pelanggan dalam laporan jika tidak melaporkan aktivitas untuk hari yang diminta.

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 data 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 data 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 data 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 data yang menyertakan ID Pelanggan berikut:

• 8888
• 9999

Konfigurasi transfer untuk ID Pelanggan 0000

Konfigurasi transfer untuk ID Pelanggan 0000 menghasilkan proses transfer data 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. Untuk entity AD, CAMPAIGN_CRITERION, dan CRITERION, new_secondary_id juga diberikan karena entity ini tidak memiliki ID unik secara global di Search Ads 360 versi 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

Catatan: Serupa dengan tabel pencocokan, snapshot tabel pemetaan ID diambil sekali sehari dan disimpan di partisi untuk tanggal terakhir dijalankan. Snapshot tabel pemetaan ID tidak diperbarui untuk pengisian ulang atau selama hari yang dimuat menggunakan periode pemuatan ulang.

Contoh kueri

Kueri berikut menggunakan tabel pemetaan ID untuk menggabungkan metrik per kampanye di seluruh tabel dari transfer data 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 data 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.