Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

キャンペーンのターゲット設定

Google 広告スクリプトを使用すると、アカウントでキャンペーン単位のターゲティング設定を行うことができます。広告のスケジュール、ターゲット地域、除外地域、ターゲット半径、プラットフォームがサポートされます。このガイドでは、キャンペーンのターゲットを操作する方法について説明します。

広告のスケジュール

広告のスケジュールを使用すると、広告を掲載する時間帯を管理できます。

取得

キャンペーンの広告のスケジュールを取得するには、キャンペーンの adSchedules ターゲットの `adSchedules` メソッドを使用します。次のコードスニペットは、キャンペーンのすべての AdSchedule 条件のリストを取得する方法を示しています。

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

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

デフォルトでは、キャンペーンは常に配信されるため、キャンペーンにカスタムの広告スケジュールを設定していない場合は、広告スケジュールは返されません。

更新

広告スケジュールを取得したら、そのプロパティを直接変更できます。たとえば、広告スケジュールの単価調整比は次のように更新できます。

adSchedule.setBidModifier(1.1);

作成

新しい広告スケジュールを作成するには、 addAdSchedule の Campaignメソッドを使用します。次のコードスニペットでは、アカウントのタイムゾーンで毎週土曜日の午前 7 時から午前 11 時まで、入札単価調整比率が 1.1 のキャンペーンのカスタム広告スケジュールを作成します。

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

各パラメータに指定できる値や、広告スケジュールを作成する際に注意すべきその他の制限については、ドキュメントをご覧ください。

削除

広告スケジュールを削除するには、 remove メソッドを使用します。キャンペーンのカスタム広告スケジュールをリセットするには、次のようにカスタム広告スケジュールをすべて削除します。

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

ロケーション

Google 広告スクリプトを使用して、キャンペーンの地域をターゲットに設定したり、除外したりすることもできます。

取得

ターゲット地域のリストを取得するには、キャンペーンのターゲットの targetedLocations メソッドを使用します。除外地域は、 excludedLocations メソッドを使用して取得できます。次のコードスニペットでは、先月 100 回以上表示されたターゲット地域をすべて選択します。

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

キャンペーンをすべての国と地域で配信するように設定している場合は、地域のリストは空になります。

更新

地域を取得したら、プロパティを変更できます。たとえば、地域の入札単価調整比は次のように更新できます。

location.setBidModifier(1.1);

作成

キャンペーンで地域ターゲットを作成するには、 addLocation メソッドを使用します。同様に、 excludeLocation メソッドを使用して地域を除外することもできます。次のコードスニペットでは、入札単価調整比率が 1.15 の米国をキャンペーンのターゲットに設定し、ニューヨーク市を除外しています。

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

地域ターゲティングを追加する際に使用する ID のリストについては、 Google Ads API の地域ターゲティングのドキュメントをご覧ください。地域ターゲットのパフォーマンスをトラッキングするには、 location_view レポートリソースで検索します。

削除

地域ターゲットを削除するには、 remove メソッドを使用します。

近隣地域

Google 広告スクリプトを使用すると、キャンペーンのターゲットを特定の地域の半径（近隣地域）に設定できます。

取得

ターゲット近隣地域のリストを取得するには、キャンペーンのターゲットの targetedProximities メソッドを使用します。次のコードスニペットでは、先月 100 回以上表示されたターゲット近隣地域をすべて選択します。

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

作成

キャンペーンの近隣地域ターゲットを作成するには、 addProximity メソッドを使用します。次のコードスニペットでは、座標（37.423021, -122.083739）を中心とする半径 20 km の地域をキャンペーンのターゲットに設定します。

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

このメソッドを使用して、入札単価調整比率と住所が同じ近隣地域ターゲットを作成することもできます。

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

住所が指定された緯度と経度に実際に属しているかどうかを確認する検証はありません。住所は、キャンペーン管理インターフェースに表示される内容を変更する以外の目的では使用されません。

削除

近隣地域ターゲットを削除するには、 remove メソッドを使用します。

プラットフォーム

キャンペーンのターゲットとするプラットフォームのリストを取得するには、キャンペーンのターゲットの platforms メソッドを使用します。Google 広告キャンペーンはすべてのプラットフォーム（パソコン、モバイル、タブレット）をターゲットとするため、 Platform 条件を追加または削除することはできません。このターゲティング条件の最も一般的な用途は、キャンペーンのデバイスの入札単価調整を設定することです。

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

プラットフォーム ID はキャンペーン間で共有され、Google Ads API platforms appendixで指定されている事前定義済みの値が設定されます。これらの ID は、レポートの解析に役立ちます。条件を直接選択する場合は、 PlatformSelectorで提供されるヘルパーメソッドを使用できます。