Segmentation

Segmentasi tersedia di UI Google Ads sebagai menu terpisah. Anda dapat menerapkan segmentasi di Google Ads API dengan menambahkan kolom yang sesuai ke kueri. Misalnya, Anda menambahkan segments.device ke kueri. Tindakan ini akan menghasilkan laporan dengan baris untuk setiap kombinasi perangkat dan resource yang ditentukan dalam klausa FROM, serta nilai statistik (tayangan iklan, klik, konversi, dll.) yang dibagi di antara keduanya.

Di UI Google Ads, hanya satu segmen yang dapat digunakan dalam satu waktu, tetapi dengan API, Anda dapat menentukan beberapa segmen dalam kueri yang sama.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

Hasil dari pengiriman kueri ini ke GoogleAdsService.SearchStream menyerupai string JSON ini:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    }
  ]
}

Dalam hasil contoh ini, atribut untuk objek pertama dan kedua, termasuk nama resource, adalah sama. Tayangan iklan disegmentasikan menurut perangkat, sehingga dua atau beberapa objek dapat ditampilkan untuk kampanye yang sama.

Perhatian: Untuk setiap kolom segmen tambahan yang disertakan dalam kueri laporan, jumlah baris dapat meningkat secara eksponensial.

Segmentasi implisit

Setiap laporan awalnya disegmentasikan menurut resource yang ditentukan dalam klausa FROM. Kolom resource_name resource dalam klausa FROM ditampilkan dan metrik disegmentasikan berdasarkan kolom tersebut, meskipun kolom resource_name tidak disertakan secara eksplisit dalam kueri. Misalnya, saat Anda menentukan ad_group sebagai resource dalam klausa FROM, ad_group.resource_name akan otomatis ditampilkan dan metrik secara implisit disegmentasikan terhadapnya di tingkat ad_group.

Jadi, untuk kueri ini:

SELECT metrics.impressions
FROM ad_group

Anda akan mendapatkan string JSON seperti ini:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

Kolom resource_name dari adGroup selalu ditampilkan karena ad_group ditentukan sebagai resource dalam klausa FROM.

search_term_view

Resource search_term_view juga disegmentasikan secara implisit menurut grup iklan, bukan hanya istilah penelusuran, seperti yang tercermin dari struktur nama resource-nya, yang juga menyertakan grup iklan. Oleh karena itu, Anda mungkin menerima baris yang tampaknya duplikat dengan istilah penelusuran yang sama muncul di hasil saat baris tersebut termasuk dalam grup iklan yang berbeda:

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

Meskipun kedua objek yang ditampilkan dalam contoh ini tampak seperti duplikat, nama resource-nya sebenarnya berbeda, terutama di bagian ID grup iklan. Artinya, istilah penelusuran "google photos" diatribusikan ke dua grup iklan (ID 2222222222 dan 33333333333) pada tanggal yang sama (2024-06-15). Jadi, API berfungsi sebagaimana mestinya dan tidak menampilkan objek duplikat dalam kasus ini.

Poin Penting: Secara teknis, resource search_term_view juga disegmentasikan secara implisit oleh kampanye. Namun, grup iklan harus selalu termasuk dalam kampanye, jadi menggunakan grup iklan saja untuk menghapus duplikat baris data sudah cukup karena grup iklan adalah unit yang paling terperinci.

Kolom segmen yang dapat dipilih

Tidak semua kolom segmen dapat dipilih untuk resource tertentu dalam klausa FROM. Sebagai contoh, misalnya Anda terus membuat kueri dari resource ad_group. Agar kolom segmen dapat dipilih dari resource ad_group, kolom tersebut harus ada dalam daftar Segments untuk ad_group. Daftar Segments adalah bagian kuning dari tabel kolom yang tersedia di halaman metadata resource ad_group.

Catatan: Ketersediaan segmen pada resource tertentu dapat bervariasi menurut versi API. Gunakan pemilih versi di referensi Layanan Kolom Google Ads untuk memverifikasi kompatibilitas versi target Anda (v23, v24, v25, atau v26). Misalnya, di v24 dan yang lebih baru, segments.click_type tidak dapat dipilih dengan ad_group_asset, campaign_asset, atau customer_asset, dan segments.ad_sub_network_type tidak dapat dipilih dengan campaign_budget (kombinasi ini hanya didukung di v23).

Resource segmen

Saat memilih dari beberapa resource, Anda mungkin memiliki opsi untuk menggabungkan resource terkait secara implisit dengan memilih kolomnya bersama kolom resource dalam klausa FROM. Referensi terkait ini dapat ditemukan dalam daftar Attributed Resources pada resource di halaman metadata klausul FROM. Dalam kasus resource ad_group, Anda akan melihat bahwa Anda juga dapat memilih kolom dari resource campaign. Kolom resource_name dari Attributed Resources mana pun dengan setidaknya satu kolom dalam klausa SELECT akan otomatis ditampilkan, meskipun kolom resource_name tidak disertakan secara eksplisit dalam kueri.

Serupa dengan memilih kolom Attributed Resource, Anda juga dapat memilih kolom Segmenting Resource. Jika resource tertentu memiliki daftar Segmenting Resources di halaman metadatanya, memilih kolom dari salah satu resource yang tercantum tersebut akan menyebabkan kueri disegmentasikan lebih lanjut berdasarkan resource_name yang ditampilkan dari Segmenting Resource tersebut. Sebagai contoh, Anda akan menemukan bahwa resource campaign tercantum sebagai Segmenting Resource untuk resource campaign_budget. Memilih kolom kampanye apa pun, seperti campaign.name, dari resource campaign_budget tidak hanya menyebabkan kolom campaign.name ditampilkan, tetapi juga menyebabkan kolom campaign.resource_name ditampilkan dan disegmentasikan.

Kemampuan pemilihan antara segmen dan metrik

Kolom segmen tertentu mungkin tidak kompatibel dengan beberapa kolom segmen lainnya, atau dengan beberapa kolom metrik. Untuk mengidentifikasi kolom segmen mana yang kompatibel satu sama lain, tinjau daftar selectable_with segmen dalam klausa SELECT.

Untuk resource ad_group, ada lebih dari 50 segmen yang tersedia yang dapat Anda pilih. Namun, daftar selectable_with untuk segments.hotel_check_in_date adalah kumpulan segmen kompatibel yang jauh lebih kecil. Artinya, jika Anda menambahkan kolom segments.hotel_check_in_date ke klausa SELECT, Anda akan membatasi segmen yang tersedia yang tersisa untuk dipilih ke persimpangan kedua daftar ini.

Batasan segmen gabungan

Beberapa kolom segmen memiliki batasan pemilihan eksplisit yang mengharuskannya diminta bersama segmen induk dalam klausa SELECT:

• Jika memilih segments.ad_sub_network_type (yang menguraikan sub-jaringan iklan YouTube seperti Dalam stream, Dalam Feed, dan Shorts), Anda juga harus memilih segments.ad_network_type.
• Di v25 dan yang lebih baru, memilih segments.ad_sub_format_type (yang mengelompokkan iklan in-stream yang tidak dapat dilewati di YouTube berdasarkan durasi) mengharuskan Anda juga memilih segments.ad_format_type.

Pemfilteran implisit menurut pilihan segmen

Saat Anda memilih kolom segmen tertentu dalam kueri, Google Ads API dapat secara implisit memfilter hasil untuk hanya menyertakan baris yang segmennya berlaku dan memiliki nilai.

Dampak segments.keyword.*

Contoh umum dan penting dari perilaku ini terjadi saat memilih kolom apa pun di bagian segments.keyword (seperti segments.keyword.info.text dan segments.keyword.ad_group_criterion):

• Pengecualian Traffic Non-Kata Kunci: Jika Anda menyertakan kolom segments.keyword.* dalam klausa SELECT, tindakan ini akan membatasi hasil hanya pada baris yang terkait langsung dengan kriteria grup iklan kata kunci Jaringan Penelusuran.
• Jenis Kampanye yang Terpengaruh: Akibatnya, data dari jenis kampanye atau grup iklan yang tidak mengandalkan kata kunci Penelusuran akan dikecualikan dari hasil. Hal ini mencakup, tetapi tidak terbatas pada:
  • Iklan Penelusuran Dinamis (DSA): Karena target DSA didasarkan pada konten situs, bukan kata kunci.
  • Kampanye Shopping: Yang menggunakan grup produk, bukan kata kunci.
  • Kampanye Performa Maksimal: Meskipun Performa Maksimal dapat ditayangkan di Penelusuran, pelaporannya biasanya tidak disegmentasikan berdasarkan kriteria kata kunci yang sama.
• Jaringan Display: Kolom segments.keyword.* berkaitan dengan kata kunci yang digunakan di Jaringan Penelusuran. Laporan ini tidak mengelompokkan menurut kata kunci Jaringan Display atau metode penargetan Display lainnya.

Tips: Jika analisis Anda perlu menyertakan data performa dari DSA, Shopping, atau sumber non-kata kunci penelusuran lainnya, jangan sertakan kolom dari segments.keyword.* dalam kueri Anda. Analisis data di semua jenis kampanye terlebih dahulu, dan terapkan segmentasi kata kunci hanya saat berfokus pada performa kata kunci Penelusuran.

Aturan untuk segmen dalam klausa WHERE

Jika segmen berada dalam klausa WHERE, segmen tersebut juga harus berada dalam klausa SELECT. Pengecualian untuk aturan ini adalah segmen tanggal berikut, yang disebut sebagai segmen tanggal inti:

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

Aturan untuk kolom segmen tanggal inti

Segmen segments.date, segments.week, segments.month, segments.quarter, dan segments.year berfungsi sebagai berikut:

Poin Penting: Segmen tanggal terperinci (segments.date, segments.week, dan segments.hour) mendukung periode lihat balik hingga 37 bulan. Kueri yang melebihi rentang ini akan menampilkan DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED di v24 dan yang lebih baru (atau DateRangeError.UNKNOWN di v23). Gunakan segments.month, segments.quarter, atau segments.year untuk data historis yang lebih lama.

• Segmen ini dapat difilter dalam klausa WHERE tanpa muncul dalam klausa SELECT.
• Jika salah satu segmen ini berada dalam klausa SELECT, rentang tanggal terbatas yang terdiri dari segmen tanggal inti harus ditentukan dalam klausa WHERE. Segmen tanggal tidak harus sama dengan yang ditentukan dalam SELECT.

Contoh

: Tidak valid: Karena segments.date berada dalam klausa SELECT, Anda perlu menentukan rentang tanggal terbatas dalam klausa WHERE untuk segments.date, segments.week, segments.month, segments.quarter, atau segments.year.	SELECT campaign.name, metrics.clicks, segments.date FROM campaign
Valid: Kueri ini menampilkan nama kampanye dan klik yang diperoleh selama rentang tanggal inklusif. Perhatikan bahwa segments.date tidak perlu muncul dalam klausa SELECT.	SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Valid: Kueri ini menampilkan nama kampanye dan klik yang disegmentasikan menurut tanggal untuk semua hari dalam rentang tanggal inklusif.	SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Valid: Kueri ini menampilkan nama kampanye dan klik yang disegmentasikan menurut bulan untuk semua hari dalam rentang tanggal inklusif.	SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date >= '2024-01-01' AND segments.date <= '2024-01-31'
Valid: Kueri ini menampilkan nama kampanye dan klik yang disegmentasikan menurut kuartal, lalu menurut bulan untuk semua bulan dalam rentang tahun inklusif.	SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year >= 2020 AND segments.year <= 2024