LY Ads API | Developer Center
日本語2026/06/03
Search Ads: Adding asset metrics for Responsive Ads for Search and discontinuation of performance ratings
Updates
- June 3, 2026: This article has been updated following the completion of the implementation.
- May 18, 2026: This article has been updated following the confirmation of the schedule.
- April 20, 2026: Publication of this article has started.
Product
LY Ads Search Ads
Schedule
June 2, 2026 (Tue)
Summary
For Responsive Ads for Search,we have added performance data fields that can be checked at the asset level.
This enhancement is expected to make it easier to understand detailed performance metrics such as click-through rate and conversion rate for each asset, and to utilize them for ad operations and optimization.
The added performance data can be confirmed on the asset list screen and in performance reports.Data from June 5, 2025 onward can be retrieved.
In addition, with this update, the previously provided "Performance Rating" field has been discontinued.
The added fields are as follows.
| Field Category | Field Name | Field Name in API |
|---|---|---|
| Numeric Fields | Clicks | CLICKS |
| CTR | CLICK_RATE | |
| Cost | COST | |
| Avg. CPC | AVG_CPC | |
| Conversions | CONVERSIONS | |
| Conv. rate | CONV_RATE | |
| Cost/conv. | COST_PER_CONV | |
| Conv. value | CONV_VALUE | |
| Conv. value/conv. | VALUE_PER_CONV | |
| Conv. value/cost | CONV_VALUE_PER_COST | |
| Cross-device conv. | CROSS_DEVICE_CONVERSIONS | |
| Conversions (all) | ALL_CONV | |
| Conv. rate (all) | ALL_CONV_RATE | |
| Cost/conv. (all) | COST_PER_ALL_CONV | |
| Conv. value (all) | ALL_CONV_VALUE | |
| Conv. value (all)/conv. (all) | VALUE_PER_ALL_CONV | |
| Conv. value (all)/cost | ALL_CONV_VALUE_PER_COST | |
| Segment Fields | Device | DEVICE |
Notes
If "Performance Rating" is included in a report template, the field will be automatically removed and the template will be overwritten while retaining the other fields.
Impact on LY Ads Search Ads API
Applicable versions: All versions
Applicable web service: ReportDefinitionService
Details: The following changes have been made since the implementation date.
-
getReportFields (Retrieve report fields)
- If RESPONSIVE_ADS_FOR_SEARCH_ASSET is specified in the request, the fields added in this update are now included in fields[] in the response. In addition, "PERFORMANCE" is no longer included.
-
add (Add definition)
- The fields added in this update can now be specified in fields[], filters[].field, and sortFields[].field of the request.
- If "PERFORMANCE" is included in fields[] of the request, the "Performance Rating" column in the output report will be blank. *We plan to update this behavior in the future to return an error for such requests.
- If "PERFORMANCE" is included in filters[].field of the request, an error will be returned.
- If "PERFORMANCE" is included in sortFields[].field of the request, an error will be returned.
As mentioned above, please note that the specifications have changed if "PERFORMANCE" is specified in the add (Add definition) request.