このページは Cloud Translation API によって翻訳されました。

ラベル

ラベルを使用すると、アカウント内の要素を意味のあるグループに分類できるため、関心のあるデータをすばやくフィルタしてレポートを作成できます。 Google 広告スクリプトでは、アカウント、キャンペーン、 広告グループ、広告、キーワードの単位。

ユースケース

Google 広告アカウント内では、ラベルを使用して任意のデータを Google 広告のエンティティ。マネージャーアカウント内では、ラベルを使用して類似の子アカウントをグループ化できます。ラベルはさまざまなユースケースで役立ちます。

アカウントのリストを処理する
- 代理店の場合は、水道業者のすべてのアカウントに plumber_accounts ラベルを適用できます。これにより、スクリプトによって、水道業者関連のキーワード（「緊急シャワー修理」など）が、それらのアカウントのすべてのキャンペーンにプッシュされます。
エンティティのリストを処理する <ph type="x-smartling-placeholder">
- キャンペーンでのみ有効にしたい複数のキーワードがある場合、 weekend_keywords ラベルを適用できます。スクリプトにより、金曜日に weekend_keywords を指定してすべてのキーワードを有効化する月曜の朝に一時停止します
複数の実行でエンティティを処理する
- Google Cloud で処理できない多数のエンティティが 30 分後に、processed ラベルを処理済みのエンティティに適用しますスクリプトを 1 時間ごとに実行するようにスケジュールを設定し、processed ラベルが適用されていないエンティティのみを処理します。
2 段階の変更 <ph type="x-smartling-placeholder">
- スクリプトで多数のキーワードの入札単価を変更するのではなく、キーワードに increase_bid_by_10% というラベルを付け、Google 広告の管理画面にログインして、ラベルに一致するキーワードをフィルタして確認し、結果に問題がなければ一括編集を使用して入札単価を変更します。
柔軟な入札
- スクリプトでラベルを使用することで、入札単価の変更履歴を維持することができます。たとえば、スクリプトでキーワードの入札単価を 20% 引き上げた場合、アカウントにラベル increased_20% を付けてマークできます。翌日、スクリプトがラベル全体で実行され、入札単価がすでに引き上げられていることが判明した場合、入札単価は 10% しか引き上げられない可能性があります。
品質スコアのトラッキング
- スクリプトで重要なキーワードに品質スコアのラベルを付けて、品質スコアが下がっているキーワードを定期的にチェックしてレポートを作成します一致します。

アカウント単位のラベル

Google 広告スクリプトを使用すると、MCC アカウント内でラベルを作成することや、ラベルを適用するその MCC アカウントの Google 広告アカウントに次のラベルを追加します。

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

詳しくは、MCC アカウントのスクリプトガイドをご覧ください。 1 回のスクリプト実行で複数のアカウントを処理する方法について学びます。

アカウント内のラベル

ラベルを作成して、アカウントのキャンペーン、広告グループ、広告、キーワードに適用できます。キャンペーンにラベルを適用する方法は次のとおりです。

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 広告アカウントのパフォーマンスレポートを実行する際に、ラベルリソース名を使用してエンティティをフィルタできます。リソース名は Google 広告 API のコンセプトであり、GAQL でレポートを実行するときに使用されることがあります。ラベルリソース name は常に次の形式になります。

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

ラベルのリソース名は、getResourceName メソッドを使用して取得できます。

以下のコードスニペットは、キャンペーンの実行方法を示しています。レポート: 「クリスマスプロモーション」を含むすべてのキャンペーン 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);

なお、使用できるのは CONTAINS_ALL、CONTAINS_ANY、ラベルリソース名でフィルタするための CONTAINS_NONE 演算子。