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

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

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

広告のスケジュール

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

取得

キャンペーンの広告スケジュールを取得するには、キャンペーンのターゲットの 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);

作成

新しい広告スケジュールを作成するには、Campaign の addAdSchedule メソッドを使用します。次のコードスニペットは、アカウントのタイムゾーンで毎週土曜日の午前 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 広告 API プラットフォームの付録で指定されているように事前定義された値が設定されています。これらの ID は、レポートの解析に役立ちます。条件を直接選択する場合は、PlatformSelector で提供されるヘルパーメソッドを使用できます。