このページは 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 Ads API プラットフォームの付録で規定されている事前定義された値を持ちます。これらの ID は、レポートの解析に役立ちます。条件を直接選択する場合は、PlatformSelector が提供するヘルパーメソッドを使用できます。