Yahoo!広告 API | Developer Center

English

Yahoo!広告 ディスプレイ広告 API v15 リリースノート

リリースバージョン

v15

リリース日

2024年10月23日（水）

本リリースの主な内容

※オブジェクトなどの詳細は、リファレンスをご確認ください。

1. 友だち追加広告に対応

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

対象サービス

  • AccountAuthorityService
  • CampaignService
  • AdGroupService
  • AdGroupAdService

変更内容

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

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

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

対象サービス

  • AudienceListService
  • AdGroupTargetService

変更内容

  • AudienceListServiceのAudienceListTypeに「LINE公式アカウントの友だち」、「LINE公式アカウントをブロック中の友だち」を追加しました。また、AudienceListServiceSourceTypeに「LINE公式アカウント」を追加しました。
  • AdGroupTargetServiceのAudienceListTypeに「LINE公式アカウントの友だち」、「LINE公式アカウントをブロック中の友だち」を追加しました。

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

SKAdNetwork計測による広告配信の最適化を利用しているキャンペーンにおいて、入札戦略「コンバージョン数の最大化（目標値あり）」の利用に対応しました。また、コンバージョン単価の計算にSKAdNetwork計測のコンバージョンが利用可能になりました。

※広告管理ツールでは先行して提供している機能です。詳しくは以下のお知らせを参照してください。
SKAdNetwork計測に関する機能追加のお知らせ　第二弾

対象サービス

  • CampaignService

変更内容

  • maximizeConversionsBiddingSchemeに「コンバージョン単価の計算に使用するコンバージョン（SKAdNetwork計測）」を追加しました。

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

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

対象サービス

  • StatsService
  • ConversionTrackerService

変更内容

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

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

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

対象サービス

  • AdGroupAdService/add, set

変更内容

  • buttonText enumに以下を追加しました。
    • ゲームプレイ
    • アプリを利用
    • 音楽を聴く

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

一部のパフォーマンスレポートについて、お客様のご利用状況を踏まえ、MCCアカウントによる複数アカウントを指定したレポート作成を終了しました。

※広告管理ツールではすでに終了した機能です。詳しくは以下のお知らせを参照してください。
一部レポートの複数アカウント指定終了と、データ集計期間の変更について

対象サービス

  • ReportDefinitionService

変更内容

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

7. ログイン不要でオーディエンスリストに顧客データをアップロードできる機能に対応

広告管理ツールで発行したオーディエンスリスト（顧客データ）のアップロード用URLから、対象のオーディエンスリストに顧客データをアップロードできる機能に対応しました。

※広告管理ツールでは先行して提供している機能です。詳しくは以下のお知らせを参照してください。
ログイン不要でオーディエンスリストに顧客データをアップロードできる機能を追加

対象サービス

  • AudienceListService/get UploadUserListStatus

変更内容

  • レスポンスに「アップロード元」を追加しました。

8. 保守改善

  • AccountAuthorityService/getのレスポンスから入札戦略を削除しました。
  • StatsServiceのtargetTypesから、提供を終了したPLACEMENT_CATEGORY_DETAIL_TARGETを削除しました。
  • ディスプレイ広告（予約型）の効果測定機能を削除しました。
    • GuaranteedCampaignService/getのbrandTrackingフィールドを削除しました。
    • DictionaryService/getBusinessCategoryを削除しました。
    • SearchLiftServiceを削除しました。
  • ConversionTrackerServiceのappConversionTypeフィールドを削除しました。
  • ReportDefinitionService/getReportFieldsから使用されていない以下のフィールドを削除しました。
    • 広告掲載方式 (DELIVER)
    • 画像自動付与 (IMAGE_OPTION)
    • キャリア (CARRIER)
  • ConversionTrackerServiceとStatsServiceのstatsPeriodに「今月（今日を含まない）」を追加しました。
  • v15を含む全バージョンで、ReportDefinitionService/getReportFieldsにおいて以下のフィールドが新たに返却されるようになりました。
    • 週（月〜日）
  • システム更新日付での検索機能を追加しました。
    対象サービス：CampaignService/get、AdGroupService/get、AdGroupAdService/get
    • リクエストに「updatedDateRange」を追加しました。
    • レスポンスに「updatedDate」を追加しました。
  • AudienceListServiceのadd、setにて組み合わせリスト作成/編集時のエラーコードを変更しました。
    • 変更前
      作成時
      • 基リストが存在しないオーディエンスリスト：210001
      • 基リストが他アカウントの非共有オーディエンスリスト：210001
      • 基リストのリスト種別が組み合わせリスト：210001
      編集時
      • 基リストが存在しないオーディエンスリスト：I0001
      • 基リストが他アカウントの非共有オーディエンスリスト：V0001
      • 基リストのリスト種別が組み合わせリスト：I0001
    • 変更後 上記全てのケースでのエラーコード：V0001

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

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

対象サービス

  • ReportDefinitionService

変更内容

  • reportDownloadEncodeから「EUC」を削除しました。

補足

API v15の概要などをお伝えするオンラインセミナーを開催します。日程などの詳細は以下のお知らせをご確認ください。
Yahoo! JAPAN Ads API Webinar November 2024のご案内

ディスプレイ広告 API v13の提供終了について

以下の日程でディスプレイ広告 API v13の提供を終了します。

サポート終了日：2024年10月30日（水）
システム終了日：2025年3月上旬（予定）
※日程が決まり次第お知らせいたします。

また、ディスプレイ広告 API v12を以下の日程で終了します。

システム終了日：2024年10月30日（水）
※サポートは終了済みです。

更新履歴

2024年10月25日　3. SKAdNetwork計測の広告配信の最適化に入札戦略「コンバージョン数の最大化（目標値あり）」を追加、コンバージョン単価の計算に使用するコンバージョンに対応　からβ版の表記を削除しました。

Developer Center

関連サイト