> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Yahoo! Japan Search Ads data source to Adriel: authorize through Yahoo Japan Biz-OAuth, select an ad account, and verify data.

Yahoo! Japan Search Ads is the keyword search advertising platform operated by LY Corporation, the company behind Yahoo Japan. Connecting it brings campaigns, ad groups, ads, and keywords into Adriel dashboards alongside daily performance and search-specific metrics such as impression share, search rank lost, and exact-match impression share. This data source covers Yahoo Japan only and is distinct from Yahoo Ads (US/global), which uses a different API and authorization model.

## Before you connect

The following are required:

* A Yahoo Japan Business account with access to Yahoo Japan Ads.
* A Yahoo Japan Search Ads account with API access enabled.
* Manager account access, where the ad account is mediated through an agency.

## Connect Yahoo! Japan Search Ads

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **Yahoo! Japan Search Ads** and select it.
  </Step>

  <Step title="Authorize through Yahoo Biz-OAuth">
    Click **Connect** to open Yahoo Japan's Biz-OAuth screen. Sign in with Yahoo Japan Business credentials and approve the requested **yahooads** permission. Yahoo Japan Search Ads and Yahoo Japan Display Ads share a single Biz-OAuth application, so the consent prompt may cover both.
  </Step>

  <Step title="Select the account">
    Step through the two-level hierarchy: choose the **manager account** where applicable, then the **ad account** to connect.
  </Step>

  <Step title="Save the connection">
    Click **Save** to complete the connection. The initial sync runs in the background and may take several minutes to appear.
  </Step>
</Steps>

## What gets imported

The connector imports the full campaign hierarchy (ad account, campaign, ad group, ad, keyword) and daily performance metrics in JPY. Search-specific metrics include impression share, search rank lost, exact-match impression share, search top impression share, and budget-lost impression share. Available breakdowns include campaign, ad group, ad, keyword, search term view, device, country, and location.

For the complete list of metrics, breakdowns, and limits, see the [Yahoo! Japan Search Ads data reference](/data-sources/o-z/yahoo-japan-search-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The initial sync takes several minutes">
    Yahoo Japan reports are prepared on Yahoo's side before the results are returned, so the first backfill takes noticeably longer than a synchronous source. This is most pronounced during the initial ingest. Later syncs are quicker.
  </Accordion>

  <Accordion title="The same metric appears under two names">
    Some metrics are listed under two names in the metric picker to preserve backwards compatibility. Both names reference the same underlying data, so either one can be selected.
  </Accordion>

  <Accordion title="The authorization prompt covers both Search and Display">
    Yahoo Japan Search Ads and Yahoo Japan Display Ads share a single Biz-OAuth application. Reconnecting one platform may trigger a combined consent prompt at Yahoo Japan.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Yahoo! Japan Search Ads data reference" href="/data-sources/o-z/yahoo-japan-search-ads/data-reference">
    Metrics, breakdowns, and limits for Yahoo! Japan Search Ads.
  </Card>

  <Card title="Yahoo! Japan Search Ads FAQs" href="/data-sources/o-z/yahoo-japan-search-ads/faqs">
    Common questions and expected behaviors for the Yahoo! Japan Search Ads data source.
  </Card>

  <Card title="How to connect Yahoo! Japan Display Ads" href="/data-sources/o-z/yahoo-japan-display-ads/how-to-connect">
    Connect display campaigns on the same Yahoo Japan OAuth app.
  </Card>

  <Card title="How to connect Yahoo Ads" href="/data-sources/o-z/yahoo-ads/how-to-connect">
    Connect Yahoo (US/global) advertising, a separate platform.
  </Card>
</CardGroup>