Nhãn

Nhãn giúp bạn sắp xếp các thành phần trong tài khoản thành các nhóm có ý nghĩa để bạn có thể nhanh chóng lọc và báo cáo dữ liệu mà bạn quan tâm nhất. Tập lệnh Google Ads hỗ trợ nhãn ở cấp tài khoản, chiến dịch, nhóm quảng cáo, quảng cáo và từ khoá.

Trường hợp sử dụng

Trong tài khoản Google Ads, bạn có thể sử dụng nhãn để liên kết dữ liệu tuỳ ý với các thực thể Google Ads. Trong tài khoản người quản lý, bạn có thể sử dụng nhãn để nhóm các tài khoản con tương tự nhau. Nhãn giúp ích cho một số trường hợp sử dụng:

  • Xử lý danh sách tài khoản
    • Nếu là công ty quảng cáo, bạn có thể áp dụng nhãn plumber_accounts cho tất cả tài khoản của thợ sửa ống nước, sau đó tập lệnh có thể đẩy từ khoá liên quan đến thợ sửa ống nước (ví dụ: "sửa chữa vòi hoa sen khẩn cấp") vào tất cả chiến dịch trong các tài khoản đó.
  • Xử lý danh sách các thực thể
    • Nếu có một nhóm từ khoá mà bạn chỉ muốn bật vào cuối tuần, bạn có thể áp dụng nhãn weekend_keywords cho các từ khoá đó. Sau đó, một tập lệnh có thể bật tất cả từ khoá bằng weekend_keywords vào tối thứ Sáu và tạm dừng các từ khoá đó vào sáng thứ Hai.
  • Xử lý các thực thể trên nhiều lần chạy
    • Nếu có một số lượng lớn thực thể không thể xử lý trong vòng 30 phút, thì bạn có thể tạo nhãn processed trong tập lệnh và áp dụng nhãn đó cho các thực thể đã được xử lý. Lên lịch chạy tập lệnh hằng giờ, sau đó chỉ xử lý những thực thể không có nhãn processed.
  • Thay đổi về quy trình xác minh hai bước
    • Thay vì yêu cầu tập lệnh thực thi thay đổi giá thầu trên một số lượng lớn từ khoá, bạn có thể gắn nhãn cho các từ khoá bằng increase_bid_by_10%, đăng nhập vào giao diện người dùng Google Ads, lọc ra các từ khoá khớp với nhãn, xem xét các từ khoá đó và nếu hài lòng với kết quả, hãy thay đổi giá thầu bằng tính năng chỉnh sửa hàng loạt.
  • Đặt giá thầu linh hoạt
    • Tập lệnh có thể sử dụng nhãn để duy trì nhật ký thay đổi giá thầu. Ví dụ: khi một tập lệnh tăng giá thầu từ khoá thêm 20%, tập lệnh đó có thể đánh dấu tài khoản bằng nhãn increased_20%. Vào ngày tiếp theo, khi tập lệnh chạy trên nhãn và nhận ra rằng nó đã tăng giá thầu trước đó, tập lệnh này chỉ có thể tăng giá thầu thêm 10%.
  • Theo dõi điểm chất lượng
    • Một tập lệnh có thể gắn nhãn từ khoá quan trọng bằng điểm chất lượng, sau đó định kỳ kiểm tra và báo cáo về những từ khoá có điểm chất lượng không còn khớp với nhãn.

Nhãn ở cấp tài khoản

Tập lệnh Google Ads cho phép bạn tạo nhãn trong tài khoản người quản lý, cũng như áp dụng nhãn cho các tài khoản Google Ads trong tài khoản người quản lý đó:

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

Bạn có thể áp dụng nhãn cho các tài khoản mà bạn chọn bằng phương thức applyLabel:

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);
}

Tương tự, bạn có thể xoá nhãn khỏi tài khoản bằng cách sử dụng phương thức 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);
}

Cách sử dụng nhãn tài khoản phổ biến nhất là để xử lý một nhóm tài khoản có cùng một nhãn tài khoản:

const labelName = 'High spending accounts';

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

Hãy tham khảo hướng dẫn về tập lệnh tài khoản người quản lý để tìm hiểu thêm về cách xử lý nhiều tài khoản trong một lần thực thi tập lệnh.

Nhãn trong một tài khoản

Bạn có thể tạo và áp dụng nhãn cho chiến dịch, nhóm quảng cáo, quảng cáo và từ khoá của tài khoản. Dưới đây là cách áp dụng nhãn cho một chiến dịch:

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

Tương tự, bạn có thể xoá một nhãn bằng phương thức removeLabel:

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

Nhãn thường được dùng để xử lý một tập hợp các thực thể tương tự được nhóm lại với nhau theo một nhãn. Đoạn mã sau đây cho biết cách tạm dừng một nhóm chiến dịch có chung một nhãn:

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

Báo cáo

Bạn có thể sử dụng tên tài nguyên nhãn để lọc các thực thể khi chạy báo cáo hiệu suất cho tài khoản Google Ads. Tên tài nguyên là một khái niệm trong API Google Ads và đôi khi được dùng khi chạy báo cáo bằng GAQL. Tên tài nguyên nhãn luôn có định dạng:

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

Bạn có thể tìm nạp tên tài nguyên của nhãn bằng phương thức getResourceName.

Đoạn mã sau đây cho biết cách chạy báo cáo chiến dịch cho tất cả chiến dịch có nhãn "Khuyến mãi Giáng sinh":

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);

Xin lưu ý rằng bạn chỉ có thể sử dụng các toán tử CONTAINS_ALL, CONTAINS_ANY và CONTAINS_NONE để lọc theo tên tài nguyên nhãn.