Yahoo! JAPAN Ads

Yahoo! JAPAN Ads Help

Tracking URL and parameters

Tracking is the tracking of click information at the time of ad delivery using an ad effectiveness measurement tool on the advertiser side. Set the URL and parameters to track your ad and measure your ad effectiveness. Refer to the following link for details on the URL and available parameters for tracking.

Tracking URL
Tracking parameter
Custom parameter

Tracking URL

"Tracking URL" is the URL used when measuring ad effectiveness when tracking. The tracking URL can be set for an account, campaign, ad group, and ad. The upper-level settings apply to the lower levels. If you specify multiple tracking URLs at different levels, the lower settings will apply. When you don't need tracking, you don't need to set this information.

Note
  • No matter what level you set the tracking URL, the post-screening will be done.
  • If the tracking URL for the upper layer is incorrect, all the ads under it may be rejected on the review.
  • Depending on the timing of the review, the tracking URL set in the upper layer and the review result of the submitted material under it may differ.
  • Even if the tracking URL of the upper layer is approved by the examination, if the ad under it violates our guidelines, it will be denied by the review.
  • If you can't correctly transition from the tracking URL to the link destination at the time of review, the ad may be disapproved.
  • When parameters are appended to the tracking URL, as long as the content of the destination page matches the content of the page in the final URL, you can add that tracking URL.

Tracking parameter

You can track the ad performance in various metrics by adding tracking parameters to your landing page URL or tracking URL.
The following tracking parameters are available for Display Ads.

Tips
Tracking parameters can be used only for the primary use of the data acquired by this feature for the company's own advertising effectiveness measurement.
Secondary use (such as providing, transferring, or reselling the acquired data directly to customers) is not allowed.
ParameterOverviewURL format
{creative}Ad IDhttp://www.example.com/?creative={creative}
{media}Media IDhttp://www.example.com/?media={media}
{campaignid}Campaign IDhttp://www.example.com/?campaignid={campaignid}
{adgroupid}Ad Group IDhttp://www.example.com/?adgroupid={adgroupid}
{account}Account IDhttp://www.example.com/?account={account}
{device}Device type
Returns the following contents.
・DESKTOP
・SMARTPHONE
・TABLET
*Returns NONE when devices can’t be identified.
http://www.example.com/?device={device}
{os}OS type
Returns the following contents.
・IOS
・ANDROI投資収益(Return On Investment)の略語。投資したコストに対して、どの程度利益が生まれているかという指標です。「利益÷コスト×100」で算出できます。この数字が大きければ大きいほど、利益率がよいと判断できます。D
*Returns NONE when OS can’t be identified.
http://www.example.com/?os={os}
{isApp}Displays ad delivery for iOS app and Android app
・iOS app and Android app: true
・Other apps: false
http://www.example.com/?isApp={isApp}
{ifa}Identifier for Advertisers (IFA).。
・iOS: IDFA
・Android OS: AdvertisingID

*Available only when using the tracking tool linked to Display Ads(*1)
http://www.example.com/?ifa={ifa}
{ifaSha1}Hash values (sha1) for Identifier for Advertisers (IFA)
・iOS: IDFA
・Android OS: AdvertisingID

*Available only when using the tracking tool linked to Display Ads(*1)
http://www.example.com/?ifaSha1={ifaSha1}
{ifaMd5}Hash values (md5) for Identifier for Advertisers (IFA)
・iOS: IDFA
・Android OS: AdvertisingID

*Available only when using the tracking tool linked to Display Ads(*1)
http://www.example.com/?ifaMd5={ifaMd5}

{ci}

Conversion information *Available for the campaign type: "App promotion" on Display Ads (Auction).

*Available only when using the tracking tool linked to Display Ads(*1)

http://www.example.com/?ci={ci}

{installCallback}

Conversion request URL

*Available for the campaign type: "App promotion" on Display Ads (Auction).

*Available only when using the tracking tool linked to Display Ads(*1)

http://www.example.com/?install_callback={installCallback}

ifmobile:[xxxxx]

For access from smartphones, a unique value (xxxxx) will be added.

This option allows you to convert the URL to the one for smartphones and also you can add a parameter. (*2)

Tips
After October 20, 2021, domains will no longer be available for use as feed items in Dynamic Ads for Display.
_
ifnotmobile:[xxxxx]

For access from a PC or tablet, a unique value (xxxxx) will be added.

This option allows you to convert the URL to the one for PC/tablet and also you can add a parameter. (*2)

Tips
After October 20, 2021, domains will no longer be available for use as feed items in Dynamic Ads for Display.
_
{deviceAppType}You can identify the ad placement "App" or "Web."

*Available for the campaign type: "App promotion" on Display Ads (Auction).

*Available only when using the tracking tool linked to Display Ads(*1)

_

{lpurl}

It will be replaced with the final URL or the smartphone final URL. It will be encoded unless it is at the beginning of the tracking URL.

_

{lpurl+2}

It will be replaced with the final URL or smartphone final URL encoded twice. This is useful when redirecting multiple times.
*If you write it at the beginning of the URL, an error will occur and you will not be able to add this parameter.

_

{lpurl+3}

It will be replaced with the final URL or smartphone final URL encoded 3 times. This is useful when redirecting multiple times.
*If you write it at the beginning of the URL, an error will occur and you will not be able to add this parameter.

_

{unescapedlpurl}

It will be replaced with the un-encoded final URL or the smartphone final URL.

_

{escapedlpurl}

It will be replaced with the encoded final URL or the smartphone final URL.
*If you write it at the beginning of the URL, an error will occur and you will not be able to add this parameter.

_

*1) Tracking tool linked to Display Ads

Refer to the following help pages for setting conversion tracking of app install.

First Setting for Tracking App Install (Conversion) [Display Ads (Auction)]

*2) Difference between {ifmobile:} and {ifnotmobile:}

Example 1) Using {ifmobile:}

Example 2) Combination of parameters

Available URL formats when creating ads

Check the followings for each setting pattern

URL sampleAvailable?Descriptions
https://{ifmobile:m.}xxxxx.co.jpYes_
https://{ifmobile:m}.xxxxx.co.jpNoDoesn't drive correctly for PC/Tablet pages because the "." (dot) isn't included in the parameter
https://{ifnotmobile:www.}{ifmobile:m.}xxxxx.co.jpNo_
https://{ifmobile:m.xxxxx.co.jp}NoNot allowed when there is only "ifmobile" or "ifnotmobile" after http://

https://{ifmobile:m.xxxxx.co.jp}{ifnotmobile:yyyyy.co.jp}

https://www.{ifmobile:xxxxx}{ifnotmobile:yyyyy}.co.jp

NoNot allowed when the domains of URL don't match.
{ifnotmobile:https://www.xxxxx.co.jp}NoNot allowed when only consists with the parameter

https://xxxxx.co.jp/{ifmobile:aaaaa}{ifnotmobile:bbbbb}/ccccc

https://xxxxx.co.jp/?o={ifmobile:00000}

Yes

Adding parameter at the end of URL for tracking is available

https://www.{ifmobile:{os}}{ifnotmobile:{device}}.co.jp

https://www.{ifmobile:{ifmobile:AAAA}}{ifnotmobile:{ifnotmobile:BBBB}}.co.jp

NoNested tracking parameters is unavailable within "if mobile" or "if not mobile"
https://{ifnotmobile:www.}{ifmobile:m.}xxxxx.co.jp/?o={ifmobile:00000}NoMultiple insertions of "ifmobile" "ifnotmobile" is not available

Custom parameter

It is an item to set a character string such as identification information for tracking in the final URL and tracking URL. When you don't need tracking, you don't need to set this parameter.
The custom parameter can be set for the campaign, ad group, and ad.
The settings in the upper layer are applied to the lower, and if the settings are made individually in the lower layer, the settings will take precedence.

Entry formats for setting are as follows.
Format: {_key}=value
・key: parameter name
・value: parameter value

Tips
For the campaign goal "Item list promotion", the custom parameter is valid for the following URLs.
  • Final URL (logo)
  • Smartphone final URL (logo)
  • Tracking URL

View this page in Japanese