Yahoo! JAPAN Ads API | Developer Center

日本語

2024/06/26

Display Ads: Conversion API with additional link parameters and feature enhancements

Product

Yahoo! JAPAN Ads Display Ads

Date

June 25, 2024

Summary

We have added link parameters and enhanced the conversion API used for advanced matching. Details are as follows:

Only the conversion API is applied. If you use advanced matching in other ways, this does not apply and will not affect you.

Add link parameters

We have added parameters that can be linked to the conversion API.

[Added parameters]

Key Details
Ifa Ad identifiers (IDFA/AAID)
Ip IP address of users with conversion
user_agent The user agent of the converting user's browser
yjsu_yjad Value of cookie "_yjsu_yjad"
URL The URL of the page where the conversion was received
referrer The HTTP referrer of the page that received the conversion

Enhance features

Conversion tracking is available with ad identifiers (IDFA/AAID)

You can track conversions with an ad identifier (IDFA/AAID) by adding the conversion API link parameters. The required parameters of the conversion API request have changed as follows.

  • (Before) At least one of hashed_email, hashed_phone_number, yclid, and yjr_yjad is required.
  • (After) At least one of hashed_email, hashed_phone_number, yclid, yjr_yjad, and ifa is required.

*There are no changes to other items.

Add a format for receiving in event_time

We have added a receivable format for the link parameter "event_time."

  • Previously, only 10-digit UNIX time could be received, but this has been improved so that if 13-digit UNIX time is entered, the last 3 digits are removed before receiving the time.
  • If the input value was a time in the future than the current time on the conversion API server, it could not be received. After the release, we have made an improvement so that if the time is within 30 seconds of the current time, the time is rewritten to the current time on the conversion API server and received.

Comments

Developer Center

Related sites: