> ## 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 Buzzvil data source to Adriel: request an API token, enter it in Adriel, and verify data.

Buzzvil is a Korean rewards-based mobile advertising platform, where end users earn points for engaging with ads delivered across partner apps. Connecting it brings Buzzvil campaign performance into Adriel dashboards alongside other mobile user-acquisition channels, with spend, impressions, clicks, and conversion events standardized for cross-platform comparison.

## Before you connect

The following are required:

* A Buzzvil ad account.
* An API token issued by the Buzzvil account team. Buzzvil provisions API access per advertiser, so request the token for the specific advertiser being connected.

## Connect Buzzvil

<Steps>
  <Step title="Request the Buzzvil API token">
    Contact the Buzzvil account team by email to request an API token. Buzzvil forwards the token in reply. This token authenticates the connection, so keep it available for the next step.
  </Step>

  <Step title="Open the Buzzvil data source">
    On the **Data Sources** page, search for **Buzzvil** and select it.
  </Step>

  <Step title="Enter the credentials">
    In the data source settings, paste the token into the **API Key** field, then enter an identifiable **Name** for the data source.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync runs in the background — data typically appears within one business day.
  </Step>
</Steps>

## What gets imported

The connector pulls Buzzvil campaign performance in the advertiser's reporting currency (typically KRW), across the full hierarchy of ad account, campaign, ad set, and ad. Metrics include spend, impressions, clicks, and any conversion events Buzzvil exposes through its reporting API. Costs are converted to the workspace currency when the ad account currency differs.

For the complete list of metrics, breakdowns, and limits, see the [Buzzvil data reference](/data-sources/a-f/buzzvil/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection fails after entering credentials">
    Buzzvil API access is provisioned per advertiser. Confirm with the Buzzvil account team that API access has been enabled and that the token matches the advertiser being connected.
  </Accordion>

  <Accordion title="Reported numbers differ from the Buzzvil dashboard">
    Buzzvil reporting can include rewards-based engagement events alongside standard impressions and clicks. Check the metric definitions in the Buzzvil data reference before comparing totals against the native Buzzvil dashboard.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Buzzvil data reference" href="/data-sources/a-f/buzzvil/data-reference">
    Metrics, breakdowns, and limits for Buzzvil.
  </Card>

  <Card title="Buzzvil FAQs" href="/data-sources/a-f/buzzvil/faqs">
    Common questions and expected behaviors for the Buzzvil data source.
  </Card>

  <Card title="How to connect Kakao Moment" href="/data-sources/g-n/kakao-moment/how-to-connect">
    Connect another Korean mobile ad platform.
  </Card>

  <Card title="How to connect Naver Search Ads" href="/data-sources/g-n/naver-search-ads/how-to-connect">
    Connect an additional Korean performance channel.
  </Card>
</CardGroup>