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:

• 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	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 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 pada hari yang sama atau menjalankan pengisian ulang tidak akan 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:

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

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.

   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 Variabel Floodlight Kustom, masukkan variabel Floodlight kustom untuk disertakan dalam transfer. Parameter ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa variabel Floodlight kustom. Parameter berikut diperlukan di setiap item array JSON:

      • 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.
      • destination_table_name: daftar tabel BigQuery untuk menyertakan variabel Floodlight kustom. Saat BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer tersebut akan menyertakan variabel Floodlight kustom dalam kueri.

      • bigquery_column_name_suffix: nama kolom mudah yang ditentukan pengguna. BigQuery Data Transfer Service menambahkan akhiran setelah nama kolom standar untuk membedakan variabel Floodlight kustom yang berbeda. Bergantung pada kasus penggunaannya, BigQuery Data Transfer Service 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 Variabel Floodlight Kustom yang menentukan dua variabel Floodlight kustom:

      [{
        "id": "1234",
        "cfv_field_name": "raw_event_conversion_metrics",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name_suffix": "suffix1"
      },{
        "id": "5678",
        "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 apa pun yang akan disertakan dalam transfer. Kolom ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa kolom. Parameter berikut diperlukan dalam setiap item array JSON:

      • id: ID numerik kolom kustom. ID ini ditetapkan saat kolom kustom dibuat. Jika Anda telah menentukan id, name tidak diperlukan.
      • name: nama kolom kustom buatan pengguna di Search Ads 360. Jika Anda telah menentukan name, id tidak diperlukan.
      • destination_table_name: daftar tabel BigQuery untuk 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 ditentukan oleh pengguna. Ini adalah nama kolom 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 Anda, 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.
• --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 \
--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 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 Anda. Akun layanan harus dimiliki oleh project_id yang sama dengan 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.

  • custom_columns: menentukan kolom kustom ke laporan Anda. Parameter ini menggunakan input string dalam format array JSON dan dapat mendukung beberapa kolom. Parameter berikut diperlukan di setiap item array JSON:
    • 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 akan menyertakan kolom kolom kustom dalam kueri.
    • CC_COLUMN: nama kolom yang mudah ditentukan oleh pengguna. Ini adalah nama kolom 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.
  • 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. Parameter berikut diperlukan di setiap item array JSON:
    • 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. Jika BigQuery Data Transfer Service mengambil data untuk tabel ini, transfer akan menyertakan variabel Floodlight kustom dalam kueri.
    • CFV_COLUMN_SUFFIX: nama kolom yang mudah ditentukan oleh pengguna. BigQuery Data Transfer Service menambahkan akhiran setelah nama kolom standar untuk membedakan berbagai variabel Floodlight kustom. Bergantung pada kasus penggunaannya, BigQuery Data Transfer Service 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

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

Misalnya, perintah berikut membuat transfer Search Ads 360 bernama My Transfer menggunakan ID Pelanggan 6828088731 dan set data target mydataset. Transfer tersebut juga menentukan variabel Floodlight kustom. Transfer dilakukan 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 di command line.

Perhatian: Saat Anda membuat transfer 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
• Kunjungi

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.

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 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. Untuk entitas AD, CAMPAIGN_CRITERION, dan CRITERION, new_secondary_id juga disediakan karena entitas ini tidak memiliki ID unik 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 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.