広告表示オプションのスクリプトの移行

重要: 現在のフィードベースの広告表示オプションは、従来の Google 広告スクリプトを使用して引き続きご利用いただけます。ただし、フィードベースの広告表示オプションはまもなくご利用いただけなくなり、アセットベースの広告表示オプションは新しい Google 広告スクリプト エクスペリエンスでのみご利用いただけるようになります。可能な限り早く、従来の Google 広告スクリプトを新しい Google 広告スクリプトに移行することをおすすめします。

このドキュメントでは、広告表示オプションにアクセスまたは管理するスクリプトの移行プロセスについて説明します。2022 年 3 月 28 日より、スクリプトを使用して広告表示オプションを更新しているお客様は、フィードベースの広告表示オプションが新しいアセットベースの広告表示オプションに移行されます。2022 年 5 月 13 日より、広告表示オプションを取得するスクリプト（広告表示オプションを更新するスクリプトではない）を使用しているお客様のフィードベースの広告表示オプションは、新しいアセットベースの広告表示オプションに移行されます。

概要

注: 広告表示オプションにアクセスまたは更新するスクリプトがない場合は、作業は必要ありません。代わりに、広告表示オプション ガイドを参照してください。

アセットベースの広告表示オプションが採用されたため、既存のフィードベースの広告表示オプションのサポートは終了しました。フィードベースの広告表示オプションは Google 広告の管理画面では「従来型」の広告表示オプションと呼ばれ、アセットベースの広告表示オプションは「アップグレード版」の広告表示オプションと呼ばれます。

2022 年 3 月 28 日より、フィードベースの広告表示オプションは新しいアセットベースの広告表示オプションに移行されます。移行が完了すると、フィードベースの広告表示オプションの配信は停止されます。このガイドでは、Google 広告アカウントにフィードベースとアセットベースの両方の広告表示オプションが設定されている場合と、フィードベースの広告表示オプションのみが設定されている場合の、移行の概要について説明します。

移行の詳細

アセットベースの広告表示オプションへのアクセスや更新を開始するには、新しい Google 広告スクリプト エクスペリエンスを使用する必要があります。リニューアル版 Google 広告スクリプトについて詳しくは、スタートガイドをご覧ください。

広告表示オプションの取得

既存の広告表示オプションセレクタ（SitelinkSelector など）は、フィードベース広告表示オプションまたはアセットベース広告表示オプションのいずれかを取得できます。デフォルトでは、これらのセレクタは、現在配信されている広告表示オプションのタイプを返します。次の表に、現在配信中（デフォルトで返される）広告表示オプションの種類を示します。

アカウント内の広告表示オプションの種類
フィードベースの広告表示オプションのみ	フィードベースの広告表示オプションはデフォルトで返されます
アセットベースの広告表示オプションのみ	アセットベースの広告表示オプションがデフォルトで返される
フィードベースとアセットベースの両方の広告表示オプション	アセットベースの広告表示オプションがデフォルトで返される

フィードベースの広告表示オプションがすべて移行されると、すべての広告表示オプション選択ツールはデフォルトでアセットベースの広告表示オプションを返すようになります。フィードベースの広告表示オプションは、引き続き withOnlyLegacy メソッドで取得できます。これは、過去の指標を収集する場合に便利です。

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

通常は、フィードベースの広告表示オプションの移行前後にコードを変更する必要はありません。ただし、コードの変更が必要になるケースもあります。

広告表示オプションを ID でフィルタする

フィードベースの広告表示オプションを移行すると、対応するアセットベースの広告表示オプションの ID は異なります。つまり、現在スクリプトで広告表示オプションを ID でフィルタしている場合、アセットベースの広告表示オプションを取得できなくなります。

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

この問題に対処するには、別の属性でフィルタするか、アセットベースの広告表示オプションの ID を使用するようにコードを更新します。

統計情報による広告表示オプションのフィルタリング

フィードベースの広告表示オプションを移行すると、対応するアセットベースの広告表示オプションの統計はリセットされます。広告表示オプションを統計情報でフィルタする際は、この点を考慮してください。たとえば、LAST_MONTH に Clicks > 100 を含むサイトリンク表示オプションをリクエストすると、フィードベースの広告表示オプションが移行されたばかりであれば、表示される広告表示オプションは通常より少なくなる可能性があります。

広告表示オプションのパフォーマンス レポートを生成する際も、この点に注意してください。フィードベースの広告表示オプションが移行されると、レポートに大幅な変化や減少が生じる可能性があります。

サポート終了のメソッド

移行の一環として、いくつかのフィールドはサポートされなくなりました。たとえば、開始日と終了日はスニペット拡張機能で非推奨になりました。getStartDate() を呼び出すと、null が返されます。また、警告メッセージがログに記録されます。サポートが終了したメソッドについては、次の表をご覧ください。

クラス	サポート終了のメソッド
コールアウト	サポートが終了したメソッドなし
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
価格	getEndDate getSchedules getStartDate
サイトリンク	サポートが終了したメソッドなし
スニペット	getEndDate getSchedules getStartDate

広告表示オプションの更新

移行の一環として、いくつかのフィールドはサポートされなくなりました。たとえば、スニペット表示オプションの開始日と終了日は非推奨になりました。setStartDate を呼び出しても、広告表示オプションには影響しません。また、警告メッセージがログに記録されます。非推奨になったメソッドについては、次の表をご覧ください。

クラス	サポート終了のメソッド
コールアウト	サポートが終了したメソッドなし
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
価格	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
サイトリンク	サポートが終了したメソッドなし
スニペット	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

広告表示オプションを作成する

既存の広告表示オプション作成ツール（SitelinkBuilder など）では、フィードベースの広告表示オプションまたはアセットベースの広告表示オプションを作成できます。デフォルトでは、現在配信中のどのタイプの広告表示オプションがこれらのビルダーで作成されます。次の表に、現在配信中（デフォルトで作成される）広告表示オプションの種類を示します。

アカウント内の広告表示オプションの種類
フィードベースの広告表示オプションのみ	フィードベースの広告表示オプションがデフォルトで作成されます
アセットベースの広告表示オプションのみ	アセットベースの広告表示オプションがデフォルトで作成される
フィードベースとアセットベースの両方の広告表示オプション	アセットベースの広告表示オプションがデフォルトで作成されます

お客様が広告表示オプションを移行すると、すべての広告表示オプション ビルダーで、デフォルトでアセットベースの広告表示オプションが作成されます。フィードベースの広告表示オプションの掲載は終了するため、フィードベースの広告表示オプションの作成はサポートされなくなります。

デフォルトの動作に依存せずにフィードベースの広告表示オプションを作成する場合は、build() ではなく build(true) を呼び出します。次に例を示します。

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

アセットベースの広告表示オプションを作成したいが、アカウントに現在フィードベースの広告表示オプションしかない場合は、3 月 28 日まで待つか、build(false) にお問い合わせください。

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

サポートされていないフィールド

広告表示オプションの移行に伴い、一部のフィールドはサポートが終了しました。たとえば、スニペット表示オプションの開始日と終了日は非推奨になりました。withEndDate または withStartDate の呼び出しは拡張機能に影響しません。代わりに、警告メッセージがログに記録されます。各クラスで非推奨になったメソッドについては、次の表をご覧ください。

クラス	サポート終了のメソッド
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate