Muat data iklan Google Ads ke BigQuery.

Anda dapat memuat data dari Google Ads (sebelumnya dikenal sebagai Google AdWords) ke BigQuery menggunakan konektor BigQuery Data Transfer Service untuk Google Ads. Dengan BigQuery Data Transfer Service, Anda dapat menjadwalkan pekerjaan transfer berulang yang menambahkan data terbaru dari Google Ads Anda ke BigQuery.

Untuk mempelajari tentang perubahan sumber data terbaru, lihat Log perubahan sumber data BigQuery Data Transfer Service.

Ringkasan konektor

BigQuery Data Transfer Service untuk konektor Google Ads mendukung opsi berikut untuk transfer data Anda.

Opsi transfer data	Dukungan
Laporan yang didukung	Konektor Google Ads mendukung transfer data dari laporan di Google Ads API v23. Untuk mengetahui informasi tentang cara laporan Google Ads diubah menjadi tabel dan tampilan BigQuery, lihat Transformasi laporan Google Ads.
Frekuensi pengulangan	Konektor Google Ads mendukung transfer data harian. Secara default, transfer data dijadwalkan pada saat transfer data dibuat. Anda dapat mengonfigurasi waktu transfer data saat menyiapkan transfer data.
Frekuensi pemuatan ulang	Anda dapat menjadwalkan transfer data untuk mengambil data Google Ads hingga 30 hari pada saat transfer data dijalankan. Anda dapat mengkonfigurasi durasi jendela penyegaran saat Anda menyiapkan transfer data. Secara default, konektor Google Ads memiliki periode refresh 7 hari. Untuk mengetahui informasi selengkapnya, lihat Memuat ulang jendela. 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.
Ketersediaan data isi ulang	Jalankan pengisian data mundur untuk mengambil data di luar transfer data terjadwal Anda. Anda dapat mengambil data hingga ke periode waktu yang diizinkan oleh kebijakan penyimpanan data pada sumber data Anda. Untuk mengetahui informasi tentang kebijakan retensi data untuk Google Ads, lihat Kebijakan Retensi Data Google Ads.
Jumlah ID Pelanggan per akun pengelola	8.000 BigQuery Data Transfer Service mendukung maksimum 8.000 ID Pelanggan untuk setiap akun pengelola (MCC) Google Ads.

Untuk memetakan laporan Google Ads dengan informasi yang Anda lihat di UI Google Ads, lihat Memetakan laporan ke UI Google Ads.

Pengambilan data dari transfer Google Ads

Saat Anda mentransfer data dari Google Ads 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 data mundur tidak menghasilkan data duplikat, dan partisi untuk tanggal lain tidak terpengaruh.

Segarkan jendela

Jendela penyegaran adalah jumlah hari yang dibutuhkan 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, ketika transfer harian terjadi, Layanan Transfer Data BigQuery membuat partisi tabel tujuan BigQuery baru dengan salinan data tabel sumber Anda dari hari ini, kemudian secara otomatis memicu proses 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 menggantikan atau memperbarui tabel tujuan BigQuery secara inkremental, bergantung pada apakah pembaruan 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 pembaruan. Sebagai contoh, jika jendela pembaruan adalah tiga hari dan Anda menjalankan transfer data untuk pertama kalinya, Layanan Transfer Data BigQuery akan mengambil semua data sumber dalam waktu tiga hari.

Untuk mengambil data di luar jendela penyegaran, seperti data historis, atau untuk memulihkan data dari gangguan atau jeda transfer, Anda dapat memulai atau menjadwalkan proses pengisian ulang.

Batasan

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

Sebelum memulai

Sebelum membuat transfer data Google Ads, lakukan hal berikut:

• Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
• Buat set data BigQuery Data Transfer Service untuk menyimpan data Google Ads.
• Jika ingin menyiapkan notifikasi operasi transfer untuk Pub/Sub, pastikan Anda memiliki izin pubsub.topics.setIamPolicy. Izin Pub/Sub tidak diperlukan jika Anda menyiapkan notifikasi email. Untuk informasi selengkapnya, lihat Notifikasi operasi BigQuery Data Transfer Service.

Izin yang diperlukan

Pastikan Anda telah memberikan izin berikut.

Peran BigQuery yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat transfer data BigQuery Data Transfer Service, minta administrator untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat transfer data BigQuery Data Transfer Service. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat transfer data BigQuery Data Transfer Service:

• Izin BigQuery Data Transfer Service:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Izin BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya, lihat Memberikan akses bigquery.admin.

Peran Google Ads yang diperlukan

Anda harus memberikan akses baca ke ID Pelanggan atau akun pengelola (MCC) Google Ads yang digunakan dalam konfigurasi transfer. Saat Anda membuat konfigurasi transfer baru yang diotorisasi dengan kredensial pengguna individual, Anda harus mengaktifkan Verifikasi 2 Langkah.

Untuk mengotorisasi akun layanan untuk transfer data Google Ads Anda, kami menyarankan agar Anda memberikan akses langsung ke akun Google Ads kepada akun layanan tersebut. Untuk mengetahui informasi selengkapnya, lihat Otorisasi dengan akses akun langsung. Persyaratan otentikasi multi-faktor (MFA), seperti Verifikasi 2 Langkah, tidak diperlukan untuk konfigurasi transfer yang diotorisasi dengan akun layanan.

Membuat transfer data Google Ads

Untuk membuat transfer data untuk pelaporan Google Ads, Anda memerlukan ID pelanggan Google Ads atau akun pengelola (MCC). Untuk mendapatkan informasi tentang cara mengambil ID pelanggan Google Ads Anda, lihat Menemukan ID Pelanggan Anda.

Untuk membuat transfer data untuk pelaporan Google Ads, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Transfer data di konsol Google Cloud .

   Buka Data transfers

2. Klik Create transfer.

3. Di bagian Source type, untuk Source, pilih Google Ads.

4. Di bagian Data source details:

   1. Untuk ID Pelanggan, masukkan ID pelanggan Google Ads Anda.
   2. Untuk Jenis laporan, pilih salah satu dari Standar atau Kustom.
      • Jika Anda telah memilih Standar, transfer akan menyertakan kumpulan laporan dan kolom standar seperti yang dijelaskan dalam Transformasi laporan Google Ads.
        • Opsional: Pilih opsi untuk mengecualikan item yang dihapus atau dinonaktifkan, dan menyertakan tabel yang baru untuk Google Ads.
        • 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.
        • Opsional: Pilih opsi untuk menyertakan tabel khusus untuk laporan Performa Maksimal. Untuk mengetahui informasi selengkapnya tentang dukungan Performa Maksimal, lihat Dukungan Performa Maksimal.
        • Opsional: Untuk Periode pemuatan ulang, masukkan nilai antara 1 dan 30.
      • Jika Anda telah memilih Kustom, masukkan tabel output dan kueri Google Ads untuk setiap laporan kustom yang ingin Anda sertakan dalam transfer ini.
        • Opsional: Klik Tambahkan kueri untuk menambahkan laporan kustom baru.
        • Opsional: Untuk Periode pemuatan ulang, masukkan nilai antara 1 dan 30.

5. Di bagian Destination settings, untuk Dataset, pilih set data yang Anda buat untuk menyimpan data Anda.

6. Pada bagian Nama konfigurasi transfer, untuk Nama tampilan, masukkan nama untuk transfer data seperti My Transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.

7. Di bagian Schedule options:

   • Untuk Frekuensi pengulangan, pilih opsi seberapa sering transfer data dijalankan. Jika Anda memilih Days, berikan waktu yang valid dalam UTC.
     • Jam
     • Hari
     • Sesuai permintaan
   • Jika berlaku, pilih Mulai sekarang atau Mulai pada waktu yang ditentukan, dan berikan tanggal mulai dan waktu berjalan.

8. Di menu Service Account, pilih akun layanan dari akun layanan yang terkait dengan project Google Cloud Anda. Anda dapat mengaitkan akun layanan dengan transfer data Anda sebagai pengganti penggunaan kredensial pengguna Anda. Untuk informasi selengkapnya tentang penggunaan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

   • Jika Anda masuk denganidentitas federasi , maka akun layanan diperlukan untuk membuat transfer. Jika Anda login dengan Akun Google, maka akun layanan untuk transfer bersifat opsional.
   • Akun layanan harus memilikiizin yang diperlukan.

9. Opsional: Di bagian Notification options:

   • Klik tombol untuk mengaktifkan notifikasi email. Saat Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email jika 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.

10. 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 mana 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 dengan tanda hubung (-) (misalnya, -Ad, Campaign, AdGroup).
• --schedule: Menentukan seberapa sering kueri dijalankan. Jika Anda tidak menentukan --schedule, defaultnya ditetapkan ke every 24 hours. Untuk informasi tentang sintaksis jadwal, lihat Memformat jadwal.
• --refresh_window_days: Menentukan jendela penyegaran untuk konfigurasi transfer dalam hitungan hari. Nilai defaultnya adalah 7.
• --service_account_name: Menentukan akun layanan yang akan digunakan untuk autentikasi transfer Google Ads, bukan akun pengguna Anda.
• --include_pmax: Tentukan true untuk menyertakan tabel khusus untuk laporan Performa Maksimal. Nilai defaultnya adalah false. Untuk mengetahui informasi selengkapnya tentang dukungan Performa Maksimal, lihat Dukungan Performa Maksimal.

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--params='PARAMETERS' \
--data_source=DATA_SOURCE \
--table_filter=TABLES \
--schedule=SCHEDULE \
--refresh_window_days=REFRESH_DAYS \
--service_account_name=SERVICE_ACCOUNT_NAME \
--include_pmax=PMAX_ENABLE

Dengan:

• PROJECT_ID adalah project ID Anda.
• DATASET adalah set data target untuk konfigurasi transfer data.
• NAME adalah nama tampilan untuk konfigurasi transfer data. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
• PARAMETERS berisi parameter JSON berikut untuk konfigurasi transfer: --params='{"param":"param_value"}'.
  • customer_id: masukkan ID pelanggan Google Ads Anda dalam format 1231231234 atau 123-123-1234. Kolom ini wajib diisi.
  • custom_report_table_names (opsional): daftar nama tabel untuk laporan kustom yang disertakan dalam transfer ini. Daftar ini sesuai dengan kueri di custom_report_queries. Panjang daftar ini harus sama dengan panjang daftar di custom_report_queries.
  • custom_report_queries (opsional): daftar kueri Google Ads Query Language (GAQL) untuk laporan kustom yang disertakan dalam transfer ini. Daftar ini sesuai dengan nama di custom_report_table_names. Panjang daftar ini harus sama dengan panjang daftar di custom_report_table_names.
  • exclude_removed_items (opsional): tetapkan parameter ini ke true agar entitas dan metrik yang dihapus atau dinonaktifkan tidak ditransfer.
• DATA_SOURCE adalah sumber data — google_ads.
• TABLES adalah daftar tabel yang dipisahkan koma yang akan disertakan atau dikecualikan dari transfer data.
• SCHEDULE adalah seberapa sering Anda ingin kueri dijalankan. Jika --schedule tidak ditentukan, defaultnya adalah setiap 24 jam, dimulai dari waktu transfer dibuat.
• REFRESH_DAYS adalah bilangan bulat yang menentukan periode refresh untuk konfigurasi transfer dalam hari. Nilai defaultnya adalah 7.
• SERVICE_ACCOUNT_NAME adalah nama akun layanan yang digunakan untuk mengautentikasi transfer Anda. Akun layanan harus dimiliki oleh project_id yang sama yang digunakan untuk membuat transfer dan harus memiliki semua izin yang diperlukan.
• PMAX_ENABLE: Tentukan true untuk menyertakan tabel khusus untuk laporan Performa Maksimal. Nilai defaultnya adalah false. Untuk informasi selengkapnya tentang dukungan PMax, lihat Dukungan PMax

Perhatian: Anda tidak dapat mengkonfigurasi notifikasi menggunakan alat baris perintah.

Sebagai contoh, perintah berikut membuat transfer data Google Ads bernama My Transfer menggunakan ID Pelanggan 123-123-1234 dan kumpulan data target mydataset. Transfer data dibuat di proyek default:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' \
--data_source=google_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 pada command line.

API

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

Java

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Java API.

Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create ads(formerly AdWords) transfer config
public class CreateAdsTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    // the customer_id only allows digits and hyphen ('-').
    String customerId = "012-345-6789";
    String refreshWindow = "100";
    Map<String, Value> params = new HashMap<>();
    params.put("customer_id", Value.newBuilder().setStringValue(customerId).build());
    params.put("refreshWindow", Value.newBuilder().setStringValue(refreshWindow).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Ads Transfer Config Name")
            .setDataSourceId("adwords")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createAdsTransfer(projectId, transferConfig);
  }

  public static void createAdsTransfer(String projectId, TransferConfig transferConfig)
      throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println("Ads transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Ads transfer was not created." + ex.toString());
    }
  }
}

Memicu transfer Google Ads secara manual

Saat Anda memicu transfer secara manual untuk Google Ads, snapshot Tabel Pencocokan diambil sekali sehari dan disimpan di partisi untuk tanggal terakhir dijalankan. Saat Anda memicu transfer manual, snapshot Tabel Pencocokan untuk tabel berikut tidak diupdate:

• Ad
• AdGroup
• AdGroupAudience
• AdGroupBidModifier
• AdGroupAdLabel
• AdGroupCriterion
• AdGroupCriterionLabel
• AdGroupLabel
• AgeRange
• Asset
• AssetGroup
• AssetGroupAsset
• AssetGroupListingGroupFilter
• AssetGroupSignal
• Audience
• BidGoal
• Budget
• Campaign
• CampaignAudience
• CampaignCriterion
• CampaignLabel
• Customer
• Gender
• Keyword
• LocationBasedCampaignCriterion
• ParentalStatus
• Placement
• Video

Laporan kustom

Konektor BigQuery Data Transfer Service for Google Ads juga mendukung penggunaan laporan khusus menggunakan kueri Google Ads Query Language (GAQL) dalam konfigurasi transfer Google Ads. Laporan kustom ini menyerap data dari semua resource yang tersedia di versi Google Ads API yang didukung oleh BigQuery Data Transfer Service. Untuk informasi selengkapnya tentang penggunaan dan validasi kueri GAQL, lihat Google Ads Query Builder.

Anda dapat menentukan laporan kustom saat Membuat transfer Google Ads.

Batasan laporan kustom

Laporan kustom dengan konektor Google Ads tunduk pada batasan berikut:

• Konektor Google Ads tidak mendukung klausa WHERE, ORDER BY, LIMIT, dan PARAMETERS. Kueri GAQL Anda harus dalam format yang mirip dengan berikut ini: SELECT FIELD_NAME, FIELD_NAME,... FROM RESOURCE_NAME.
• Konektor Google Ads secara otomatis menambahkan WHERE segments.date = run_date ketika terdapat segmen tanggal inti (misalnya, segments.date, segments.week, segments.month, segments.quarter, segments.year) dalam kueri. Hal ini dapat menyebabkan Google Ads Query Validator mengembalikan kesalahan, misalnya, The filtering conditions in the WHERE clause must combine to form a valid, finite date range composed of the core date segments .... Anda dapat mengabaikan error ini dengan aman.
• Kueri GAQL tanpa kolom segments.date berfungsi sebagai tabel kecocokan, yang hanya diperbarui sekali sehari dan tidak didukung dalam proses pengisian ulang. Jika Anda ingin mengisi data yang hilang, Anda harus menyertakan kolom segments.date dalam kueri GAQL.
• Konektor Google Ads mendukung hingga 100 laporan kustom dalam satu transfer.
• Saat Anda menggunakan kolom tersegmentasi (misalnya, segments.ad_network_type atau segments.device) dalam kueri kustom, Google Ads API mengecualikan kampanye yang memiliki nol tayangan.

Kampanye Performa Maksimal (PMax)

Konektor Google Ads memungkinkan Anda mengekspor data kampanye Performa Maksimal. Anda harus memilih kotak centang Sertakan Tabel Kampanye Performa Maksimal saat membuat transfer data, karena data Performa Maksimal tidak diekspor secara default.

Menyertakan data Performa Maksimal akan menghapus kolom ad_group dari tabel tertentu dan menyertakan tabel baru. Anda tidak dapat menyertakan kolom ad_group karena Google Ads API memfilter data Performa Maksimal.

Tabel berikut mengecualikan kolom terkait ad_group saat kotak Include PMax Campaign Tables dicentang:

• GeoStats
• GeoConversionStats
• ShoppingProductConversionStats
• ShoppingProductStats
• LocationsUserLocationsStats

Tabel berikut ditambahkan jika kotak Include PMax Campaign Tables dicentang:

• Asset
• AssetGroup
• AssetGroupAsset
• AssetGroupListingGroupFilter
• AssetGroupSignal
• Audience
• AssetGroupProductGroupStats
• CampaignAssetStats

Dukungan untuk akun pengelola Google Ads

Pelanggan lama yang memiliki beberapa Transfer Google Ads khusus ID Pelanggan dianjurkan untuk menyiapkan satu Transfer Google Ads di tingkat Akun Pengelola (MCC), menjadwalkan pengisian ulang, dan menonaktifkan Transfer Google Ads khusus ID Pelanggan.

Menggunakan akun pengelola Google Ads akan memberikan beberapa manfaat dibandingkan penggunaan ID Pelanggan individual:

• Anda tidak perlu lagi mengelola banyak transfer data untuk membuat laporan tentang banyak ID Pelanggan.
• Kueri lintas-pelanggan jauh lebih mudah ditulis karena semua ID Pelanggan disimpan dalam tabel yang sama.
• Menggunakan MCC akan mengurangi masalah kuota pemuatan BigQuery Data Transfer Service karena beberapa ID Pelanggan dimuat di tugas yang sama.

Untuk informasi selengkapnya tentang akun pengelola Google Ads (MCC), lihat Menggunakan akun terkelola dan Tentang menautkan akun 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 ID tersebut tidak melaporkan aktivitas untuk hari yang diminta atau akun tidak aktif saat transfer berjalan.

Contoh

Daftar berikut menunjukkan ID Pelanggan yang ditautkan ke akun pengelola Google Ads 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 informasi selengkapnya mengenai struktur pelaporan Google Ads di BigQuery Data Transfer Service, lihat Transformasi laporan Google Ads.

Konfigurasi transfer untuk ID Pelanggan 1234567890

Konfigurasi transfer untuk akun pengelola root (ID Pelanggan 1234567890) akan menghasilkan proses transfer data yang mencakup 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) akan 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) akan 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) akan menghasilkan proses transfer data yang menyertakan ID Pelanggan berikut:

• 8888
• 9999

Konfigurasi transfer untuk ID Pelanggan 0000

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

• 0000

Memigrasikan data Google Ads ke MCC

Untuk memigrasikan data Google Ads yang ada di BigQuery Data Transfer Service ke struktur MCC, Anda dapat menyiapkan pengisian ulang untuk menambahkan data yang sudah ada ke tabel yang dibuat oleh konfigurasi transfer yang ditautkan ke akun pengelola. Perhatikan bahwa saat Anda menjadwalkan pengisian ulang, tabel pencocokan tidak akan diupdate.

Memecahkan masalah penyiapan transfer Google Ads

Jika Anda mengalami masalah saat menyiapkan transfer data, lihat Masalah transfer Google Ads di bagian Memecahkan masalah konfigurasi transfer.

Membuat kueri data Anda

Saat data Anda ditransfer ke BigQuery Data Transfer Service, data tersebut 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.

Kueri contoh Google Ads

Anda dapat menggunakan kueri contoh Google Ads berikut untuk menganalisis data yang ditransfer. Anda juga dapat menggunakan kueri dalam alat visualisasi seperti Data Studio. Kueri ini disediakan untuk membantu Anda mulai membuat kueri data Google Ads dengan BigQuery Data Transfer Service. Untuk pertanyaan tambahan mengenai apa yang dapat Anda lakukan dengan laporan ini, hubungi perwakilan teknis Google Ads Anda.

Jika Anda melakukan kueri langsung pada tabel Anda alih-alih menggunakan tampilan yang dihasilkan secara otomatis, Anda harus menggunakan kolom semu _PARTITIONTIME dalam kueri Anda. Untuk informasi selengkapnya, lihat Membuat kueri tabel berpartisi.

Performa kampanye

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

Konsol

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_interactions) AS Interactions,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `DATASET.ads_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.ads_CampaignBasicStats_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

bq

  bq query --use_legacy_sql=false '
  SELECT
    c.customer_id,
    c.campaign_name,
    c.campaign_status,
    SUM(cs.metrics_impressions) AS Impressions,
    SUM(cs.metrics_interactions) AS Interactions,
    (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
  FROM
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  LEFT JOIN
    `DATASET.ads_CampaignBasicStats_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 yang Anda buat untuk menyimpan tabel yang ditransfer
• CUSTOMER_ID: ID Pelanggan Google Ads Anda.

Jumlah kata kunci

Contoh kueri berikut menganalisis kata kunci berdasarkan kampanye, grup iklan, dan status kata kunci. Kueri ini menggunakan fungsi KeywordMatchType. Jenis pencocokan kata kunci membantu menentukan penelusuran mana yang dapat memicu iklan Anda. Untuk informasi selengkapnya tentang opsi pencocokan kata kunci, lihat Tentang opsi pencocokan kata kunci.

Konsol

  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.ads_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_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

bq

  bq query --use_legacy_sql=false '
  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.ads_Keyword_CUSTOMER_ID` k
  JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_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 yang Anda buat untuk menyimpan tabel yang ditransfer
• CUSTOMER_ID: ID Pelanggan Google Ads Anda.