# Outbrain DSP integration

Source: https://skro.eu/docs/integrations/outbrain-dsp-and-skro

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

From August 6, 2024, Zemanta will officially rebrand as Outbrain DSP.

With the transition to Outbrain DSP, all Outbrain platforms are unified into one interface, simplifying the buying process and enhancing the overall user experience for advertisers. Don’t worry, Outbrain DSP offers the same functionality as Zemanta, now under a new name to align with the Outbrain family. As an Outbrain DSP user, you can continue to manage your campaigns and activity in exactly the same way that you already know and are familiar with, just under a fresh new brand.

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

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

In this guide, you will learn how to set up your campaigns in Outbrain DSP and Skro so Outbrain DSP 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 Outbrain DSP and Skro is required.

## Manage Outbrain DSP campaigns through the Skro UI [#manage-outbrain-dsp-campaigns-through-the-skro-ui]

![Manager Outbrain campaigns](/images/docs/outbrain-dsp/ob-dsp-6.png)

## Manage Outbrain DSP ad groups through the Skro UI [#manage-outbrain-dsp-ad-groups-through-the-skro-ui]

![Manager Outbrain ad groups](/images/docs/outbrain-dsp/ob-dsp-7.png)

## Manage Outbrain DSP content ads through the Skro UI [#manage-outbrain-dsp-content-ads-through-the-skro-ui]

![Manager Outbrain content ads](/images/docs/outbrain-dsp/ob-dsp-8.png)

## Manage Outbrain DSP publishers through the Skro UI [#manage-outbrain-dsp-publishers-through-the-skro-ui]

![Manager Outbrain publishers](/images/docs/outbrain-dsp/ob-dsp-9.png)

<Steps>

## Step 1. Get Outbrain DSP API Credentials [#step-1-get-outbrain-dsp-api-credentials]

Outbrain DSP **API keys**. You can get one by following the steps below:

1. Go to this link and generate your API key: **https://dsp.outbrain.com/o/applications/**

2. Click **New Application**.

![Get Outbrain API token step 1](/images/docs/outbrain-dsp/ob-dsp-10.png)

3. Enter your API key name where you going to use it.

![Get Outbrain API token step 2](/images/docs/outbrain-dsp/ob-dsp-11.png)

4. Copy your **Client ID** and **Client Secret** to your notes.

![Get Outbrain API token step 3](/images/docs/outbrain-dsp/ob-dsp-12.png)

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

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

- Log in to your **Skro** account.
- Navigate to **Settings → Integrations**.
- In the **Traffic Sources** section click **Add**.

![Outbrain DSP Integration step 1](/images/docs/outbrain-dsp/ob-dsp-1.png)

- Click **Outbrain DSP** logo and integration form will pop up.

![Outbrain Integration step 2](/images/docs/outbrain-dsp/ob-dsp-2.png)

- Enter your **Integration Name**.
- Enter your Outbrain DSP **Client ID** and **Client Secret**.
- Click **Next**.

![Outbrain DSP Integration step 3](/images/docs/outbrain-dsp/ob-dsp-3.png)

- Integrate your Outbrain DSP Ad Account.
- Click **Next**.

![Outbrain DSP Integration step 4](/images/docs/outbrain-dsp/ob-dsp-4.png)

- If you want to send conversions info back to Outbrain DSP, then you will need to enable **Conversion API.**
- **Conversion Event Name** - must be the same as you typed in Outbrain DSP. When creating Skro campaign you will need to specify which conversion goal to send to.
- **Include Conversion Payout** - If checked, we will send conversion revenue to Outbrain DSP.
- Click **Save & Close**.

![Outbrain DSP Integration step 5](/images/docs/outbrain-dsp/ob-dsp-5.png)

- Your Outbrain DSP account is successfully integrated.
- You can switch on/off cost sync with given switch.

![Outbrain 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 Outbrain traffic source Step 1](/images/docs/outbrain-dsp/ob-dsp-13.png)

2. Click **Outbrain DSP** logo.

![Setup Outbrain traffic source step 2](/images/docs/outbrain-dsp/ob-dsp-14.png)

3. Edit **Postback URL** and add your **Ad Account ID**.

4. Select your Outbrain DSP integration from the dropdown menu.

![Setup Outbrain traffic source step 3](/images/docs/outbrain-dsp/ob-dsp-15.png)

5. All parameters are already prefilled for you.

6. Click **Save & Close**.

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

## 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 Outbrain DSP.

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

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

12. Select your cost currency.

13. Click **Next**

![Setup Skro Campaign step 1](/images/docs/outbrain-dsp/ob-dsp-16.png)

14. Select workspace.

15. Add descriptive name to your campaign.

16. Click **Next**

![Setup Skro Campaign step 2](/images/docs/outbrain-dsp/ob-dsp-17.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/outbrain-dsp/ob-dsp-18.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/dcfe16a1-5b8e-4d30-9e4a-60ea2231437c?postbackid={postbackid}&contentadid={contentadid}&adgroupid={adgroupid}&campaignid={campaignid}&placement={placement}&publisher={publisher}&mediasource={mediasource}&title={title}
```

</Callout>

![Setup Skro Campaign step 4](/images/docs/outbrain-dsp/ob-dsp-19.png)

## Step 5. Create a Campaign in Outbrain DSP [#step-5-create-a-campaign-in-outbrain-dsp]

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 Outbrain DSP campaign setup. In order to do that, perform the following steps:

1. Sign in to your Outbrain DSP account.

2. Go to the **Dashboard** view.

3. Click the **+ Campaign** and setup your campaign.

![Setup Outbrain DSP Campaign step 1](/images/docs/outbrain-dsp/ob-dsp-20.png)

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

6. Go to **Inventory** tab and add your tracking parameters from your tracking link. These parameters will be automatically appended to all click-through URLs within this ad group.

<Callout type="success">

```text
postbackid={postbackid}&contentadid={contentadid}&adgroupid={adgroupid}&campaignid={campaignid}&placement={placement}&publisher={publisher}&mediasource={mediasource}&title={title}
```

</Callout>

![Setup Outbrain DSP Campaign step 2](/images/docs/outbrain-dsp/ob-dsp-21.png)

7. Finish your ad group setup.

8. Set up your content ad and put on **URL field** your tracking link:

<Callout type="success">

`https://skrotrack.com/campaign/dcfe16a1-5b8e-4d30-9e4a-60ea2231437c`

</Callout>

Congratulations, you have successfully set up tracking of Outbrain DSP 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>
