Microsoft Advertising Scripts のリリース ノート

各リリースに含まれていた変更の詳細については、次のセクションを参照してください。

2021 年 3 月 31 日

平均掲載順位は、Microsoft Advertising では使用できなくなりました。

getAveragePosition メソッドは Stats オブジェクトから削除されます。

AveragePosition 列は、次のセレクターを使用して条件として削除されます。

• AdGroupAudienceSelector
• AdGroupSelector
• AdSelector
• BudgetSelector
• CampaignAudienceSelector
• CampaignSelector
• KeywordSelector
• ProductGroupSelector
• TargetedLocationSelector

2021 年 3 月 5 日

総インプレッション数に対する割合として、絶対トップインプレッション率とトップインプレッション率のサポートが追加されました。

Stats オブジェクトに次のメソッドを追加しました。

• getAbsoluteTopImpressionRate
• getTopImpressionRate

次のセレクターで指定できる列と TopImpressionRate を追加しましたAbsoluteTopImpressionRate。

• AdGroupAudienceSelector
• AdGroupSelector
• AdSelector
• BudgetSelector
• CampaignAudienceSelector
• CampaignSelector
• KeywordSelector
• ProductGroupSelector
• TargetedLocationSelector

2021 年 2 月 23 日

レスポンシブ検索広告のサポートを追加しました。

• レスポンシブ検索広告を定義する ResponsiveSearchAd オブジェクトを追加しました。

• レスポンシブサーチAdBuilder オブジェクトを追加しました。このオブジェクトを使用して、展開されたテキスト広告を広告グループに追加しました。

• メソッドを responsiveSearchAdBuilderAdBuilderSpace オブジェクトに追加しました。 レスポンシブ検索広告を作成する場合は、 メソッドを responsiveSearchAdBuilder 呼び出して 、ResponsiveSearchAdBuilder オブジェクトを取得します。

• レスポンシブ検索広告の説明と見出しのプロパティを含む AdTextAsset オブジェクトを追加しました。

• responsiveSearchAd AdTypeSpace オブジェクトに メソッドを追加しました。このオブジェクトには、指定した種類の広告があるかどうかをテストするために使用されるメソッドが含まれています。 たとえば、広告がレスポンシブ検索広告であるかどうかをテストします。

• responsiveSearchAd AdViewSpace オブジェクトに メソッドを追加しました。これは、広告を特定の種類にキャストするために使用されます。 たとえば、ベース広告オブジェクトをレスポンシブ検索広告にキャストします。

2021 年 1 月 21 日

対象ユーザーと除外対象ユーザーのサポートが追加されました。

この変更によって、次のオブジェクトが追加されました。

• AdGroupAudience
• AdGroupAudienceBuilder
• AdGroupAudienceIterator
• AdGroupAudienceOperation
• AdGroupAudienceSelector
• AdGroupExcludedAudience
• AdGroupExcludedAudienceIterator
• AdGroupExcludedAudienceOperation
• AdGroupExcludedAudienceSelector
• AudienceBidding
• CampaignAudience
• CampaignAudienceBuilder
• CampaignAudienceIterator
• CampaignAudienceOperation
• CampaignAudienceSelector
• CampaignExcludedAudience
• CampaignExcludedAudienceIterator
• CampaignExcludedAudienceOperation
• CampaignExcludedAudienceSelector
• UserList
• UserListIterator
• UserListSelector

2020 年 12 月 10 日

対象の場所と除外された場所のサポートが追加されました。

この変更によって、次のオブジェクトが追加されました。

• ExcludedLocation
• ExcludedLocationIterator
• ExcludedLocationSelector
• TargetedLocation
• TargetedLocationIterator
• TargetedLocationSelector

ExcludedLocationOperation オブジェクトを追加しました。これを使用して、スクリプトによって除外された場所が正常に追加されたかどうかを判断します。

ターゲットの場所がスクリプトによって正常に追加されたかどうかを判断するために使用する TargetedLocationOperation オブジェクトが追加されました。

2020 年 3 月 31 日

ProductGroup から派生する次のオブジェクトを追加しました。

• ProductChannel
• ProductChannelExclusivity

ProductGroup に次のメソッドを追加しました。

• asChannel()
• asChannelExclusivity()

いくつかのスクリプト例から Logger.Log() の呼び出しを削除しました。 ログ記録はパフォーマンスの面で高価な呼び出しであるため、ガイダンスでは、問題の通知を提供する以外は、ログ記録を控えめに使用し、おそらく大量のループ内にありません。 また、複数 Log() の呼び出しを使用して複数の行を書き込む代わりに、1 つの呼び出しを使用し、改行文字 ('\n') を含めます。

2020年 1 月 16 日

製品グループのサポートを追加しました。 サポートは、製品グループの列挙と入札の更新に限定されます。 例については、「スクリプトの 例」を参照してください。

この変更によって、次のオブジェクトが追加されました。

• ProductGroup
• ProductGroupIterator
• ProductGroupSelector

ProductGroup から派生する次のオブジェクトを追加しました。

• ProductBrand
• ProductCategory
• ProductCondition
• ProductCustomLabel
• ProductItemId
• ProductType

AdsApp に次のメソッドを追加しました。

• productGroups
• shoppingAdGroups
• shoppingCampaigns

AdGroup に次のメソッドを追加しました。

• productGroups
• rootProductGroup

Cammpaign に次のメソッドを追加しました。

• productGroups

AdGroupSelector オブジェクトの withCondition メソッドに、考えられる列として CampaignType を追加しました。

CampaignSelector オブジェクトの withCondition メソッドに、可能な列として Type を追加しました。

2019 年 10 月 18 日

Id AdSelector オブジェクトと KeywordSelector オブジェクトのメソッドに列withCondition()を追加しました。 この列を使用すると、 withCondition('Id > 1234')指定した ID (たとえば) を超える ID を持つ広告やキーワードを確認できます。

[ 広告とキーワード URL の確認] スクリプト ソリューションを追加しました。これを使用して、アカウント内の広告またはキーワードに壊れた URL が含まれているかどうかを確認できます。

2019 年 10 月 7 日

キーワードを選択するときに指定できる列として追加しました CombinedApprovalStatus 。 たとえば、 列を使用して、編集上の理由で不承認となったキーワードを選択できます。 「KeywordSelector.withCondition」を参照してください。

2019 年 9 月 13 日

ExecutionInfo オブジェクトを追加しました。このオブジェクトには、スクリプトが現在実行されている環境に関する情報が含まれています。 たとえば、スクリプトがプレビュー モードで実行されている場合、またはスクリプトの実行を続行できる時間が長い場合です。

getExecutionInfo AdsApp オブジェクトに メソッドを追加しました。 オブジェクトを取得するには、このメソッドを ExecutionInfo 使用します。

getRemainingDailyQuota UrlFetchApp オブジェクトに メソッドを追加しました。 ユーザーが現在行うことができる呼び出しの fetch() 残りの数を取得するには、このメソッドを使用します。

2019 年 8 月 20 日

ドキュメントのみの変更を次に示します。

• スクリプトは、Microsoft Advertising の他の場所と同様にアカウントのタイム ゾーンを使用することを明確にしました。 たとえば、セレクターの .forDateRange() メソッドを使用する場合、Scripts はアカウントのタイム ゾーンを使用して、返されるデータを決定します。 続きを読む
• スクリプトのデータ待機時間が Microsoft Advertising の他の場所と同じであることを明確にしました。 続きを読む

ラベルをサポートするための破壊的でない API の変更を次に示します。

• AdsApp オブジェクトに次のメソッドを追加しました。
  • createLabel — ラベルを作成します
  • labels — このアカウントのラベルの一覧をフィルター処理するために使用されるセレクターを取得します
• 次のラベル関連オブジェクトを追加しました。
  • ラベル — ラベルを定義します。
  • LabelSelector — アカウントのラベルの一覧を取得します。
  • LabelIterator — セレクターの選択基準に一致するラベルの一覧を反復処理します。
• Keyword オブジェクトに次のメソッドを追加しました。
  • applyLabel — キーワードにラベルを適用します
  • labels — このキーワードに適用されるラベルのリストをフィルター処理するために使用されるセレクターを取得します
  • removeLabel — このキーワードからラベルを削除します
• KeywordSelector オブジェクトの withCondition メソッドに LabelNames 列を追加しました。
• Ad オブジェクトと ExpandedTextAd オブジェクトに次のメソッドを追加しました。
  • applyLabel — ラベルを広告に適用します
  • labels — この広告に適用されるラベルのリストをフィルター処理するために使用されるセレクターを取得します
  • removeLabel — この広告からラベルを削除します
• AdSelector オブジェクトの withCondition メソッドに LabelNames 列を追加しました。
• AdGroup オブジェクトに次のメソッドを追加しました。
  • applyLabel — 広告グループにラベルを適用します
  • labels — この広告グループに適用されるラベルの一覧をフィルター処理するために使用されるセレクターを取得します
  • removeLabel — この広告グループからラベルを削除します
• AdGroupSelector オブジェクトの withCondition メソッドに LabelNames 列を追加しました。
• Campaign オブジェクトに次のメソッドを追加しました。
  • applyLabel — キャンペーンにラベルを適用します
  • labels — このキャンペーンに適用されるラベルの一覧をフィルター処理するために使用されるセレクターを取得します
  • removeLabel — このキャンペーンからラベルを削除します
• CampaignSelector オブジェクトの withCondition メソッドに LabelNames 列を追加しました。

2019 年 4 月 30 日

ドキュメントのみの変更を次に示します。

• Bing広告が Microsoft Advertising になりました。 新しい名前は、より多くのお客様にリーチできるように広告ソリューションを拡大する方法を反映しています。 ドキュメント内のBing広告プラットフォームへの参照はすべて、Microsoft Advertising に変更されました。

ブランドの更新をサポートするための破壊的でない API の変更を次に示します。

• AdsApp オブジェクトを追加しました。 スクリプトでは、下位互換性のために BingAdsApp オブジェクトが引き続きサポートされます。ただし、できるだけ早く新しいオブジェクトを使用するようにスクリプトを更新することをお勧めします。

2019 年 3 月 25 日

ドキュメントのみの変更を次に示します。

• [不承認の検出] 広告ソリューションを追加しました。

2019 年 2 月 11 日

BingAdsAccountStats オブジェクトに次のメソッドを追加しました。

• getConversionRate
• getConversions
• getReturnOnAdSpend
• getRevenue

注意

getClickConversionRate() メソッドと getConvertedClicks() メソッドを使用する場合は、代わりに getConversionRate() メソッドと getConversions() メソッドを使用するようにスクリプトを更新する必要があります。

Stats オブジェクトに次のメソッドを追加しました。

• getConversionRate
• getConversions
• getReturnOnAdSpend
• getRevenue

注意

getClickConversionRate() メソッドと getConvertedClicks() メソッドを使用する場合は、代わりに getConversionRate() メソッドと getConversions() メソッドを使用するようにスクリプトを更新する必要があります。

2018 年 11 月 27 日

ドキュメントのみの変更を次に示します。

• Google サービスの呼び出しに関するトピックを追加しました。 このトピックでは、 UrlFetchApp を 使用して Google サービスを呼び出す方法について説明します。

2018 年 11 月 7 日

ドキュメントのみの変更を次に示します。

• プレビュー ノートを変更して、スクリプトがオープン ベータ版になり、すべての Microsoft Advertising ユーザーが利用できるようになったことを示しました。

2018 年 10 月 4 日

これはスクリプトのベータ版リリースです。 プログラムへの参加については、アカウント マネージャーにお問い合わせください。 スクリプトのクラスとドキュメントは変更される可能性があります。

URL フェッチをサポートするために、次のオブジェクトを追加しました。

• UrlFetchApp オブジェクトを追加しました。これは、Web からリソースをフェッチするために使用する最上位のオブジェクトです。

• フェッチされたリソースの内容にアクセスするためのメソッドを含む HTTPResponse を追加しました。

• UrlFetch の制限に関するトピックを追加しました。このトピックには、Web からリソースをフェッチするための制限が一覧表示されています。

次のトピックを追加します。

• ポリシー
• 制限
• ベスト プラクティス

2018 年 10 月 2 日

マルチアカウントをサポートするために、次のオブジェクトとメソッドを追加しました。

• メソッドを currentAccountBingAdsApp に追加しました。 このメソッドを使用して、 スクリプトが現在 処理しているアカウントに関する情報を含む Account オブジェクトを取得します。

• AccountsApp オブジェクトを追加しました。 これは、他のユーザーのアカウントを管理する場合に使用する最上位のオブジェクトです。 これを使用して、アクセス権を持つアカウントの一覧を取得し、管理するアカウントを選択します。

• BingAdsAccount オブジェクトを追加しました。 これを使用して、名前、顧客 ID、アカウント レベルのパフォーマンス データなどのマネージド アカウントのアカウント情報を取得します。

• BingAdsAccountIterator オブジェクトを追加しました。 これを使用して、選択したマネージド アカウントの一覧を反復処理します。

• BingAdsAccountSelector オブジェクトを追加しました。 これを使用して、取得するマネージド アカウントの一覧を選択します。

• BingAdsAccountStats オブジェクトを追加しました。 これを使用して、マネージド アカウントのパフォーマンス データにアクセスします。

• ExecutionResult オブジェクトを追加しました。 これを使用して、セレクター メソッドで指定した関数の結果と戻り値を executeInParallel 取得します ( BingAdsAccountSelector を参照してください)。

共有予算をサポートするために、 次 のフィールドを Budget オブジェクトに追加しました。

• campaigns — この予算を共有するすべてのキャンペーンを返すセレクターを取得します。
• getEntityType — オブジェクトの型を取得します。
• getId — 共有予算を一意に識別する ID を取得します。
• getName — 共有予算の名前を取得します。
• getStats — この予算を共有するキャンペーンのパフォーマンス データを取得します。
• getType — 予算の種類 (DAILY など) を取得します。
• isExplicitlyShared — この予算が共有予算であるかどうかを示すブール値を取得します。

getNameメソッド、、および getStats メソッドはgetId共有予算のみのデータを返しますgetId。メソッドと getName メソッドは、非共有 (個々のキャンペーン) 予算の場合は null を返します。

BingAdsApp オブジェクトに次のフィールドを追加しました。

• budgets — アカウント内のすべての共有予算を取得します。 セレクターを使用して、共有予算の一覧をフィルター処理します。

共有予算の一覧をフィルター処理してループするために使用する次のオブジェクトを追加しました。

• BudgetSelector - 共有予算の一覧をフィルター処理および順序付けするためのメソッドが含まれます。

• BudgetIterator - 共有予算の一覧をループするためのメソッドが含まれています。 セレクターの get メソッドは反復子を返します。

セレクターは共有予算のみを返し、非共有 (個々のキャンペーン) 予算は含まれません。 キャンペーンで個々の予算が使用されているかどうかを判断するには、キャンペーンの getBudget メソッドを呼び出して予算を取得します。 次に、予算の isExplicitlyShared メソッドを呼び出して、予算が共有されているかどうかを判断します。 true が返された場合isExplicitlyShared、予算は共有されます。

2018 年 10 月 1 日

Keyword オブジェクトに次のメソッドを追加しました。

• getQualityScore — キーワードの品質スコアを取得します。 スコアは 1 から 10 (最高) の範囲にあります。 スコアは、顧客の検索語句に対するキーワードとランディング ページの関連性を測定することで、マーケットプレースでの広告の競争力を示します。

2018 年 9 月 12 日

エンティティの親エンティティと子エンティティを取得するための次のメソッドを追加しました。

• AdGroup.getCampaign — 広告グループが属するキャンペーンを取得します。
• AdGroup.keywords — 広告グループのキーワードリストをフィルター処理するために使用されるセレクターを取得します。
• AdParam.getAdGroup — この置換パラメーターに関連付けられているキーワードが属する広告グループを取得します。
• AdParam.getKeyword — 置換パラメーターが適用されるキーワードを取得します。
• Campaign.adGroups - キャンペーンの広告グループのリストをフィルター処理するために使用されるセレクターを取得します。
• Campaign.keywords — キャンペーンのキーワードリストをフィルター処理するために使用されるセレクターを取得します。
• Keyword.getCampaign — キーワードが属するキャンペーンを取得します。
• Keyword.getAdGroup — キーワードが属する広告グループを取得します。
• NegativeKeywordList.campaigns — 除外キーワード リストが関連付けられているキャンペーンのリストをフィルター処理するために使用されるセレクターを取得します。

2018 年 9 月 9 日

広告のサポートを追加しました。

• メソッドを newAdAdGroup に追加しました。 メソッドは AdBuilderSpace オブジェクトを返します。これは、広告ビルダーを取得するために使用します。

• AdBuilderSpace オブジェクトを追加しました。 オブジェクトには、広告ビルダーを取得するためのメソッドが含まれています。 たとえば、拡張テキスト広告を作成する場合は、オブジェクトの expandedTextAdBuilder メソッドを呼び出して ExpandedTextAdBuilder オブジェクトを取得します。

• ExpandedTextAdBuilder オブジェクトを追加しました。これは、展開されたテキスト広告を広告グループに追加するために使用します。

• AdOperation オブジェクトを追加しました。これは、スクリプトが広告を正常に追加したかどうかを判断するために使用します。

• AdViewSpace オブジェクトを追加しました。このオブジェクトには、広告を特定の種類にキャストするために使用されるメソッドが含まれています。 たとえば、ベース広告オブジェクトを展開されたテキスト広告にキャストします。

• AdTypeSpace オブジェクトを追加しました。このオブジェクトには、広告が指定した種類であるかどうかをテストするために使用されるメソッドが含まれています。 たとえば、広告が拡張テキスト広告であるかどうかをテストします。

• 基本広告の種類である Ad オブジェクトを追加しました。 テキスト広告も定義します。

• AdUrls オブジェクトを追加しました。このオブジェクトには、広告の URL、追跡テンプレート、カスタム パラメーターを取得するためのメソッドが含まれています。

• 拡張テキスト広告を定義する ExpandedTextAd オブジェクトを追加しました。

• 広告を選択するためのフィルター条件を指定するために使用する AdSelector オブジェクトを追加しました。

• フィルター処理された広告の一覧を反復処理するために使用する AdIterator オブジェクトを追加しました。

• メソッドを adsBingAdsApp に追加しました。 メソッドは AdSelector オブジェクトを返します。このオブジェクトを使用して、アカウント内の広告を選択するためのフィルター条件を指定します。

• メソッドを adsAdGroup に追加しました。 このメソッドは AdSelector オブジェクトを返します。これは、広告グループ内の広告を選択するためのフィルター条件を指定するために使用します。

• メソッドを adsCampaign に追加しました。 メソッドは AdSelector オブジェクトを返します。これは、キャンペーンで広告を選択するためのフィルター条件を指定するために使用します。

2018 年 6 月 15 日

クローズド ベータ リリース。 Microsoft Advertising Scripts のこのリリースは、参加者のみを選択できます。 プレビュー リリース プログラムへの参加については、アカウント マネージャーにお問い合わせください。 スクリプトのクラスとドキュメントは変更される可能性があります。

この初期リリースには、次の機能が含まれています。

• 主要なキャンペーン管理 (キャンペーン、広告グループ、キーワード)
• エンティティ レベルのパフォーマンス データ (キャンペーン、広告グループ、キーワード)
• Shared Negative キーワード リスト