Share via


Bing広告 API リリース ノート

Bing Ads API バージョン 13 の月ごとの変更については、以下を参照してください。

破壊的変更 (最近および今後)

重要

次の今後の変更では、サービスの中断や機能の喪失を避けるためにアクションを実行することが必要になる場合があります。

多要素認証 API に関する通知

重要

2022 年 6 月、Bing広告の要件として 多要素認証 を導入しました。 この要件に準拠するには、引き続きコードの変更が必要な場合があります。 Microsoft Advertising は、10 月初旬に技術的な適用チェックを実行しています。

このブログ投稿 では、コンプライアンスを確保するために実行する必要がある手順について説明します。

詳細については、 多要素認証要件 ガイドを参照してください。

2024 年 3 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

  • BulkCampaign で VerifiedTrackingSettings を無効にします。 BulkCampaign の Perfromance Max の新しいフィールド AutoGeneratedImageOptOutAutoGeneratedTextOptOut
  • 一括マッピング BulkAccountNegativeKeywordListBulkAccountNegativeKeywordListAssociationBulkAccountSharedNegativeKeyword for Account Level Negative Keyword List を追加します。
  • BulkCampaign でのパフォーマンスの最大値に対する PageFeedIds のサポート。
  • TargetCostPerSale の一括マッピングを追加します。
  • AutoBiddingBulkSeasonalityAdjustmentBulkDataExclusion の一括マッピングを追加します。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.19 のリリース ノートを参照してください。

2023 年 11 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.18 のリリース ノートを参照してください。

2023 年 8 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

  • キャンペーン管理 API: AdGroup レベルのジャンルクリテリオン、キャンペーン レベルの DealCriterion。
  • Bulk API: LogoAdExtensions。

一括サービス

  • AdGroupGenreCriterion と CampaignDealCriterion の一括サポート。
  • BulkCampaign の新しいフィールド DestinationChannel と IsMultiChannelCampaign、BulkResponsiveAds の VerifiedTrackingData。
  • ImageAsset の TargetWidth と TargetHeight のマッピングを追加しました。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.17 のリリース ノートを参照してください。

2023 年 6 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

  • PMax キャンペーンの一括サポート: AssetGroup、AssetGroupListingGroup、AudienceGroup、AudienceGroupAssetGroupAssociation、CampaignNegativeWebPage。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.16 のリリース ノートを参照してください。

2022 年 12 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

  • OnlineConversionAdjustment の一括サポート

  • Hotel Ad エンティティの一括サポート(HotelAdvanceBookingWindowCriterion、HotelCheckInDayCriterion、HotelCheckInDateCriterion、HotelDateSelectionTypeCriterion、HotelLengthOfStayCriterion、HotelListingGroup)

  • BulkAdGroup での UseOptimizedTargeting、HotelAdGroupType、CommissionRate、PercentCpcBid の一括サポート

重要

UseOptimizedTargeting は非推奨になります。 代わりに UsePredictiveTargeting を 使用します。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.15 のリリース ノートを参照してください。

2022 年 6 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.14 のリリース ノートを参照してください。

2022 年 1 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい API インターフェイス

一括サービス

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.13 のリリース ノートを参照してください。

2021 年 11 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.12 のリリース ノートを参照してください。

2021 年 8 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Google 広告インポート エンティティ マップ

Google 広告から Microsoft Advertising への広告グループ、広告、キーワード (keyword) ID マッピングが、キャンペーン管理 GetImportEntityIdsMapping サービス操作でサポートされるようになりました。 以前は、キャンペーン ID マッピングのみが使用可能でした。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.11 のリリース ノートを参照してください。

2021 年 7 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

マルチメディア広告

マルチメディア広告は、キャンペーン管理 のレスポンシブAd オブジェクトでサポートされています。

ResponsiveAd オブジェクトは、検索ネットワーク内のマルチメディア広告と Microsoft Audience Network のオーディエンス広告に使用されます。

ほとんどのサポートされるプロパティは同じですが、いくつかの主要な差別化要因があります。 詳細については、「レスポンシブ広告 の備考」を参照してください。

無制限かつオープンエンドの挿入順序

Customer Billing InsertionOrder オブジェクトでは、無制限のオープンエンドの挿入注文がサポートされています。

オープンエンドの挿入順序の場合は、 EndDate 要素を nil または空に設定できます。

無制限の予算挿入順序の場合は、 SpendCapAmount 要素を nil または empty に設定できます。

2021 年 6 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

ページ閲覧者ルール標準フォーム展開

リマーケティング リストに 既にページ閲覧者ルール を使用している場合は、必要な変更に関するこちらのセクションをお読みください。

リマーケティング ルールは、リマーケティング リストに追加するユーザーを決定するために使用される条件です。 カスタム イベント、ページ訪問者、別のページにアクセスしなかったページ訪問者、および別のページにアクセスしたページ訪問者のルールを作成できます。

ページ閲覧者ルールの場合、以前は Microsoft Advertising では、非接続標準フォーム (DNF) のみがサポートされました。 まず、各ルール項目グループで、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。 つまり、指定したルール アイテム条件がすべてルール アイテム グループ内で満たされている場合、ユーザーはリマーケティング リストに追加されます。

  • 規則 1 または規則 2
  • (規則 1 AND 規則 2)OR 規則 3
  • (規則 1 AND 規則 2)OR (規則 3 と規則 4)

結膜標準形(CNF)のサポートを導入しています。 まず、各ルール項目グループで、同じページのルール項目の条件が論理 OR 演算子を使用して結合されます。 次に、ルール項目グループの一覧の各結果は、論理 AND 演算子を使用して結合されます。 つまり、すべてのルール アイテム グループ内の指定されたルール アイテム条件のいずれかが満たされている場合、ユーザーはリマーケティング リストに追加されます。

  • 規則 1 と規則 2
  • (規則 1 または規則 2)AND 規則 3
  • (規則 1 または規則 2)AND (規則 3 または規則 4)

この追加は、PageVisitorsRule にのみ適用され、CustomEventsRule、PageVisitorsWhoDidNotVisitAnotherPageRule、または PageVisitorsWhoVisitedAnotherPageRule は含まれません。

重要

新しいページ閲覧者ルールの既定の標準フォームは DNF のままです。 ただし、アプリケーションが CNF と DNF を適切に読み取り、区別できることを確認する必要があります。 アプリケーションでは、規則が不一番であると想定しなくなりました。

新しい標準フォーム プロパティを取得して設定する方法の詳細については、リファレンス ドキュメントを参照してください。

  • キャンペーン管理 API: PageVisitorsRule の NormalForm 要素は、接続または解除に設定できます。
  • 一括 API: 一括ファイルの [リマーケティング ルール] 列を引き続き使用します。 アップロードの場合は、文字列を CNF または DNF として書式設定できます。 ダウンロードするには、アプリケーションで同じ列の文字列を読み取り、CNF と DNF を区別する必要があります。

必要なコンバージョン目標カテゴリ

コンバージョン目標を既に使用している場合は、必要な変更についてこのセクションをお読みください。

コンバージョン目標は分類できますが、ビジネスにとって意味があります。 目標カテゴリはパフォーマンスに影響しません。目標とそのパフォーマンス メトリックをセグメント化するのに役立ちます。

以前Bing広告 API ではコンバージョン目標カテゴリは必要ありませんでした。 目標の種類に応じて、既定のカテゴリは [ダウンロード]、[なし]、[その他]、または [購入] に設定されます。

ここで (2021 年 6 月現在) カスタム イベント、オフラインコンバージョン、または URL の目標を追加または更新するときに、目標カテゴリを設定する必要があります。または、キャンペーン管理サービスからエラーが返されます。 表に示すように、他の目標の種類の既定のカテゴリに変更はありません。

目標の種類 既定の before 既定値の後
EventGoal
OfflineConversionGoal
UrlGoal
なし 既定値はありません。サービスからエラーが返される
DurationGoal
PagesViewedPerVisitGoal
その他 その他
InStoreTransactionGoal 購入 購入
AppInstallGoal ダウンロード ダウンロード

詳細については、 コンバージョン目標カテゴリに関する API ドキュメントを参照してください。

一括ダウンロードのルックバックを減らす

Bulk API を使用してキャンペーンをダウンロード する場合は、特定の日時以降に変更 (追加、更新、削除) された設定の取得のみを要求できます。

以前は、90 日を超える日付と時刻を設定した場合は、エラーが返されます。

最大ルックバック期間は、2021 年 9 月 1 日の 90 日から 30 日に減少しました。 これで、30 日以上前の日付と時刻を設定すると、エラーが返されます。

RSA の資産パフォーマンス ラベル

アセット パフォーマンス ラベルは、レスポンシブ検索広告を取得またはダウンロードするときに、読み取り専用属性として使用できます。

これにより、レスポンシブ検索広告に対して設定した見出しと説明のアセットのパフォーマンスを確認できます。

使用可能な値については、次の表を参照してください。

説明
このアセットのパフォーマンスは低く、広告のパフォーマンスを向上させるには、このアセットを置き換えることをお勧めします。
Good この資産のパフォーマンスは良好です。 広告のパフォーマンスを向上させるには、このアセットを保持し、さらにアセットを追加することをお勧めします。
この資産のパフォーマンスは最高の資産の 1 つであり、同様の資産をさらに追加することをお勧めします。
未評価 この資産のパフォーマンス評価はありません。 これは、資産が非アクティブであること、そのパフォーマンスを判断するのに十分な情報がない、またはそれと比較するのに十分な類似の資産がない場合が原因である可能性があります。
ラーニング 資産のパフォーマンスは積極的に評価されています。 評価が完了すると、資産評価は低、良好、ベスト、または未評価になります。

詳細については、「レスポンシブ Search広告レコード (Bulk API)」と「AssetLink (キャンペーン管理 API)」を参照してください。

動的検索広告

動的検索広告のみをサポートするキャンペーンを追加、更新、または取得することはできなくなります。 既存のキャンペーンのキャンペーンの種類が "DynamicSearchAds" から "Search" に更新されました。 広告グループは現在、"動的" 広告グループと見なされますが、構造的な変更はありません。つまり、以前と同じ自動ターゲットと動的検索広告が含まれています。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.10 のリリース ノートを参照してください。

2021 年 5 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

動的検索広告

DynamicSearchAds キャンペーンタイプでは、新しいキャンペーンを追加できなくなります。 キャンペーンの種類は、5 月と 6 月の間に "DynamicSearchAds" から "Search" に更新されています。 これらのキャンペーンは、キャンペーンタイプの更新の前後でも表示および編集できます。

2021 年 4 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

ポートフォリオ入札戦略

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。近日公開予定です。

ポートフォリオ入札戦略は、すべて同じ目標に向けて取り組んでいる複数のキャンペーンにわたる入札を管理する自動入札機能です。

コンバージョン数、クリック数、ターゲットインプレッションシェア、その他のパフォーマンス目標を最大化するかどうかに関係なく、同じ戦略を共有するパフォーマンスの高いキャンペーンとパフォーマンスの高いキャンペーンのバランスを取るために、入札単価が自動的に調整されます。 ポートフォリオ入札戦略は、予算全体が効率的に使われるようにしたい広告主にとって最適なオプションです。

必要なのは、入札戦略の種類を選択し、ポートフォリオに補完的な予算を含むキャンペーンを含める必要があります。 Microsoft Advertising では、ポートフォリオ全体のパフォーマンスに基づいて入札単価が調整されます。 ポートフォリオに共有予算を持つキャンペーンが含まれている場合は、同じ予算を共有するすべてのキャンペーンを含める必要があります。

ポートフォリオ入札戦略は、補完的なキャンペーンと入札戦略の種類を使用して、1 つの目標を念頭に置いて最適に機能します。 ポートフォリオの入札戦略の種類を変更することはできません。 ポートフォリオ内のキャンペーンで別の入札戦略を使用する場合は、別のポートフォリオに移動できます。 キャンペーンタイプを選択すると、ポートフォリオにはそのタイプのキャンペーンのみを含めることができます。

ポートフォリオ入札戦略は、キャンペーン管理 BidStrategy オブジェクトと一括 入札戦略 レコードでサポートされています。

ターゲットインプレッションシェア

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。近日公開予定です。

ターゲットインプレッションシェアは、広告を表示する広告の掲載位置のターゲットインプレッションシェアを取得するために使用できる自動入札戦略です。

ターゲットインプレッションシェアは、キャンペーン管理 BidStrategyCampaignTargetImpressionShareBiddingScheme オブジェクトと一括 入札戦略キャンペーン レコードを介してサポートされます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.9 のリリース ノートを参照してください。

2021 年 3 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.8 のリリース ノートを参照してください。

2020 年 12 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.7 のリリース ノートを参照してください。

2020 年 11 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

オークションインサイトの絶対トップページレート

ページの絶対トップ レートは、オーガニック検索結果の上の最初の広告として広告が表示される回数を、実際に受け取ったインプレッションの合計数で割った回数として定義されます。 ページの上部にある広告は、クリック数が増える傾向があります。

AbsoluteTopOfPageRate 要素は既定では返されません。 詳細については、 AuctionInsightKpiAdditionalField 値セットに関するページを参照してください。

レスポンシブ広告のインプレッション トラッキング URL

1x1 インプレッション トラッキング ピクセルの URL。 各ピクセルは、Microsoft Audience Network のインプレッションをサード パーティの広告レポート ツールに報告します。 レスポンシブ広告ごとに最大 2 つのインプレッショントラッキング URL を含めることができます。

Microsoft Audience Network インプレッションごとに、Microsoft は URL に ping を実行して、サード パーティの広告レポート ツールでインプレッショントラッキングを有効にします。 Cookie や IP アドレスに基づくコンバージョンの追跡や追跡など、高度なユーザー追跡はサポートされていません。

インプレッショントラッキング URL は、キャンペーン管理 レスポンシブアド オブジェクトと一括 レスポンシブ広告 レコードでサポートされています。

キャンペーン管理サービスで広告を取得した場合、 ImpressionTrackingUrls 要素は既定では返されません。 詳細については、 AdAdditionalField 値セットに関するページを参照してください。

チラシ広告表示オプション

チラシ拡張機能を使用すると、広告主は潜在的な顧客に製品カタログまたは店舗カタログ (チラシ) を配布できます。 「毎週のお得な情報」や「毎週の売上」などの広範なクエリに目立つように表示できるため、買い物客はコンペティションの代わりに広告をクリックするよう促すことができます。 その性質上、検索者への通知を改善し、その結果、クリック率などのユーザー エンゲージメントを高めるのに役立ちます。

チラシ拡張機能は、キャンペーン管理 FlyerAdExtension オブジェクトと Bulk Flyer Ad Extension レコードでサポートされています。

注:

機能パイロットのお客様は、チラシ拡張機能を利用できます (GetCustomerPilotFeatures は 802 を返します)。

プロミネンス メトリック

目立つ指標を使用すると、検索結果ページに広告が表示される場所をより包括的に把握できます。 これらの明確な分析情報は、入札戦略の最適化に役立ちます。

AbsoluteTopImpressionRatePercent 列と TopImpressionRatePercent 列は、次のレポート列の値セットに追加されます。

2020 年 10 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.6 のリリース ノートを参照してください。

2020 年 8 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

レポート形式のバージョン

FormatVersion 要素が ReportRequest データ オブジェクトに追加されます。

特定のフィールドのデータ形式は、既存のクライアント アプリケーションを中断することなく、現在の API バージョン内で更新できます。 形式バージョン 1.0 と 2.0 の違いについては、 レポート 形式バージョンのテクニカル ガイドを参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.5 のリリース ノートを参照してください。

2020 年 7 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.4 のリリース ノートを参照してください。

2020 年 6 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

顧客リスト

顧客リストは、顧客の一致を有効にするためにコンパイルした顧客連絡先情報のセットです。

注:

顧客リストは、機能パイロットの顧客が利用できます (GetCustomerPilotFeatures は 579 を返します)。

顧客リストは Bulk API を介して利用できますが、キャンペーン管理 API を使用してはまだ使用できません。 Bulk API を使用すると、顧客リストのターゲットまたは除外に次のレコードの種類を使用できます。

対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。

2020 年 5 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

結合リスト

結合リストは、複数の既存の対象ユーザーの組み合わせから作成された対象ユーザーです。

注:

組み合わせリストは、機能パイロットのお客様が利用できます (GetCustomerPilotFeatures は 618 を返します)。

Bulk API を使用すると、結合されたリスト ターゲットまたは除外に次のレコードの種類を使用できます。

Campaign Management API を使用すると、 CombinedList オブジェクトを使用できます。

対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。

並列追跡

並列追跡は、2020 年 5 月 31 日以降に作成されたすべてのアカウントに必要です。 2020 年 11 月まで、2020 年 6 月 1 日より前に作成されたアカウントの機能を有効または無効にすることができます。つまり、 account プロパティtrue または false に設定します。 2020 年 11 月末までに、すべてのアカウントで並列追跡が有効になり、値は true にのみ設定できます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.3 のリリース ノートを参照してください。

2020 年 4 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

プロモーション広告拡張機能

プロモーション拡張機能では、テキスト広告の特別な販売とオファーが強調表示されます。 オファーを目立たせることで、潜在的な顧客が広告をクリックする可能性が高く、より多くの売上を生み出すのに役立ちます。

プロモーション広告拡張機能をアカウントに関連付けるか、アカウント内のキャンペーンや広告グループに関連付けることができます。 各エンティティ (アカウント、キャンペーン、または広告グループ) は、最大 20 個のプロモーション広告表示オプションに関連付けることができます。

注:

プロモーション拡張機能は、機能パイロットのお客様が利用できます (GetCustomerPilotFeatures は 720 を返します)。

プロモーション広告拡張機能の一括 API

Bulk API では、次のレコードの種類を使用してプロモーション広告拡張機能を管理します。

キャンペーン管理 API for プロモーション広告拡張機能

Campaign Management API では、たとえば、AddAdExtensions サービス操作を介して PromotionAdExtension オブジェクトを使用します。

配置の除外リスト

アカウント レベルの Web サイトの除外のサポートがキャンペーン管理 API に追加されます。 除外サイト (NegativeSite) は、共有 Web サイトの除外リスト (PlacementExclusionList) から追加および削除できます。 Web サイトの除外リストは、複数の広告アカウントと共有または関連付けることができます。

注:

Web サイトの除外リストは、再設計された Microsoft Advertising UI (ツール - 共有ライブラリ ->> Web サイトの除外リスト) でのみ表示できます。 表示されない場合は、サインイン時に "新しい Microsoft Advertising を試す" プロンプトを探します。 再設計された Microsoft Advertising を使用するには、UI パイロットにも参加している必要があります (GetCustomerPilotFeatures は 522 を返します)。

新しい Web サイトの除外リストは、共有エンティティと共有リスト操作 ( AddSharedEntityAddListItemsToSharedList など) を使用して管理できます。 以前は、これらの操作は負のキーワード (keyword)リストにのみ使用されていました。既存のアプリケーションはコードを変更せずに動作する必要があります。 詳細については、「 Negative Sites テクニカル ガイド」を参照してください。

Microsoft Audience Network のインプレッション シェア

AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent 列が次の値セットに追加されます。

2020 年 3 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

アカウントタイム ゾーン別の広告スケジュール

アカウントタイム ゾーン別の広告スケジュール設定は、パイロットのお客様が利用できます (GetCustomerPilotFeatures は 655 を返します)。 今年の後半には、すべての顧客で利用できるようになります。

AdScheduleUseSearcherTimeZone 要素は、[ キャンペーン] オブジェクトと [広告グループ キャンペーン管理] オブジェクトで使用できます。 [ 広告スケジュールの使用検索のタイム ゾーン ] フィールドは、[ キャンペーン ] レコードと [広告グループ の一括] レコードで使用できます。

各キャンペーンと広告グループの新しいプロパティによって、広告を配信できるアカウントのタイム ゾーンと検索ユーザーのタイム ゾーンのどちらを使用するかが決まります。

注:

この要素を指定しない場合、または null のままにすると、既定値の true が設定され、検索ユーザーのタイム ゾーンが使用されます。 2020 年第 2 四半期の終わりまたは 2020 年第 3 四半期の初めに、新しい既定値 false が 設定され、アカウントのタイム ゾーンが使用されます。

2020 年 2 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

レポートの目標と目標の種類

Goal 列と GoalType 列は、次の値セットに追加されます。

これらの列は 、GoalsAndFunnelsReportColumn 値セットで既に使用できます。

目標は、目的のコンバージョンに設定した目標の名前です。つまり、広告をクリックした後にユーザーが実行するアクションです。 目標の種類は、コンバージョン目標の種類です。 使用可能な値には、 AppInstallDurationEventInStoreTransactionOfflineConversionPagesViewedPerVisitURL などがあります

2020 年 1 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

高速予算配信の非推奨

2020 年 1 月の時点で、共有予算と非共有予算の予算タイプは、すべての DynamicSearchAds、Shopping、Search キャンペーンの読み取り専用であり、設定しようとした予算タイプの値はエラーを返さずに無視されます。 以前の予算設定は高速から標準に移行され、API は DynamicSearchAds、ショッピング、Searchキャンペーン、およびすべての共有予算に対してのみ "DailyBudgetStandard" を返します。 オーディエンス キャンペーンでは、引き続き高速予算を使用できます。 オーディエンス キャンペーン レベルの非共有予算では、予算タイプデータは移行されません。 ただし、オーディエンス キャンペーンで共有予算が使用されている場合は、上記のように予算の配信が変更される可能性があります。

アクション広告拡張機能の種類

2020 年 1 月以降、9 種類のアクションが非推奨になりました。 たとえば、アクションの種類を "参照" に設定した場合、エラーは返されませんが、"LearnMore" はアクション広告拡張機能を取得するときに格納および返される有効な値です。 アプリケーションでは、非推奨の値の代わりに置換値を使用する必要があります。

非推奨のアクションの種類 置換アクションの種類
参照 LearnMore
参照 LearnMore
メッセージ ContactU
NewCars ViewCars
詳細については、以下を参照してください。 LearnMore
StartFree FreeTrial
UsedCars ViewCars
ViewNow LearnMore
VisitSite LearnMore

また、2020 年 1 月から、RenewNow と Reorder という 2 種類の新しいアクションが追加されました。 キャンペーン管理 API を使用する場合、既定で返されるアクションの種類は [不明] であることに注意してください。 (設計目標は、厳密な値セットの依存関係を持つクライアントの破壊的変更を回避することです)。有効なアクションの種類 (RenewNow または Reorder) を決定するには、GetAdExtensionsAssociations および GetAdExtensionsByIds 操作を呼び出すときに ActionTypesPhase3含めます。

2020 年 1 月以降の最後の更新プログラムの 1 つで、販売とクーポンのローカライズされたテキストのみが、サポートされているすべての言語でそれぞれ "販売の確認" と "クーポンの取得" に更新されます。 API 値セットは、これらのアクションの種類に対して変更されません。 現在のローカライズされたテキストについては、「 Action Ad Extensions のアクション テキスト」を参照してください。

2019 年 12 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.2 のリリース ノートを参照してください。

2019 年 11 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

最後の URL サフィックスとカスタム パラメーターの展開

最終的な URL サフィックスは、すべての顧客のアカウント、キャンペーン、広告グループ、広告グループの条件、広告、キーワード (keyword)レベルで使用できるようになりました。 最終的な URL サフィックスは、フェーズ 3 パイロットのお客様のアクション、価格、サイトリンク広告拡張機能レベルで使用できます (GetCustomerPilotFeatures は 636 を返します)。

すべての顧客のアカウント、キャンペーン、広告グループ、広告グループの条件、広告、キーワード (keyword)レベルで、最大 8 つのカスタム パラメーターと長いカスタム パラメーター値を使用できるようになりました。 カスタム パラメーターの制限の増加フェーズ 3 パイロット (GetCustomerPilotFeatures は 635 を返します) のアクション、価格、サイトリンク広告拡張レベルでは、最大 8 つのカスタム パラメーターと長いカスタム パラメーター値を使用できます。

詳細については、「 アップグレードされた URL を使用した URL 追跡」を参照してください

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 13.0.1 のリリース ノートを参照してください。

2019 年 10 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

変換を通じてビューを含める

ビュースルーコンバージョンとは、ユーザーが広告をクリックしなかった場合でも、広告を見た後に行うコンバージョンです。

機能パイロットに参加している場合 (GetCustomerPilotFeatures は 616 を返します)、この機能は既定で有効になっています。つまり、パフォーマンス レポートの "All" 変換列の値にはビュースルー変換が含まれます。 ビュースルー変換を含めない場合は、無効にすることもできます。

一括およびキャンペーン管理 API を使用して、各アカウントの機能を有効または無効にすることができます。

キャンペーン管理 API を使用すると、変換ウィンドウでビューを管理できます。つまり、 DurationGoalEventGoalPagesViewedPerVisitGoal、または UrlGoal の ViewThroughConversionWindowInMinutes プロパティを取得または設定できます。 GetConversionGoalsByIds と GetConversionGoalsByTagIds を呼び出すときは、追加フィールドとして ViewThroughConversionWindowInMinutes を明示的に要求してください。

注:

ビュースルー変換には UETTag が必要であるため、このプロパティは AppInstallGoalInStoreTransactionGoalOfflineConversionGoal には適用されません。

プロファイル拡張が有効

アカウント全体で LinkedIn プロファイル のターゲット設定を展開して、現在のターゲットと同様の追加の顧客にリーチするかどうかを決定します。

プロファイルターゲティングの拡張を有効にすると、Microsoft Advertising は、現在ターゲットに設定しているユーザーと同様に、追加の顧客に広告を表示できます。 たとえば、特定の LinkedIn 対象ユーザー セグメントをターゲットにした場合、確認済みの LinkedIn アカウントを持たないが、そのセグメントの LinkedIn ユーザーと同じ特性を共有するユーザー Bingも対象になります。

一括およびキャンペーン管理 API を使用して、各アカウントの機能を有効または無効にすることができます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.6 のリリース ノートを参照してください。

2019 年 9 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

実験の種類

実験分割の種類は、[実験キャンペーン管理] オブジェクトの ExperimentType 要素を使用するか、[実験の一括] レコードの [実験の種類] フィールドを使用して設定できるようになりました。

実験の分割タイプは、実験と元のキャンペーンの個々の顧客の広告をランダムに表示するか、どちらか一方からのみ表示するかを決定します。

使用可能な値には、TrafficBased と CookieBased が含まれます。

TrafficBased: これは検索ベースのオプションとも呼ばれます。 ユーザーが検索するたびに、実験の広告または元のキャンペーンの広告がランダムに表示されます。 これは、個々の顧客が複数回検索した場合、両方のソースから広告を表示できることを意味します。

CookieBased: 個々のユーザーが検索する場合、実験または元のキャンペーンの広告が表示され、Cookie を使用して今後、このソースからの広告のみが表示されるようにします。 Cookie ベースのオプションには、考慮すべき重要なトレードオフがあります。一方では、個々の顧客が 1 つのソースまたは他のソースにのみ応答していることを確認しているため、より正確なデータが得られる場合があります。 一方、検索ベースのオプションよりも統計的に有意な比較データを構築するのに時間がかかる場合があります。

レポートの最終 URL サフィックス

FinalUrlSuffix 列が AdPerformanceReportColumn 値セットに追加されます。 FinalUrlSuffix 列は、 AdGroupPerformanceReportColumnCampaignPerformanceReportColumnDestinationUrlPerformanceReportColumnKeywordPerformanceReportColumn 値セットを使用して使用することもできます。

最終的な URL サフィックスは、ランディング ページ URL の末尾に添付されるパラメーターを追加できる、最終 URL の場所です。

製品の負のキーワード レポート

ProductNegativeKeywordConflictReportRequest が Microsoft ショッピング キャンペーン用に追加されました。 このレポートを使用して、ショッピング キャンペーンに適用される除外キーワードによってキャンペーンのパフォーマンスが過度に制限されていないことを確認します。 除外キーワードと、ショッピング キャンペーンに表示できない対応する商品をリクエストできます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.5 のリリース ノートを参照してください。

2019 年 8 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

レポートの対象ユーザー関連付けレベル

AssociationLevel 列が AudiencePerformanceReportColumn 値セットに追加されます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.4 のリリース ノートを参照してください。

2019 年 7 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

コンバージョンに含める

[コンバージョンに含める] 機能 (GetCustomerPilotFeatures から 574 が返されます) が有効になっているお客様は、コンバージョン レポート データから特定のコンバージョン目標を除外できます。

ExcludeFromBidding プロパティが true に設定されている変換目標のデータは、、およびRevenueレポート列からRevenuePerConversionConversionsConversionRateCostPerConversionReturnOnAdSpend除外されます。 また、自動入札戦略を使用する場合、このプロパティを true に設定すると、目標のコンバージョンが自動入札計算に考慮されなくなります。

AllConversionsAllConversionRateAllCostPerConversionAllReturnOnAdSpendAllRevenuePerConversion、および AllRevenue 列 (NEW) には、ExcludeFromBidding 設定に関係なく、すべての変換目標のデータが含まれます。

詳細については、ヘルプ記事 「コンバージョンの目標: "コンバージョン" と "すべてのコンバージョン"」を参照してください。

7 月のサービス更新後、次の表は、レポートの種類ごとに使用可能なすべての変換関連レポートのパフォーマンス統計をまとめたものです。

レポート値セット 使用可能な変換列
AccountPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdDynamicTextPerformanceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
変換
ConversionRate
CostPerConversion
AdExtensionByAdReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionByKeywordReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionDetailReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdGroupPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AgeGenderAudienceReportColumn AllConversions
AllRevenue
変換
収益
AudiencePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
CampaignPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ConversionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DestinationUrlPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSAAutoTargetPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSACategoryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSASearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GeographPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GoalsAndFunnelsReportColumn AllConversions
AllRevenue
変換
収益
KeywordPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductDimensionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionUnitPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductSearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
RevenuePerConversion
ProfessionalDemographicsAudienceReportColumn AllConversions
AllRevenue
変換
収益
PublisherUsagePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
SearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ShareOfVoiceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
変換
ConversionRate
CostPerConversion
UserLocationPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
変換
収益
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion

レポートの基本キャンペーン ID

BaseCampaignId 列が次の値セットに追加されます。

レポートの平均位置

AveragePosition 列が ProfessionalDemographicsAudienceReportColumn 値セットに追加されます。

レポートの対象ユーザー関連付け ID

AssociationId 列が AudiencePerformanceReportColumn 値セットに追加されます。

2019 年 6 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.3 のリリース ノートを参照してください。

最終 URL サフィックスとカスタム パラメーターの更新

最終的な URL サフィックスとカスタム パラメーターの更新が、すべての顧客のアカウント、キャンペーン、広告グループ、キーワード (keyword) レベルで一般公開されるようになりました。 広告、広告表示オプション、広告グループの条件に関する同様の更新は、引き続きパイロットのお客様のみが利用できます。

  • 最終的な URL サフィックスは、すべての顧客のアカウント、キャンペーン、広告グループ、キーワード (keyword) レベルで使用できるようになりました。 最終 URL サフィックスは、フェーズ 2 パイロットのお客様の広告、広告拡張機能、広告グループの条件で使用できます (GetCustomerPilotFeatures は 566 を返します)。 今年の後半には、すべての顧客の広告、広告拡張機能、広告グループの条件に対して最終 URL サフィックスが使用できるようになります。
  • キャンペーン、広告グループ、キーワードのカスタム パラメーターの上限が、すべての顧客に対して 3 から 8 に引き上げられています。 Microsoft Advertising は、含める最初の 8 つのカスタム パラメーター キーと値のペアを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 広告、広告拡張機能、広告グループの条件に関するカスタム パラメーターの制限の増加フェーズ 2 パイロット (GetCustomerPilotFeatures は 565 を返します) のお客様の場合、Microsoft Advertising は、含める最初の 8 つのカスタム パラメーター キーと値のペアを受け入れ、8 つ以上のカスタム パラメーターを含む場合はエラーが返されます。 2019 年の暦年中に、広告、広告表示オプション、広告グループの基準の上限が、すべての顧客に対して 3 から 8 に引き上げられます。

月曜日から日曜日のレポート集計

レポート API は、月曜日から日曜日の毎週の集計をサポートするように更新されます。 以前は、毎週日曜日から土曜日までの集計しかできませんでした。

WeeklyStartingMonday 値が ReportAggregation 値セットに追加されます。

ThisWeekStartingMondayLastWeekStartingMondayおよび LastFourWeeksStartingMonday の値が ReportTimePeriod 値セットに追加されます。

プロミネンス メトリック

新しく改善された目立つ指標により、検索結果ページに広告が表示される場所をより包括的に把握できるようになりました。 これらのより明確な分析情報は、入札戦略の最適化に役立ちます。

AbsoluteTopImpressionRatePercent、AbsoluteTopImpressionShareLostToBudgetPercent、AbsoluteTopImpressionShareLostToRankPercent、TopImpressionRatePercent、TopImpressionShareLostToBudgetPercent、TopImpressionShareLostToRankPercent、および TopImpressionSharePercent 列は、次のレポート列値セットに追加されます。

ツール別の変更履歴レポート

[ ツール ] 列が変更履歴レポートで使用できるようになりました。 Web クライアント、エディター、一括アップロード、またはキャンペーン管理 API を使用した場合など、アカウント、キャンペーン、広告の属性に対する変更方法を決定できます。

Bulk API を使用したフィード

フィードフィード項目の一括レコードは、広告カスタマイザー フィードページ フィードの両方の一括ダウンロードとアップロードをサポートするために追加されます。

[ページ フィード ID] フィールドが、ページ フィードキャンペーン レコードに追加されます。

2019 年 5 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

アシストコンバージョン

アシストコンバージョンとは、メーカーパートナーから共同入札を受けた広告のクリックによるコンバージョンです。 このパフォーマンス統計は、Microsoft ショッピング キャンペーンのスポンサー製品でのみ使用できます。 AssistedConversions 列は、次のレポート列の値セットに追加されます。

動的Search広告テキストパート2

動的Search広告テキスト パート 2 は、パイロットのお客様が利用できます (GetCustomerPilotFeatures は 600 を返します)。 今年の後半には、すべての顧客で利用できるようになります。

TextPart2 要素は、DynamicSearchAd Campaign Management オブジェクトで使用できます。 [テキスト パート 2] フィールドは、[動的Search広告一括] レコードで使用できます。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK が更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.2 のリリース ノートを参照してください。

2019 年 4 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

新しい運用 OAuth エンドポイント

開発者向けのMicrosoft ID プラットフォーム エンドポイントが利用可能になりました。 Microsoft ID プラットフォーム エンドポイントでは、Azure AD の職場または学校アカウントと、hotmail.com、outlook.com、msn.com などの個人用 Microsoft アカウント (MSA) の両方が許可されます。 Live Connect エンドポイントでは、個人アカウントでの認証のみが許可されます。

重要

ユーザーが職場または学校のアカウントを持っていない場合でも、Bing広告 API SDK を使用しない場合でも、Live Connect エンドポイントが Microsoft Advertising ユーザーに推奨されるアプローチではなくなったため、2019 年の暦年中に承認 URL を更新することをお勧めします。

Bing Ads API SDK Updates

Bing Ads .NET、Java、Php、Python SDK は、バージョン 13 のサポートで更新されます。 詳細については、Microsoft Advertising .NETJavaPhpPython SDK バージョン 12.13.1 のリリース ノートを参照してください。

バージョン 13 の一般提供

Bing Ads API バージョン 13 が一般公開されました。 Bing Ads API バージョン 13 の提供により、バージョン 12 は非推奨となり、2019 年 10 月 31 日までに終了します。 詳細については、「 バージョン 13 への移行」を参照してください。

2019 年 3 月

このカレンダー月のBing広告 API の更新については、以下を参照してください。

バージョン 13 プレビュー

Bing Ads API バージョン 13 はプレビューで使用できます。 バージョン 12 からの移行の詳細については、「 バージョン 13 への移行」を参照してください。