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

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

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

概要

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

既存のフィードベースの広告表示オプションのパラダイムは非推奨となり、アセットベースの広告表示オプションが採用されました。フィードベースの広告表示オプションは、Google 広告 UI では「従来版」の広告表示オプションと呼ばれます。アセットベースの広告表示オプションは、Google 広告 UI では「アップグレード済み」広告表示オプションと呼ばれます。

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
Price	getEndDate getSchedules getStartDate
サイトリンク	非推奨のメソッドはありません
snippet	getEndDate getSchedules getStartDate

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

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

クラス	サポート終了のメソッド
コールアウト	非推奨のメソッドはありません
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
Price	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
サイトリンク	非推奨のメソッドはありません
snippet	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