# NewsBreak integration

Source: https://skro.eu/docs/integrations/newsbreak-and-skro

Set up NewsBreak tracking in Skro, configure traffic source parameters, and connect your advertising campaigns.

NewsBreak is a local news aggregation platform founded in 2015. It provides a mobile app and website to deliver geographically specific news to users across the United States.

NewsBreak integration gives you the ability to manage and optimize all your ad campaigns through the Skro interface.

- Sync cost on ad level every 30 min.
- Check delivery status of campaigns, ad sets and ads.
- Pause or resume campaigns, ad sets and ads.
- Change daily budget and CPA bid value for ad sets.
- Check the status of your campaigns, ad sets and ads.

In this guide, you will learn how to set up your campaigns in NewsBreak and Skro so NewsBreak can pass information to Skro and back with a selected tracking method. This guide does not cover all aspects and options available when creating a campaign on these two platforms. Basic knowledge regarding setting up campaigns in NewsBreak and Skro is required.

## Manage NewsBreak campaigns through the Skro UI [#manage-newsbreak-campaigns-through-the-skro-ui]

![Manager NewsBreak campaigns](/images/docs/newsbreak/nb-1.png)

## Manage NewsBreak ad sets through the Skro UI [#manage-newsbreak-ad-sets-through-the-skro-ui]

![Manager NewsBreak ad sets](/images/docs/newsbreak/nb-2.png)

## Manage NewsBreak ads through the Skro UI [#manage-newsbreak-ads-through-the-skro-ui]

![Manager NewsBreak ads](/images/docs/newsbreak/nb-3.png)

<Steps>

## Step 1. Get NewsBreak API Key [#step-1-get-newsbreak-api-key]

NewsBreak **API Key**. You can get one by following the steps below:

1. Go to **Tools** → **Resources** → **API Access tokens**

![Get NewsBreak API token step 1](/images/docs/newsbreak/nb-4.png)

3. Click **Generate token** and copy token.

![Get NewsBreak API token step 2](/images/docs/newsbreak/nb-5.png)

5. Once you have everything ready, read the further part of this guide.

## Step 2. Add integration [#step-2-add-integration]

1. Log in to your **Skro** account.

2. Navigate to **Settings → Integrations**.

3. In the **Traffic Sources** section click **Add**.

![NewsBreak Integration step 1](/images/docs/newsbreak/nb-6.png)

4. Click **NewsBreak** logo and integration form will pop up.

![NewsBreak Integration step 2](/images/docs/newsbreak/nb-7.png)

5. Enter your **Integration Name**.

6. Enter your NewsBreak **Access Token** and **Organization ID**.

7. Click **Next**.

![NewsBreak Integration step 3](/images/docs/newsbreak/nb-8.png)

8. Integrate your NewsBreak Ad Account.

9. Click **Next**.

![NewsBreak Integration step 4](/images/docs/newsbreak/nb-9.png)

10. If you want to send conversions info back to NewsBreak, then you will need to enable **Conversion API.**

11. **Conversion Event Name** - must be the same as you typed in NewsBreak. When creating Skro campaign you will need to specify which conversion goal to send to.

12. **Include Conversion Payout** - If checked, we will send conversion revenue to NewsBreak.

13. Click **Save & Close**.

![NewsBreak Integration step 5](/images/docs/newsbreak/nb-10.png)

14. Your NewsBreak account is successfully integrated.

15. You can switch on/off cost sync with given switch.

![NewsBreak Integration step 6](/images/docs/ob-integration-6.png)

## Step 3. Associate integration with traffic source [#step-3-associate-integration-with-traffic-source]

1. Go to **Traffic Sources** and click **Create**.

![Setup NewsBreak traffic source Step 1](/images/docs/newsbreak/nb-11.png)

2. Click **NewsBreak** logo.

![Setup NewsBreak traffic source step 2](/images/docs/newsbreak/nb-12.png)

3. **Postback URL** is already prefilled for you.

4. Select your NewsBReak integration from the dropdown menu.

![Setup NewsBreak traffic source step 3](/images/docs/newsbreak/nb-13.png)

5. All parameters are already prefilled for you. Event type has dynamic macro.

6. Click **Save & Close**.

7. The integration is ready. Continue by creating a campaign for NewsBreak.

## Step 4. Create a Campaign in Skro [#step-4-create-a-campaign-in-skro]

1. If your set up needs pre-lander then go to **Landings** view and click **Create** to add your landing page.

2. To add your offer link go to **Offers** view and click **Create** and add your offer.

4. Select workspace.

5. Add name.

6. Add your offer URL and add macros.

7. Click **Save & Close**.

![Setup Skro Offer](/images/docs/google-offer-1.png)

8. Navigate to the **Campaigns** view and click **Create**.

9. Select your integrated **Traffic Source** as NewsBreak.

10. Select your **Conversion Event Name**. That is needed to send conversion info back to NewsBreak.

11. Cost Model should be **Auto**.

12. Select your cost currency.

13. Click **Next**

![Setup Skro Campaign step 1](/images/docs/newsbreak/nb-14.png)

14. Select workspace.

15. Add descriptive name to your campaign.

16. Click **Next**

![Setup Skro Campaign step 2](/images/docs/newsbreak/nb-15.png)

17. Choose your **Destination Type**. In this example we use **flow**.

18. Choose your redirect mode. In this example we use **redirect 302**.

19. Select your landings. In this example we **use only offers**.

20. Select your offers.

21. Click **Save**.

![Setup Skro Campaign step 3](/images/docs/newsbreak/nb-16.png)

22. Choose **Redirect** tracking method.

23. Copy your **Campaign Tracking URL** to clipboard.

<Callout type="info">

In given example we have that kind of URL:

```text
https://skrotrack.com/campaign/09e0dae8-8d20-4e86-85d4-5dd983d96de4?external_id=__CALLBACK_PARAM__&ad_id=__CREATIVE_ID__&adset_id=__FLIGHT_ID__&campaign_id=__CAMPAIGN_ID__&ad_name=__CREATIVE_NAME__&adset_name=__FLIGHT_NAME__&campaign_name=__CAMPAIGN_NAME__
```

</Callout>

![Setup Skro Campaign step 4](/images/docs/newsbreak/nb-17.png)

## Step 5. Create a Campaign in NewsBreak [#step-5-create-a-campaign-in-newsbreak]

Now you have your Campaign Tracking URL with tracking parameters added. In the next step you will submit it as your item's URL in NewsBreak campaign setup. In order to do that, perform the following steps:

1. Sign in to your NewsBreak account.

2. Go to **Ad management**.

3. Click **+ Create Campaign** and set up your campaign.

4. Add your campaign name and click **Save and Next**.

![Setup Newsbreak Campaign step 1](/images/docs/newsbreak/nb-18.png)

5. Set up your **Ad Set**.

6. Set up your **Ad**.

7. Add Skro tracking link with params into **Landing page URL** field.

<Callout type="success">

```text
https://skrotrack.com/campaign/09e0dae8-8d20-4e86-85d4-5dd983d96de4?external_id=__CALLBACK_PARAM__&ad_id=__CREATIVE_ID__&adset_id=__FLIGHT_ID__&campaign_id=__CAMPAIGN_ID__&ad_name=__CREATIVE_NAME__&adset_name=__FLIGHT_NAME__&campaign_name=__CAMPAIGN_NAME__
```

</Callout>

![Setup Newsbreak Campaign step 2](/images/docs/newsbreak/nb-19.png)

8. Click **Submit** when ever you are ready.

Congratulations, you have successfully set up tracking of NewsBreak traffic with Skro. Each time a visitor clicks on your ad, will be directed to your offer page with Skro's tracking parameters being passed.

</Steps>

## Verify the setup [#verify-the-setup]

Open the generated campaign URL and check that the visit appears in Skro. Confirm that traffic source macros resolve to actual values. If you send conversions back to the source, verify a test conversion in both systems.

<Callout title="Troubleshooting">

If data is missing, check the selected workspace, integration, campaign, and reporting date range. Compare parameter names and macro values with the examples in this guide before repeating the test.

</Callout>

## Related guides [#related-guides]

<Cards>

<Card title="Postback URL parameters" href="/docs/postback/parameters-in-postback-urls" />

<Card title="Custom conversions" href="/docs/postback/custom-conversions" />

</Cards>
