> ## 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 LY Ads Search Ads data source to Adriel: authorize through Yahoo Japan Biz-OAuth, select an ad account, and verify data.

<Note>
  Renamed from Yahoo! JAPAN Search Ads in September 2026, following LY Corporation's rebrand of Yahoo! JAPAN Ads to LY Ads. Only the display name and icon changed — existing connections, data sources, and widgets are unaffected.
</Note>

LY Ads Search Ads (formerly Yahoo! JAPAN Search Ads) is the keyword search advertising product of LY Ads, the advertising platform operated by LY Corporation. 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 the Japanese market 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 LY Ads.
* An LY Ads Search Ads account with API access enabled.
* Manager account access, where the ad account is mediated through an agency.

## Connect LY Ads Search Ads

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **LY Ads 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. LY Ads Search Ads and LY Ads 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 [LY Ads Search Ads data reference](/data-sources/g-n/ly-ads-search-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The initial sync takes several minutes">
    LY Ads reports are prepared on the LY Ads 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">
    LY Ads Search Ads and LY Ads Display Ads share a single Biz-OAuth application. Reconnecting one platform may trigger a combined consent prompt on the Biz-OAuth screen.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="LY Ads Search Ads data reference" href="/data-sources/g-n/ly-ads-search-ads/data-reference">
    Metrics, breakdowns, and limits for LY Ads Search Ads.
  </Card>

  <Card title="LY Ads Search Ads FAQs" href="/data-sources/g-n/ly-ads-search-ads/faqs">
    Common questions and expected behaviors for the LY Ads Search Ads data source.
  </Card>

  <Card title="How to connect LY Ads Display Ads" href="/data-sources/g-n/ly-ads-display-ads/how-to-connect">
    Connect display campaigns on the same Biz-OAuth application.
  </Card>
</CardGroup>