Display Ads API v13 Release Note

Version released

v13

Date

February 19, 2024

Changes on Yahoo! JAPAN Ads Display Ads API

*More about objects and other details are described in the reference document.

1. New list type "Advanced segments" for audience list targeting

A new list type, "Advanced segments," became available. It is one of the audience list targeting options merged with search keyword targeting.

*This feature is already available in the Campaign Management Tool. See the following announcement for details.
Migration and end of search keyword targeting

Services

AudienceListService
AudienceTargetService
EstimatedUserSizeService

Changes

• Added "ADVANCED_SEGMENTS" to AudienceListType of AudienceListService and AdGroupTargetService.
• Added a new EstimatedUserSizeService (get).

2. Yahoo! JAPAN Tag Manager

We made the following changes before the end of the Yahoo! JAPAN Tag Manager scheduled for June 2024.

Services

AudienceListService

Changes

Removed "CUSTOM_UID_KEY" from the uploadType of AudienceList.

3. Ad type (prev) item removal

We removed the "Ad type (prev)" item from the report.

Services

ReportDefinitionService

Changes

Removed the "AD_TYPE_PREV" field from the report.

4. Changes in tracking tools for app conversion tracking

We removed tools that are no longer available for tracking app conversions.

Services

AudienceListService
AppLinkService
CampaignService

Changes

Removed "BRANCH" from the appVendors of each service.

5. Changes in download file specifications for performance reports

The following changes have been made to the performance report download file.

File format Before After
CSV Enclose all non-numeric items in double-quotation marks (").
*This specification doesn't apply to certain items.
Enclose non-numeric items that contain commas (,) or double quotation marks (") in double quotation marks (").
TSV Enclose non-numeric items that contain double quotation marks (") in double quotation marks (").

*This feature has already been changed in the Campaign Management Tool. See the following announcement for details.
Changes in download file specifications for performance reports

6. Smart targeting

We will support the smart targeting. This feature will be available on February 28, 2024. See the following announcement for details.
Smart targeting is now available

Services

AdGroupService

Changes

You can turn smart targeting on and off.

7. Maintenance

  • Removed the item "DEFAULT_LIST" from the audienceListTypes of AudienceListService and AdGroupTargetService.
  • We made the following changes due to the end of audience category targeting (already merged with audience list targeting).
    • Removed "AUDIENCE_CATEGORY_TARGET" from AdGroupTargetService.
    • Removed "getAudienceCategory" from DictionaryService.
    • We modified the CampaignService field names as follows:
      • Changed conversionOptimizer to optimizer.
      • Changed conversionOptimizerTrainingStatus to optimizerTrainingStatus.
  • We removed the following unused fields from the AdGroupTargetService age.
    • OLD_GT_RANGE13_14
    • OLD_GT_RANGE15_17
    • OLD_GT_RANGE18_19
    • OLD_GT_RANGE20_21
    • OLD_GT_RANGE22_29
    • OLD_GT_RANGE30_39
    • OLD_GT_RANGE40_49
    • OLD_GT_RANGE50_59
    • OLD_GT_RANGE60_69
    • OLD_GT_RANGE70_UL
    • OLD_GT_UNKNOWN
  • We closed FeedItemService/set.
  • We modified the field name of the selector in AudienceListService/getUploadUserListStatus as follows:
    • Changed jobStatues to jobStatuses.

API Webinar information

We will hold an online seminar to give an overview of v13 along with the release. See the following announcement for details.
Yahoo! JAPAN Ads API Webinar

End of Display Ads API v11

Yahoo! JAPAN Ads Display Ads API v11 will end with the following schedule:

Support end date: March 13, 2024
End of life date: June 12, 2024

Yahoo! JAPAN Ads Display Ads API v10 will end with the following schedule:

End of life date: March 13, 2024
*Support for this version has already ended.