Yahoo!広告 API | Developer Center

English

2024/10/24

【Yahoo!広告】API v15 システムリリースについて

更新履歴

2024 年 10 月 24 日 APIv15 のリリース完了に伴い記事を更新しました。
初回お知らせ時よりリリース内容が変更になっています。詳細は以下のリリースノートをご確認ください。
Yahoo!広告 検索広告 API v15 リリースノート
Yahoo!広告 ディスプレイ広告 API v15 リリースノート

-----------------------------------------------------------

Yahoo!広告 APIの新バージョンをリリースします。詳細を以下のとおりお知らせいたしますので、ご確認ください。

対象サービス

Yahoo!広告 検索広告 API
Yahoo!広告 ディスプレイ広告 API

リリースのバージョン

v15

実施日（予定）

2024年10月23日（水）
※日程は変更になる場合があります。

検索広告 APIの変更点

A/Bテストに対応

広告のパフォーマンスを比較する「A/Bテスト」機能に対応します。実際に利用可能になるのは機能のリリース後となります。機能の詳細やリリース時期などは以下のお知らせを参照してください。
A/Bテスト機能の提供について

  • 対象サービス
    • AbTestService/get, set, remove, graduateTest
    • AuditLogService/add
  • 変更内容
    • AbTestServiceを新設します。このサービスでA/Bテストの設定や情報取得などが可能です。
    • AuditLogService/addの「AuditLogServiceEntityType」に「AB_TEST」を追加します。

入札戦略の最適化に使用するコンバージョンの選択に対応

キャンペーンごとに入札戦略の最適化に使用するコンバージョンを選択できる機能に対応します。また、本件に伴い、複数のコンバージョンをまとめられるコンバージョングループの作成機能にも対応します。どちらも実際に利用可能になるのは機能のリリース後となります。機能の詳細やリリース時期などは以下のお知らせを参照してください。
入札戦略の最適化に使用するコンバージョンを選択する機能の提供について

  • 対象サービス
    • ConversionGroupService/add, set, get, remove
    • CampaignService/add, set, get
    • ConversionTrackerService
  • 変更内容
    • ConversionGroupServiceを新設します。このサービスではコンバージョングループの作成や更新、情報取得が可能です。
    • CampaignService/add, set, getに「conversionSetting」を追加します。
    • ConversionTrackerServiceのレスポンスに「origin」（コンバージョンの発生元）を追加します。

レポートから文字コード「EUC」を削除

v15を含む全バージョンで、文字コード「EUC」でのレポート作成ができなくなります。

  • 対象サービス
    • ReportDefinitionService
  • 変更内容
    • reportDownloadEncodeから「EUC」を削除します。

KeywordForecastMetricsServiceを削除

  • 対象サービス
    • KeywordForecastMetricsService
  • 変更内容
    • 既に提供終了しているKeywordForecastMetricsServiceを削除します。

ディスプレイ広告 APIの変更点

友だち追加広告に対応

LINE公式アカウントの友だち追加を目的とした「友だち追加広告」に対応します。なお、友だち追加広告の利用にはLINE公式アカウントとディスプレイ広告アカウントとの接続が必要です。詳しくは以下のお知らせを参照してください。
LINE公式アカウントの友だち追加広告 提供開始について

  • 対象サービス
    • AccountAuthorityService
    • CampaignService
    • AdGroupService
    • AdGroupAdService
  • 変更内容
    • AccountAuthorityServiceで取得できるキャンペーン目的に「友だち追加」を追加します。
    • CampaignServiceの入札戦略に「個別友だち追加単価」「友だち追加数の最大化」を追加します。
    • AdGroupServiceの入札戦略に「個別友だち追加単価」「友だち追加数の最大化」を追加します。また、キャンペーン目的「友だち追加」用の除外友だちリスト指定用のフィールドを追加します。
    • AdGroupAdServiceに「レスポンシブ（友だち追加）」広告を追加します。

友だち追加広告の提供に伴うオーディエンスリスト種別の追加

友だち追加広告の提供に伴い、オーディエンスリスト種別を追加します。

  • 対象サービス
    • AudienceListService
    • AdGroupTargetService
  • 変更内容
    • AudienceListServiceのAudienceListTypeに「LINE公式アカウントの友だち」、「LINE公式アカウントをブロック中の友だち」を追加します。また、AudienceListServiceSourceTypeに「LINE公式アカウント」を追加します。
    • AdGroupTargetServiceのAudienceListType「LINE公式アカウントの友だち」、「LINE公式アカウントをブロック中の友だち」を追加します。

SKAdNetwork計測の広告配信の最適化に入札戦略「コンバージョン数の最大化（目標値あり）」を追加、コンバージョン単価の計算に使用するコンバージョンに対応（β版）

SKAdNetwork計測による広告配信の最適化を利用しているキャンペーンでの、入札戦略「コンバージョン数の最大化（目標値あり）」の利用に対応します。また、コンバージョン単価の計算にSKAdNetwork計測のコンバージョンが利用可能になります。本機能はβ版のため、挙動が不安定な場合があります。
※広告管理ツールでは先行して提供している機能です。詳しくは以下のお知らせを参照してください。
SKAdNetwork計測に関する機能追加のお知らせ　第二弾

  • 対象サービス
    • CampaignService
  • 変更内容
    • maximizeConversionsBiddingSchemeに「コンバージョン単価の計算に使用するコンバージョン（SKAdNetwork計測）」を追加します。

パフォーマンスデータの表示変更

パフォーマンスデータの表示期間を変更します。

  • 対象サービス
    • StatsService
    • ConversionTrackerService
  • 変更内容
    • StatsServiceと ConversionTrackerService のStatsPeriod で取得する集計期間がAPI実行時点の日付になります。また、各項目の「速報値」「確定値」の表記を削除します。
    • period.periodEndDate, period.periodStartDateからperiodTimeフィールドを削除します。

レスポンシブ広告のボタンを追加

レスポンシブ広告の作成時に、選択可能なボタン文言を追加します。リリース内容について詳しくは以下のお知らせを参照してください。
広告入稿仕様の一部変更ついて

  • 対象サービス
    • AdGroupAdService/add, set
  • 変更内容
    • buttonText enumに以下を追加します。
      ゲームプレイ
      アプリを利用
      音楽を聴く

一部レポートの複数アカウント指定終了

一部のパフォーマンスレポートについて、お客様のご利用状況を踏まえ、MCCアカウントによる複数アカウントを指定したレポート作成を終了します。
※広告管理ツールでは先行して提供している機能です。詳しくは以下のお知らせを参照してください。
【Yahoo!広告】一部レポートの複数アカウント指定終了と、データ集計期間の変更について

  • 対象サービス
    • ReportDefinitionService
  • 変更内容
    • 対象のレポート
      コンバージョン経路レポート
      横断リーチレポート
      アトリビューションモデル比較レポート
    • v15ではreportTypeConditionの以下のフィールドを削除します。
      /conversionPathReportCondition/conversionPathAccountSetting
      /crossCampaignReachesReportCondition/crossCampaignIds[]/account
      /crossCampaignReachesReportCondition/crossCampaignGoals[]/account
      /crossCampaignReachesReportCondition/crossCampaignBuyingTypes[]/account
      /modelComparisonReportCondition/modelComparisonAccountSetting
    • v14以前のバージョンでは、上記フィールドに値を設定するとエラーになります。

AccountAuthorityServiceでレスポンスされる入札戦略の変更

  • 対象サービス
    • AccountAuthorityService/get
  • 変更内容
    • レスポンスから入札戦略を削除します。

提供終了したtargetTypesの削除

  • 対象サービス
    • StatsService
  • 変更内容
    • targetTypesからPLACEMENT_CATEGORY_DETAIL_TARGETを削除します。

ディスプレイ広告（予約型）の効果測定機能の削除

  • 対象サービス
    • GuaranteedCampaignService
    • DictionaryService
    • SearchLiftService
  • 変更内容
    • GuaranteedCampaignService/getのbrandTrackingフィールドを削除します。
    • DictionaryService/getBusinessCategoryを削除します。
    • SearchLiftServiceを削除します。

レポートから文字コード「EUC」を削除

v15を含む全バージョンで、文字コード「EUC」でのレポート作成ができなくなります。

  • 対象サービス
    • ReportDefinitionService
  • 変更内容
    • reportDownloadEncodeから「EUC」を削除します。

ConversionTrackerServiceからappConversionTypeフィールドを削除

    • 対象サービス
      • ConversionTrackerService
      • 変更内容
        • appConversionTypeフィールドを削除します。

レポートから不要な項目を削除

      • 対象サービス
        • ReportDefinitionService/getReportFields
      • 変更内容
        • 使用されていない以下のフィールドを削除します。
          広告掲載方式 (DELIVER)
          画像自動付与 (IMAGE_OPTION)
          キャリア (CARRIER)

ConversionTrackerServiceとStatsServiceのstatsPeriodに「今月（今日を含まない）」を追加

      • 対象サービス
        • ConversionTrackerService/get
        • StatsService/get
      • 変更内容
        • statsPeriodのENUMに「今月（今日を含まない）」を追加します。

補足

      • 各機能に関する詳細は、リリース時に公開されるリリースノート、およびリファレンスをご確認ください。
      • リリースに合わせて、APIv15の概要などをお伝えするオンラインセミナーを開催する予定です。詳細は別途お知らせします。

旧バージョンの終了について

Yahoo!広告 APIv13の提供を以下の日程で終了します。
サポート終了日：2024年10月30日（水）
システム終了日：2025年3月上旬（予定）
※日程が決まり次第お知らせいたします。

また、Yahoo!広告 APIv12の提供を以下の日程で終了します。
システム終了日：2024年10月30日（水）
※サポートは終了済みです。

Developer Center

関連サイト