Google 広告のサービスに関するご意見やご提案は、Google 広告と測定のコミュニティサーバーの公式 Google 広告 Discord チャンネルにご参加ください。

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

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

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

広告のスケジュール

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

取得

キャンペーンの広告スケジュールを取得するには、キャンペーンの targets の 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 広告スクリプトを使用して、キャンペーンの地域をターゲットに設定したり、除外したりすることもできます。

取得

キャンペーンの targets の 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 広告スクリプトを使用すると、特定の場所を中心とした半径（近隣地域）をキャンペーンのターゲットに設定できます。

取得

ターゲット設定された近接地域のリストを取得するには、キャンペーンの targets で 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 キロメートルの範囲をターゲットにキャンペーンを設定します。

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 メソッドを使用します。

プラットフォーム

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

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

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