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
が提供するヘルパー メソッドを使用できます。