Label

Label memungkinkan Anda mengatur elemen dalam akun menjadi grup yang signifikan sehingga Anda dapat memfilter dan melaporkan data yang paling menarik bagi Anda dengan cepat. Skrip Google Ads mendukung label di tingkat akun, kampanye, grup iklan, iklan, dan kata kunci.

Kasus penggunaan

Dalam akun Google Ads, label dapat digunakan untuk mengaitkan data arbitrer dengan entitas Google Ads. Dalam akun pengelola, label dapat digunakan untuk mengelompokkan akun turunan yang serupa. Label dapat membantu dalam beberapa kasus penggunaan:

  • Memproses daftar akun
    • Jika Anda adalah agensi, Anda dapat menerapkan label plumber_accounts ke semua akun untuk tukang leding, lalu skrip dapat mengirim pekerjaan kata kunci (misalnya, "perbaikan shower darurat") ke semua kampanye di akun tersebut.
  • Memproses daftar entitas
    • Jika memiliki sekumpulan kata kunci yang hanya ingin diaktifkan selama akhir pekan, Anda dapat menerapkan label weekend_keywords ke kata kunci tersebut. Kemudian, skrip dapat mengaktifkan semua kata kunci dengan weekend_keywords pada Jumat malam, dan menjeda kata kunci tersebut pada Senin pagi.
  • Memproses entity di beberapa operasi
    • Jika Anda memiliki banyak entitas yang tidak dapat diproses menggunakan 30 menit, lalu Anda dapat membuat label processed di skrip dan menerapkannya ke entitas yang telah diproses. Jadwalkan skrip untuk berjalan setiap jam, lalu proses hanya entitas yang tidak memiliki label processed yang diterapkan.
  • Perubahan dua langkah
    • Daripada membuat skrip menjalankan perubahan bid di sejumlah besar kata kunci, Anda dapat memberi label pada kata kunci dengan increase_bid_by_10%, login ke UI Google Ads, memfilter kata kunci yang cocok dengan label, meninjaunya, dan jika puas dengan hasilnya, ubah bidnya menggunakan pengeditan massal.
  • Bidding fleksibel
    • Skrip dapat menggunakan label untuk menyimpan histori perubahan bid. Sebagai ketika skrip meningkatkan tawaran kata kunci sebesar 20%, skrip dapat menandai akun dengan label, increased_20%. Keesokan harinya, saat skrip berjalan di seluruh label dan menyadari bahwa skrip telah meningkatkan bid sebelumnya, skrip tersebut hanya dapat meningkatkan bid sebesar 10%.
  • Pelacakan skor kualitas
    • Skrip dapat memberi label pada kata kunci penting dengan skor kualitasnya, lalu secara berkala memeriksa dan melaporkan kata kunci yang skor kualitasnya tidak lagi cocok dengan label.

Label di tingkat akun

Skrip Google Ads memungkinkan Anda membuat label dalam akun pengelola, serta menerapkan label ke akun Google Ads dalam akun pengelola tersebut:

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

Anda dapat menerapkan label ke akun pilihan Anda menggunakan applyLabel berikut:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

Demikian pula, Anda dapat menghapus label dari akun menggunakan metode removeLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

Penggunaan label akun yang paling umum adalah untuk memproses sekelompok akun yang memiliki label akun yang sama:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

Lihat skrip akun pengelola kami panduan untuk mempelajari lebih lanjut tentang cara memproses beberapa akun dalam satu eksekusi skrip.

Label dalam akun

Anda dapat membuat dan menerapkan label ke kampanye, grup iklan, iklan, dan kata kunci akun. Berikut cara menerapkan label ke kampanye:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

Demikian pula, Anda dapat menghapus label menggunakan metode removeLabel:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

Label paling sering digunakan untuk memproses sekumpulan entity serupa yang dikelompokkan bersama oleh label. Cuplikan kode berikut menunjukkan cara menjeda grup kampanye yang memiliki label yang sama:

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

Pelaporan

Anda dapat menggunakan nama resource label untuk memfilter entitas saat menjalankan laporan performa untuk akun Google Ads. Nama sumber daya adalah konsep dari Google Ads API dan terkadang digunakan saat menjalankan laporan dengan GAQL. Resource label nama selalu dalam format:

customers/[customer id]/labels/[label id]

Anda bisa mengambil nama resource label menggunakan getResourceName .

Cuplikan kode berikut menunjukkan cara menjalankan kampanye laporan untuk semua kampanye yang memiliki "promosi Natal" label:

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

Perlu diingat bahwa Anda hanya dapat menggunakan operator CONTAINS_ALL, CONTAINS_ANY, dan CONTAINS_NONE untuk memfilter berdasarkan nama resource label.