> ## 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 Kakao Shopping data source to Adriel: choose a channel, enter the app keys, and import orders and products.

Kakao Shopping is the e-commerce surface of Kakao Commerce, spanning two Korean retail channels: KakaoTalk Gift and Kakao Store. Connecting it brings orders and products into Adriel so e-commerce performance can be analyzed alongside Korean ad-platform spend and other marketplace sources.

## Before you connect

The following are required:

* A Kakao Commerce seller account with API access enabled.
* A Kakao Commerce admin app key and seller app key. Issue or copy both from the API management section of Kakao Commerce before starting.
* A decision on which channel the data source represents: **Gift** (KakaoTalk Gift) or **Store** (Kakao Store). A single data source covers exactly one channel, and the choice is locked once the data source exists. To cover both channels, create two separate data sources.

## Connect Kakao Shopping

<Steps>
  <Step title="Select Kakao Shopping">
    On the **Data Sources** page, search for **Kakao Shopping** and select it.
  </Step>

  <Step title="Choose the channel">
    Pick **Gift** for KakaoTalk Gift purchases or **Store** for Kakao Store purchases. This selection cannot be changed after setup.
  </Step>

  <Step title="Enter the app keys">
    Paste the admin app key and the seller app key into the corresponding fields.
  </Step>

  <Step title="Connect">
    Click **Connect** to validate the credentials and start the initial import. Orders and products for the selected channel sync in the background.
  </Step>
</Steps>

## What gets imported

Orders and products are imported for the selected channel. Order data includes revenue, order counts, status transitions, and product order lines; product data includes names, SKUs, and channel-specific catalog details. Revenue is reported in KRW, with no currency conversion applied.

For the complete list of metrics, breakdowns, and channel-specific fields, see the [Kakao Shopping data reference](/data-sources/g-n/kakao-shopping/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The channel cannot be changed after setup">
    The Gift or Store selection is locked at data source creation. To cover both channels, create a second data source for the other channel.
  </Accordion>

  <Accordion title="Order totals differ from the Kakao Commerce dashboard">
    Kakao Shopping does not expose a pre-aggregated sales analytics API, so order amounts, cancellation counts, and product-level metrics are reconstructed from raw orders. Small discrepancies versus Kakao's own merchant dashboards can occur during settlement and cancellation cycles. Re-fetched windows extend back two days to capture late status transitions.
  </Accordion>

  <Accordion title="The connection fails after re-issuing an app key">
    Re-issuing either app key in Kakao Commerce invalidates the existing connection. Re-enter both keys in the data source settings to restore the connection.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Kakao Shopping data reference" href="/data-sources/g-n/kakao-shopping/data-reference">
    Metrics, breakdowns, and channel-specific fields for Kakao Shopping.
  </Card>

  <Card title="Kakao Shopping FAQs" href="/data-sources/g-n/kakao-shopping/faqs">
    Common questions and expected behaviors for the Kakao Shopping data source.
  </Card>

  <Card title="How to connect Naver Smart Store" href="/data-sources/g-n/naver-smart-store/how-to-connect">
    Connect another Korean e-commerce marketplace.
  </Card>

  <Card title="How to connect Cafe24" href="/data-sources/a-f/cafe24/how-to-connect">
    Connect a Korean DTC commerce platform.
  </Card>
</CardGroup>