Yahoo Japan Search Ads campaign configuration

For:
Marketers
Last update:

At a glance: Yahoo Japan Search Ads, a self-reporting network (SRN) partner that combines advertising and analytics.

  • On December 15, 2021, the legacy integration with Yahoo Japan Search Ads, yahoojapansearch_int, was replaced with a new integration, yjsearch_int. Learn how to start working with the new API.

Yahoo Japan Search Ads integration principles

AppsFlyer integration with Yahoo Japan Search Ads is relevant only to Android apps. 

The integration leverages a link ID for conversion measurement and is based on pre-defined conversion events on Yahoo Japan Search Ads. You can map in-app events like subscriptions and purchases to these events. This enables conversion measurement and reporting between AppsFlyer and Yahoo Japan Search Ads.

Comparing the legacy and new integration

Yahoo Japan Search Ads API feature support:

Feature Legacy (yahoojapansearch_int) 

New

(yjsearch_int)
Install conversion (click-through only) Yes Yes
In-app conversion No Yes

Integrating with the new API

To enable the integration with the new API:

  1. In Yahoo Japan Search Ads Ads dashboard, generate a link ID. You must select AppsFlyer as your MMP.
  2. In AppsFlyer, configure the integration with Yahoo Japan Search Ads.
  3. Map the in-app events you want to measure, and create new conversion analytics on the Campaign Management Tool in Yahoo Japan Search Ads.   

Data sharing between AppsFlyer and Yahoo Japan Search Ads

Send postbacks to Yahoo Japan Search Ads relating to conversions and in-app events. In-app events are mapped to pre-defined conversion events used by Yahoo Japan Search Ads to optimize and update performance reports. You perform the mapping as part of the integration settings.

Consider the following mapping table in the context of AppsFlyer in-app events (your app) and Yahoo Japan Search Ads pre-defined event mapping. 

AppsFlyer in-app event Yahoo Japan Search Ads app event type 
af_purchase in_app_purchase
af_app_opened session_start
af_search view_search_results
af_content_view view_item
af_list_view view_item_list
af_add_to_cart add_to_cart
af_travel_booking ecommerce_purchase
Any in-app event 

If you have additional events, map them to the event custom.

Data provided to AppsFlyer by Yahoo Japan Search Ads

When Yahoo Japan Search Ads claims a conversion, they provide us with the media source parameters listed in the table. These parameters populate analytics and raw data reports. The table that follows contains the mapping between Yahoo Japan Search Ads and AppsFlyer parameters.

Yahoo Japan Search Ads-AppsFlyer media source mapping

Yahoo Japan Search Ads AppsFlyer
timestamp attributed_touch_time
campaign_tracking_id campaign_id
ad_group_tracking_id adset_id
ad_tracking_id ad_id
keyword keywords
match_type keyword_match_type
account_id network_account_id

Integration procedures

You can integrate with Yahoo Japan Search Ads using a single entity - directly as an advertiser or via an agency.
Complete the sections as follows:

Yahoo Japan Search Ads—integration tab sections

Step Section Description

1

Activate partner

Prerequisites:

Get the Yahoo Japan Search Ads link ID.

To activate the Yahoo Japan Search Ads App Attribution integration: 

  1. In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
  2. Search for Yahoo! Search Ads (Yahoo! JAPAN Sponsored Search) - New API, and select it.
  3. Verify that yjsearch_int displays in the URL. If this is not the case, you have selected the wrong integrated partner. 
  4. In the Integration tab, turn on Activate partner.
    Note: The toggle must be on (activated) for as long as you work with the partner.
  5. In the Link ID field, paste the link ID mentioned in the prerequisites.
  6. [Optional] Changes to default settings for install click-through lookback window. Yahoo Japan Search Ads default is 7 days. To minimize discrepancies [best practice], align with the Yahoo Japan Search Ads default.
  7. Click Save integration.
  8. In Yahoo Japan Search Ads, set the new conversion settings as "app_first_open". Learn more about the configuration in Yahoo Japan Search Ads.

2

Map AppsFlyer in-app events to Yahoo Japan Search Ads events

To map the Yahoo Japan Search Ads pre-defined events to AppsFlyer in-app events:

  1. In AppsFlyer, from the side menu, select Collaborate > Active integrations.
  2. Select Yahoo! Search Ads (Yahoo! JAPAN Sponsored Search) - New API.
  3. Turn on In-app events postback.
  4. Click Add event to add an app event to the list.
  5. Complete the parameters required. 
  6. Click Save integration.
  7. In Yahoo Japan Search Ads, set the new conversion settings to match the configured in-app events. Learn more about the configuration in Yahoo Japan Search Ads.
Parameter name Description
SDK event name

The name of the event, as received by AppsFlyer from either the SDK integrated in your app, or from server-to-server events.
Partner event identifier

The Yahoo Japan Search Ads pre-defined events. Suggested default mapping configurations are listed in the table in the previous section.
Sending option

Select the sending option for the event:

  • This partner only: for events coming only from users attributed to Yahoo Japan Search Ads. 
  • All media sources, including organic: Have your entire user base available to be reported to Yahoo Japan Search Ads.
Send revenue
  • No values & no revenue: Sends only the event itself without the event value.
  • Values & no revenue: Sends all the parameters excluding the revenue value.
  • Values & revenue: Sends all the event parameters, including the revenue value (if exists in the event).

Remarks: 

  • Event names are case-sensitive. To avoid discrepancies, make sure you use the correct event name for all media sources and app versions.

Agency integration

Agencies are able to run campaigns with Yahoo Japan Search Ads on your behalf.

Agency setup

Procedure performed by  Procedure
Advertiser
  1. Verify that you have completed advertiser Yahoo Japan Search Ads integration.
  2. In AppsFlyer, from the side menu, select Collaborate > Active integrations.
  3. Select an agency.
  4. Go to the Permissions tab, and turn on Agency permissions. 
Agency
  1. In AppsFlyer, go to Configuration > Active Integrations.
  2. Select Yahoo! Search Ads (Yahoo! JAPAN Sponsored Search) - New API.
  3. Go to the Integration tab.
  4. Verify that Activate Partner is On. If this is not the case, the advertiser must complete Advertiser Yahoo Japan Search Ads integration. 
  5. Verify that the remaining settings, like lookback windows and in-app event mapping, are correct. If necessary, ask the advertiser to make changes. 
  6. Enter your Yahoo Japan Search Ads customer ID. The ID is available in the Campaign Management tool. Note that only one customer ID can be connected. 
  7. Click Save.

Subsidiary procedures

Get the app link ID

To get the Campaign Manager link ID, see Yahoo Japan Search Ads documentation.

Create a new Yahoo Japan Search Ads pre-defined event

To create a new pre-defined event, refer to Yahoo Japan Search Ads instructions.

Yahoo Japan Search Ads discrepancies

See the following table to learn about discrepancies and how to minimize them.

Differences in attribution models

Cause Description AppsFlyer tip
Incorrect in-app event mapping

Mapping between AppsFlyer and Yahoo Japan Search Ads isn't correct.
  • Verify the link ID, 
  • Verify AppsFlyer in-app events are correctly mapped to Yahoo Japan Search Ads events.