> ## 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 SmartNews Ads data source to Adriel: enter SmartNews-issued API credentials, select an advertiser, and verify data.

SmartNews Ads is the native advertising platform inside SmartNews, a news aggregator app popular in Japan and the United States. Connecting it brings campaign, ad-group, and ad performance into Adriel dashboards at daily granularity, alongside spend, impressions, viewable impressions, clicks, conversions, installs, and in-app events.

## Before you connect

The following are required:

* An active SmartNews Ads advertiser account.
* API access provisioned for that advertiser by the SmartNews account team.
* The API credentials issued by SmartNews for the advertiser, gathered before starting the connection.

## Connect SmartNews Ads

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

  <Step title="Enter API credentials">
    Paste the SmartNews-issued API credentials into the connection form, then click **Connect** to verify access.
  </Step>

  <Step title="Select the advertiser">
    When more than one advertiser is available, choose the advertiser to ingest.
  </Step>

  <Step title="Choose metrics and breakdowns">
    Select the metrics and breakdowns to import, such as spend, impressions, viewable impressions, clicks, conversions, installs, and in-app events, broken down by campaign, ad group, ad, and creative format.
  </Step>

  <Step title="Save">
    Click **Save** to complete the connection. Backfill runs automatically in the background.
  </Step>
</Steps>

## What gets imported

The connector pulls campaign, ad-group, and ad performance from the SmartNews Insights API at daily granularity, in the advertiser's billing currency (typically JPY). Metrics include spend, impressions, viewable impressions, clicks, conversions, installs, and in-app events, alongside derived rates such as CTR, CPC, and CPM. Supported campaign objectives include TRAFFIC, SALES, AWARENESS, and APP\_PROMOTION, with creative formats spanning image, video, carousel, and catalog units.

For the complete list of metrics, breakdowns, and reporting limits, see the [SmartNews Ads data reference](/data-sources/o-z/smartnews-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection fails after entering credentials">
    Confirm with the SmartNews account team that API access has been provisioned for the advertiser, and that the credentials match the advertiser whose data is being requested.
  </Accordion>

  <Accordion title="CPC or CPM looks inconsistent across campaigns">
    SmartNews campaigns can bill on click or on viewable impression. Spend is reported consistently across both, but effective cost-per-action interpretation depends on each campaign's billing event. Split reports by billing event before comparing efficiency.
  </Accordion>

  <Accordion title="Older data is missing for a long date range">
    Look-back is capped by the reporting granularity: up to 93 days for daily, up to one year for weekly, and up to two years for monthly. Use a coarser granularity to reach further back.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="SmartNews Ads data reference" href="/data-sources/o-z/smartnews-ads/data-reference">
    Metrics, breakdowns, and reporting limits for SmartNews Ads.
  </Card>

  <Card title="SmartNews Ads FAQs" href="/data-sources/o-z/smartnews-ads/faqs">
    Common questions and expected behaviors for the SmartNews Ads data source.
  </Card>

  <Card title="How to connect LINE Ads" href="/data-sources/g-n/line-ads/how-to-connect">
    Connect another Japan-focused advertising channel.
  </Card>

  <Card title="How to connect Yahoo Japan Search Ads" href="/data-sources/o-z/yahoo-japan-search-ads/how-to-connect">
    Connect Yahoo Japan search performance data.
  </Card>
</CardGroup>