> ## 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 Naver Search Ads data source to Adriel: gather the Naver API credentials, enter them, and verify data.

Naver Search Ads is the paid search advertising platform for Naver, South Korea's leading search engine. Connecting it brings the full campaign hierarchy (ad account, campaign, ad set, ad, and keyword), daily performance metrics, keyword-level data, and conversion events into Adriel dashboards alongside other marketing sources, with cost standardized for cross-channel reporting.

## Before you connect

Unlike most ad platforms, Naver Search Ads uses HMAC-signed API requests rather than a browser authorization flow, so credentials are entered manually. Gather the following from the Naver Search Ads admin first — all three values are generated from the same screen, under **Tools** > **API Usage Management**:

* **Access License** — the API key issued by Naver Search Ads.
* **Private Key** — the secret paired with the Access License, shown only once at generation time.
* **Customer ID** — the numeric ad account identifier.

Admin or operator-level access on the Naver Search Ads account is required to issue these credentials.

All cost data is reported in **KRW (Korean Won)**. Workspaces that display a different currency receive auto-converted values based on the current day's exchange rate.

## Connect Naver Search Ads

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

  <Step title="Enter the credentials">
    Fill in the required fields using the values gathered from the Naver Search Ads admin:

    * **Access License**
    * **Private Key**
    * **Customer ID**
  </Step>

  <Step title="Name and submit">
    Enter an identifiable **Account name** for the data source, then click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

Performance data is imported at every level of the campaign hierarchy — ad account, campaign, ad set, ad, and keyword — along with seven per-ad-account segmentations covering age, gender, device target, hour of day, location, search term view, and shopping keyword. Conversion events configured on the Naver account, such as 구매 (Purchase), 가입 (Sign-up), 장바구니 넣기 (Add to cart), and 구매완료 (Purchase Complete), are auto-imported as individual metrics.

For the complete metric list, breakdowns, refresh cadence, and date-range limits, see the [Naver Search Ads data reference](/data-sources/g-n/naver-search-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="No data appears after connecting">
    Naver Search Ads is a cache-only connector, so the initial backfill can take up to one business day. If the connection remains empty after 24 hours, verify that the Customer ID matches the ad account the Access License was generated against — credentials issued under a different ad account are a common cause of empty data.
  </Accordion>

  <Accordion title="Connection fails after previously working">
    Naver Search Ads credentials do not auto-rotate, but they can be revoked manually under **Tools** > **API Usage Management** in the Naver admin. A connection that suddenly fails authentication usually indicates revoked or rotated keys. Reconnect with refreshed credentials.
  </Accordion>

  <Accordion title="구매완료 (Purchase Complete) totals differ from the Naver UI">
    Purchase Complete is retrieved through a separate API path from the rest of the report data and is merged into report rows on a different schedule. Small short-term mismatches with the Naver UI are expected; figures reconcile after the next full report refresh.
  </Accordion>

  <Accordion title="Currency looks converted">
    Naver Search Ads reports only in KRW. Workspaces that display a different currency receive auto-converted values at the current day's exchange rate.
  </Accordion>
</AccordionGroup>

## Related

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

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

  <Card title="How to connect Naver GFA" href="/data-sources/g-n/naver-gfa/how-to-connect">
    Connect Naver's display advertising network.
  </Card>

  <Card title="How to connect Naver Smart Store" href="/data-sources/g-n/naver-smart-store/how-to-connect">
    Connect Naver Smart Store to attribute revenue back to Naver.
  </Card>
</CardGroup>