라벨

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

사용 사례

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

  • 계정 목록 처리
    • 대행사인 경우 배관공의 모든 계정에 plumber_accounts 라벨을 적용할 수 있습니다. 그러면 스크립트가 배관공 관련 키워드(예: '긴급한 샤워 수리')를 해당 계정의 모든 캠페인에 푸시할 수 있습니다.
  • 항목 목록 처리 <ph type="x-smartling-placeholder">
      </ph>
    • 운영 기간에만 운영하려는 키워드 조합이 있는 경우 주말에는 weekend_keywords 라벨을 적용할 수 있습니다. 그러면 스크립트가 금요일에 weekend_keywords이 포함된 모든 키워드를 사용 설정할 수 있습니다. 월요일 아침에는 일시중지하세요
  • 여러 실행에서 항목 처리
    • 처리할 수 없는 항목이 많은 경우 30분 후에 다음 위치에서 processed 라벨을 만들 수 있습니다. 스크립트를 작성하고 이미 처리된 항목에 적용할 수 있습니다. 스크립트를 시간당 실행되도록 예약한 다음 processed 라벨이 적용되지 않은 항목만 처리합니다.
  • 2단계 변경 <ph type="x-smartling-placeholder">
      </ph>
    • 스크립트가 다수의 키워드에 대해 입찰가 변경을 실행하도록 하는 대신 키워드에 increase_bid_by_10%로 라벨을 지정하고 Google Ads UI에 로그인한 후 라벨과 일치하는 키워드를 필터링하고 검토한 다음 결과에 만족하면 일괄 수정을 사용하여 입찰가를 변경할 수 있습니다.
  • 유연한 입찰 <ph type="x-smartling-placeholder">
      </ph>
    • 스크립트는 라벨을 사용하여 입찰가 변경 내역을 유지할 수 있습니다. 대상 예를 들어 스크립트가 키워드 입찰가를 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 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 연산자만 사용할 수 있습니다.