# Outbrain integration

Source: https://skro.eu/docs/integrations/outbrain-integration

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

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

- Sync cost for campaigns, publishers and sections every 30 min.
- Check the status of your campaigns, ads, publishers and sections.
- Pause or resume campaigns, ads, publishers and sections.
- Change bidding for campaigns and sections.

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

**Manage Outbrain campaigns through the Skro UI**

![Manager Outbrain campaigns](/images/docs/ob-reporting-1.png)

**Manage Outbrain ads through the Skro UI**

![Manager Outbrain campaigns](/images/docs/ob-reporting-2.png)

**Manage Outbrain publishers and sections through the Skro UI**

![Manager Outbrain campaigns](/images/docs/ob-reporting-3.png)

<Steps>

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

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

- In Outbrain, click email on the top right corner and navigate to the **Amplify API Token**.
- Enter your password and generate API token.

![Get Outbrain API token](/images/docs/ob-cred-1.png)

- Enter your password and generate API token.
- Copy the **API Token** to any text editing tool.

![Get Outbrain API token](/images/docs/ob-cred-2.png)

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

## Step 2. Setup integration [#step-2-setup-integration]

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

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

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

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

- Enter your **Integration Name**.
- Enter your Outbrain **API Token**.
- Click **Next**.

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

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

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

- If you want to send conversions info back to Outbrain, then you will need to enable **Conversion API.**
- **Conversion Event Name** - must be the same as you typed in Outbrain. 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 and currency to Outbrain.
- Click **Save & Close**.

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

- Your Outbrain 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 the integration with your traffic source [#step-3-associate-the-integration-with-your-traffic-source]

- Navigate to the **Traffic Sources** and click **Create**.

![Setup Outbrain traffic source Step 1](/images/docs/ob-integration-7.png)

- Click **Outbrain** logo.

![Setup Outbrain traffic source step 2](/images/docs/ob-integration-8.png)

- Postback URL is already set with correct macros.
- Select your Outbrain integration from the dropdown menu.

![Setup Outbrain traffic source step 3](/images/docs/ob-integration-9.png)

- All parameters are already prefilled for you.
- Click **Save & Close**.

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

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

First you will need to add your pre-lander.

- Navigate to the **Landings** view and click **Create**.
- Select workspace.
- Add name.
- Add your landing URL and add macros if needed.
- Click **Save & Close**.

![Setup Skro Landing](/images/docs/ob-skro-campaign-0.png)

The second thing you need to do is to create an offer.

- Navigate to the **Offers** view and click **Create**.
- Select workspace.
- Add name.
- Add your offer URL and add macros if needed.
- Click **Save & Close**.

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

- Navigate to the **Campaigns** view and click **Create**.
- Select your integrated **Traffic Source** as Outbrain.
- Select your **Conversion Event Name**. That is needed to send conversion info back to Outbrain.
- Cost Model should be **Auto**.
- Select your cost currency.
- Click **Next**

![Setup Skro Campaign](/images/docs/ob-skro-campaign-1.png)

- Select workspace.
- Add descriptive name to your campaign.
- Click **Next**

![Setup Skro Campaign](/images/docs/ob-skro-campaign-2.png)

- Choose your **Destination Type**. In this example we use **flow**
- Choose your redirect mode. In this example we use **redirect 302**
- Choose your landing page

<Callout type="warn">

In given example we use 1 landing and 1 offer. Outbrain scans links that you submit, you cannot use a redirect method of tracking, as that redirect URL would not be correctly scanned. With the direct method of tracking, which is turned on by default for Outbrain, you will submit a direct tracking URL to Outbrain. This will allow Outbrain to scan this link without a problem.

</Callout>

- Click **Save**

![Setup Skro Campaign](/images/docs/ob-skro-campaign-3.png)

- Choose the **Direct** method.
- Install **Tracking Pixel** to your landing page.
- Install **CPA** with correct **Click To Offer Link**. In given example the link is **https://skrotrack.com/click**
- Select your landing page and copy the Landing URL with correct params and macros.

<Callout type="info">

In given example we have that kind of URL:

```text
https://prelander1.com/?trck=eyJjcGlkIjoiZmMxZmE5NGItMmRiOS00YzcyLWJhZGYtZmIxODI1MDJjODAxIiwiciI6MCwicCI6MCwibCI6MH0=&cpc={{cpc}}&ob_click_id={{ob_click_id}}&ad_title={{ad_title}}&ad_id={{ad_id}}&campaign_id={{campaign_id}}&publisher_id={{publisher_id}}&publisher_name={{publisher_name}}&section_id={{section_id}}&section_name={{section_name}}&promoted_link_id={{promoted_link_id}}
```

</Callout>

![Setup Skro Campaign](/images/docs/ob-skro-campaign-4.png)

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

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

- Sign in to your Outbrain account.
- Go to the **Campaigns** view.
- Click the **Create Campaign** and setup your campaign.

![Setup Outbrain Campaign](/images/docs/ob-campaign-1.png)

- Add your landing page without parameters. In given example we used landing **https://prelander1.com**
- Select your conversion event name same as you added into Skro.
- Click **Next**.

![Setup Outbrain Campaign](/images/docs/ob-campaign-2.png)

- Set up your creatives.
- Click **Next**.

![Setup Outbrain Campaign](/images/docs/ob-campaign-3.png)

- Set up tracking suffix field and budget.

<Callout type="info">

In given example we have that kind of tracking parameters:

```text
trck=eyJjcGlkIjoiZmMxZmE5NGItMmRiOS00YzcyLWJhZGYtZmIxODI1MDJjODAxIiwiciI6MCwicCI6MCwibCI6MH0=&cpc={{cpc}}&ob_click_id={{ob_click_id}}&ad_title={{ad_title}}&ad_id={{ad_id}}&campaign_id={{campaign_id}}&publisher_id={{publisher_id}}&publisher_name={{publisher_name}}&section_id={{section_id}}&section_name={{section_name}}&promoted_link_id={{promoted_link_id}}
```

</Callout>

![Setup Outbrain Campaign](/images/docs/ob-campaign-4.png)

- Paste the copied campaign tracking URL from Skro into the **URL** field.
- Once your set up is done, click the **Launch Campaign**.

![Setup Outbrain Campaign](/images/docs/ob-campaign-5.png)

Congratulations, you have successfully set up tracking of Outbrain traffic with Skro. Each time a visitor clicks on your ad, will be directed to your landing 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>
