LINEヤフー広告 API | Developer Center
English2026/04/20
【検索広告】レスポンシブ検索広告のアセット単位の指標追加および掲載評価の提供終了について
対象サービス
LINEヤフー広告 検索広告
実施日（予定）
2026年6月頃
※詳細な日程は追ってお知らせいたします。
※日程は変更になる場合があります。
概要
レスポンシブ検索広告において、アセット単位で確認できるパフォーマンスデータの項目を追加します。
これにより、各アセットのクリック率やコンバージョン率などの実績を詳細に把握でき、広告運用や改善に活用しやすくなる効果が期待できます。
追加されるパフォーマンスデータは、アセット一覧画面およびパフォーマンスレポートにて確認可能です。
また、本対応に伴い、これまで提供していた「掲載評価」の項目は提供を終了します。
追加項目は以下のとおりです。
| 項目の区分 | 項目名 | APIでの項目名称 |
|---|---|---|
| 数値項目 | クリック数 | CLICKS |
| クリック率 | CLICK_RATE | |
| コスト | COST | |
| 平均CPC | AVG_CPC | |
| コンバージョン数 | CONVERSIONS | |
| コンバージョン率 | CONV_RATE | |
| コスト/コンバージョン数 | COST_PER_CONV | |
| コンバージョンの価値 | CONV_VALUE | |
| コンバージョンの価値/コンバージョン数 | VALUE_PER_CONV | |
| コンバージョンの価値/コスト | CONV_VALUE_PER_COST | |
| クロスデバイスコンバージョン数 | CROSS_DEVICE_CONVERSIONS | |
| コンバージョン数（全て） | ALL_CONV | |
| コンバージョン率（全て） | ALL_CONV_RATE | |
| コスト/コンバージョン数（全て） | COST_PER_ALL_CONV | |
| コンバージョンの価値（全て） | ALL_CONV_VALUE | |
| コンバージョンの価値（全て）/コンバージョン数（全て） | VALUE_PER_ALL_CONV | |
| コンバージョンの価値（全て）/コスト | ALL_CONV_VALUE_PER_COST | |
| 分割項目 | デバイス | DEVICE |
ご注意
レポートのテンプレートに「掲載評価」が含まれている場合、当該項目は自動的に削除され、その他の項目は保持された状態で上書きされます。
LINEヤフー広告 検索広告 APIへの影響
対象バージョン: 全バージョン
対象ウェブサービス: ReportDefinitionService
内容: 実施日以降、以下のとおり変更されます。
-
getReportFields（レポートフィールドの取得）
- リクエストにRESPONSIVE_ADS_FOR_SEARCH_ASSETを指定した場合、レスポンスのfields[]に今回追加される項目が含まれるようになります。また、「PERFORMANCE」が含まれなくなります。
-
add（定義追加）
- リクエストのfields[]、filters[].field、sortFields[].fieldに今回追加される項目を設定可能になります。
- リクエストのfields[]に「PERFORMANCE」が含まれていた場合、出力されるレポートの「掲載評価」列は空欄になります。※今後、本条件によるリクエストをエラーにする改修を予定しています。
- リクエストのfilters[].fieldに「PERFORMANCE」が含まれていた場合、エラーが返るようになります。
- リクエストのsortFields[].fieldに「PERFORMANCE」が含まれていた場合、エラーが返るようになります。
前述のとおり、add（定義追加）のリクエストで「PERFORMANCE」を指定している場合は仕様が変更になりますのでご注意ください。