Skip to content
This repository has been archived by the owner on Nov 30, 2021. It is now read-only.

Latest commit

 

History

History
318 lines (294 loc) · 14.9 KB

ReleaseNotes.md

File metadata and controls

318 lines (294 loc) · 14.9 KB

リリースノート

スポンサードサーチAPI V201901

リリースバージョン

V201901（WSDLバージョン V201901）

本リリースの主な内容

※対象データオブジェクトとEnumerationは、データオブジェクト（Enumeration）集をご確認ください。

1. ラベル機能に対応

ラベル機能とは、キャンペーンや広告などの入稿物に目印となる語句を設定し、分類やフィルタリングができる機能です。広告管理ツールでは2018年9月にリリースしました。
機能の詳細は以下のヘルプをご覧ください。
ラベル機能とは

スポンサードサーチAPI V201901では主に以下を対応しました。

  1. ラベルの新規作成、更新、削除が可能
  2. キャンペーンなどへのラベルの設定が可能
対象ウェブサービス

2. 標準入札設定の追加と「コンバージョン数の最大化」項目の削除

2018年12月に、スポンサードサーチの自動入札の機能として新たに標準入札設定を追加し、入札設定は以下の二通りとなりました。

  • 標準入札設定：新たに追加した入札設定です。キャンペーン単位で入札方法を設定します。
  • ポートフォリオ入札設定：従来より提供している入札設定です。アカウント単位で入札方法を作成し、複数のキャンペーンに設定可能です。

変更内容の詳細は以下のお知らせをご覧ください。
自動入札の機能追加と自動入札タイプの一部提供終了および一部項目の削除について

スポンサードサーチAPI V201901では主に以下を対応しました。

  1. CampaignServiceにて、以下の自動入札タイプを標準入札設定として設定可能
    ‐ クリック数の最大化（TARGET_SPEND）
    ‐ コンバージョン単価の目標値（TARGET_CPA）
    ‐ 広告費用対効果の目標値（TARGET_ROAS）
  2. 自動入札タイプのコンバージョン数の最大化（ENHANCED_CPC）を削除
対象ウェブサービス

3. サイトリターゲティングにカスタムキーの設定機能を追加

サイトリターゲティング用タグに、カスタムキーが設定可能になりました。
設定したカスタムキーを利用したターゲットリストを作成することで、より精緻な条件を指定したサイトリターゲティングが行えます。
※2018年12月10日のお知らせでは本機能の名称を「カスタムパラメータ」とお伝えしておりましたが、「カスタムキー」に名称が変更となりました。

スポンサードサーチAPI V201901では主に以下を対応しました。

  1. ターゲットリストの条件にカスタムキーを設定可能
  2. カスタムキー設定情報の取得が可能
ご注意

V201901のリリース以降、V201808以前のバージョンで、ターゲットリストにカスタムキーの条件を1件以上設定している場合、ターゲットリストの条件取得、更新時の挙動が以下のとおり制限されます。

  • ターゲットリストに設定されているすべての条件の取得ができません。
  • ターゲットリストの条件更新時、更新前に設定済みの条件はすべて削除され、セットした条件のみが設定されます。

このため、V201808以前のバージョンでカスタムキー（カスタムパラメータ）を利用すると、ユーザーの意図と異なる操作結果となる可能性があります。
V201901のリリース以降は、最新のバージョンをご利用くださいますようお願いいたします。

対象ウェブサービス

4. 広告の品質向上に向けた取り組みへの対応

スポンサードサーチでは、商標権者により商標の使用を制限することでブランドを保護し、広告の品質を高める取り組みを予定しています。

スポンサードサーチAPI V201901では主に以下を対応しました。

  • 商標の使用制限の有無を判別するためのフラグ（TrademarkStatus）と、エラーコードを追加

※商標の使用制限がかけられている場合、入稿時にバリデーションエラーとなります（公開中のすべてのバージョン）。
※本施策の詳細は、後日あらためてお知らせいたします。

対象ウェブサービス

5. 自動タグ設定に対応

自動タグ設定とは、セキュリティを強化したブラウザーでもコンバージョン測定が可能なタグの機能です。

スポンサードサーチAPI V201901では主に以下を対応しました。

  • 自動タグの設定情報の参照、更新が可能になります。

※本機能は一部のお客様のみご利用可能です。

対象ウェブサービス

6. システムの保守、改善

  • システムの保守、改善として、主に不要な項目の削除、一部WSDLの見直しを実施しました。
  • 2018年9月にお知らせしていたとおり、スポンサードサーチAPIの広告グループにおける自動入札設定のレスポンスを修正しました（公開中のすべてのバージョン）。
  • 仕様書のレポートフィールド集に各レポートフィールドの動作を表す「動作区分/Behavior Type」列を追加しました（公開中のすべてのバージョン）。

※「Serviceの変更による各Versionへの影響」の項目もあわせてご確認ください。

対象ウェブサービス

Serviceの変更による各Versionへの影響

Service V201808以前 V201901
CampaignService ・インターフェース変更なし
・設定された以下の自動入札タイプが参照可能
‐ 「クリック数の最大化」(TARGET_SPEND)
‐ 「コンバージョン単価の目標値」(TARGET_CPA)
‐ 「広告費用対効果の目標値」(TARGET_ROAS)
 ・ラベルIDの取得が可能
・キャンペーン単位の標準入札設定として、以下の自動入札タイプの設定、削除、参照が可能
‐ 「クリック数の最大化」(TARGET_SPEND)
‐ 「コンバージョン単価の目標値」(TARGET_CPA)
‐ 「広告費用対効果の目標値」(TARGET_ROAS)
・自動入札タイプ「コンバージョン数の最大化」（ENHANCED_CPC）関連項目の削除
・広告表示最適化フラグを削除
・旧自動入札機能（2014年7月提供終了）関連項目を削除
BiddingStrategyService インターフェース変更なし 自動入札タイプ「コンバージョン数の最大化」（ENHANCED_CPC）関連項目の削除
FeedItemService ・インターフェース変更なし
・商標の使用制限がかけられている場合、入稿時にバリデーションエラーとなる 		・商標の使用制限がかけられている場合、入稿時にバリデーションエラーとなる
・商標の使用制限の有無を判別するためのフラグの値を参照可能
AdGroupService ・インターフェース変更なし
・広告グループにおける自動入札設定のレスポンスを修正
※詳細は2018年9月のお知らせをご参照ください。 		・ラベルIDの取得が可能
・自動入札に関する不要な項目削除
・広告グループにおける自動入札設定のレスポンスを修正
※詳細は2018年9月のお知らせをご参照ください。
AdGroupAdService ・インターフェース変更なし
・商標の使用制限がかけられている場合、入稿時にバリデーションエラーとなる 		・ラベルIDの取得が可能
・商標の使用制限がかけられている場合、入稿時にバリデーションエラーとなる
・商標の使用制限の有無を判別するためのフラグの値を参照可能
AdGroupCriterionService ・インターフェース変更なし ・ラベルIDの取得が可能
・自動入札に関する不要な項目削除
LabelService - ・ラベルの新規作成、更新、削除、参照が可能
CampaignLabelService - ・キャンペーンへのラベルの設定、解除が可能
AdGroupLabelService - ・広告グループへのラベルの設定、解除が可能
AdGroupAdLabelService - ・広告へのラベルの設定、解除が可能
AdGroupCriterionLabelService - ・キーワードへのラベルの設定、解除が可能
RetargetingListService ・インターフェース変更なし
・V201808以前のバージョンで、カスタムキー（カスタムパラメータ）の条件を1件以上設定しているターゲットリストにおいて、ターゲットリストの条件取得、更新時の挙動が以下のとおり制限される
- ターゲットリストに設定されているすべての条件の取得が不可
- ターゲットリストの条件更新時、更新前に設定済みの条件はすべて削除され、セットした条件のみが設定される 		・ターゲットリストの条件にカスタムキーが設定可能
・広告対象のウェブサイトに設定されている、サイトリターゲティング用タグ内のカスタムキーの取得が可能
BidLandscapeService ・インターフェース変更なし ・BidLandscapeService.wsdlのselectorにpaging項目を追加
AccountTrackingUrlService ・インターフェース変更なし ・AccountTrackingUrlService.wsdlのOperatorのenum値「ADD」を削除（未提供のため）
ConversionTrackerService ・インターフェース変更なし ・デバイスをまたいでコンバージョン計測をするかしないかを制御するフラグを削除
AccountService ・インターフェース変更なし ・自動タグの設定、参照が可能
※本機能は一部のお客様のみご利用可能
CampaignTargetService ・インターフェース変更なし ・CampaignTargetService.wsdlにおいて、Page.TypeとtotalNumEntriesのレスポンスの順番を変更
AdGroupWebpageService ・インターフェース変更なし ・AdGroupWebpageService.wsdlにおいて、service nameの誤植を修正
PageFeedItemService ・インターフェース変更なし ・AdGroupWebpageService.wsdlにおいて、service nameの誤植を修正
・AdGroupWebpageService.wsdlにおいて、operationsのmaxOccursを"unbounded"から"1"に修正

スポンサードサーチAPI V201805の提供終了について

以下の日程でスポンサードサーチAPI V201805のサポート、およびシステムの提供を終了いたします。

  • サポート終了日：2019年2月28日（木）
  • システム終了日：2019年5月29日（水）