라벨

라벨을 사용하면 계정의 요소를 의미 있는 그룹으로 정리하여 가장 관심 있는 데이터를 빠르게 필터링하고 보고할 수 있습니다. Google Ads 스크립트는 계정, 캠페인, 광고그룹, 광고, 키워드 수준에서 라벨을 지원합니다.

사용 사례

Google Ads 계정 내에서 라벨을 사용하여 임의의 데이터를 Google Ads 항목과 연결할 수 있습니다. 관리자 계정 내에서 라벨을 사용하여 유사한 하위 계정을 그룹화할 수 있습니다. 라벨은 다음과 같은 다양한 사용 사례에 유용합니다.

  • 계정 목록 처리
    • 대행사인 경우 배관공의 모든 계정에 plumber_accounts 라벨을 적용하면 스크립트를 통해 배관공 관련 키워드 (예: '응급 샤워기 수리')를 계정의 모든 캠페인으로 푸시할 수 있습니다.
  • 항목 목록 처리
    • 주말에만 사용 설정하려는 키워드 집합이 있는 경우 weekend_keywords 라벨을 적용하면 됩니다. 그러면 스크립트가 금요일 저녁에 weekend_keywords로 모든 키워드를 사용 설정하고 월요일 아침에 일시중지할 수 있습니다.
  • 여러 실행에서 항목 처리
    • 30분 이내에 처리할 수 없는 항목이 많을 경우 스크립트에 processed 라벨을 만들어 이미 처리된 항목에 적용할 수 있습니다. 스크립트를 매시간 실행하도록 예약한 다음 processed 라벨이 적용되지 않은 항목만 처리합니다.
  • 2단계 변경사항
    • 스크립트가 다수의 키워드에 대해 입찰가 변경을 실행하도록 하는 대신 increase_bid_by_10%로 키워드에 라벨을 지정하고, Google Ads UI에 로그인하고, 라벨과 일치하는 키워드를 필터링하고, 검토하고, 결과가 만족스러우면 일괄 수정을 사용하여 입찰가를 변경할 수 있습니다.
  • 유연한 입찰
    • 스크립트는 라벨을 사용하여 입찰가 변경 기록을 유지할 수 있습니다. 예를 들어 스크립트가 키워드 입찰가를 20% 올리면 계정을 increased_20% 라벨로 표시할 수 있습니다. 다음 날 스크립트가 라벨을 대상으로 실행되고 전에 이미 입찰가를 높였음을 알게 되면 입찰가를 10%만 높일 수 있습니다.
  • 품질평가점수 추적
    • 스크립트는 중요한 키워드에 품질평가점수로 라벨을 지정한 다음 품질평가점수가 더 이상 라벨과 일치하지 않는 키워드를 주기적으로 확인하고 보고할 수 있습니다.

계정 수준의 라벨

Google Ads 스크립트를 사용하면 관리자 계정 내에 라벨을 만들고 해당 관리자 계정의 Google Ads 계정에 라벨을 적용할 수 있습니다.

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

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

마찬가지로 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);
}

계정 라벨의 가장 일반적인 용도는 동일한 계정 라벨을 공유하는 계정 그룹을 처리하는 것입니다.

const labelName = 'High spending accounts';

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

단일 스크립트 실행으로 여러 계정을 처리하는 방법을 자세히 알아보려면 관리자 계정 스크립트 가이드를 참고하세요.

계정 내의 라벨

라벨을 만들어 계정의 캠페인, 광고그룹, 광고, 키워드에 적용할 수 있습니다. 캠페인에 라벨을 적용하는 방법은 다음과 같습니다.

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

마찬가지로 removeLabel 메서드를 사용하여 라벨을 삭제할 수 있습니다.

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

라벨은 라벨별로 그룹화된 유사한 항목 집합을 처리하는 데 가장 일반적으로 사용됩니다. 다음 코드 스니펫은 공통 라벨을 공유하는 캠페인 그룹을 일시중지하는 방법을 보여줍니다.

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

보고서

Google Ads 계정의 실적 보고서를 실행할 때 라벨 리소스 이름을 사용하여 항목을 필터링할 수 있습니다. 리소스 이름은 Google Ads API의 개념이며 GAQL로 보고서를 실행할 때 사용되기도 합니다. 라벨 리소스 이름은 항상 다음 형식입니다.

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

getResourceName 메서드를 사용하여 라벨의 리소스 이름을 가져올 수 있습니다.

다음 코드 스니펫은 '크리스마스 프로모션' 라벨이 있는 모든 캠페인에 관해 캠페인 보고서를 실행하는 방법을 보여줍니다.

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

라벨 리소스 이름으로 필터링하는 데는 CONTAINS_ALL, CONTAINS_ANY, CONTAINS_NONE 연산자만 사용할 수 있습니다.