---
title: DirectPerks
slug: directperks
icon: 🎯
docTags: 
createdAt: 2024-05-29T20:28:13.347Z
---

:::hint{type="info"}
**Who is this for:** Partners who want to manually select and promote specific offers across their website, app, or email campaigns.

**Outcome:** Obtain tracking links, creatives, and copy for provisioned offers, then run them as direct offers or use the Offer Catalog API for programmatic access.
:::

# Overview

Direct Offers allow publishers to manually select specific offers for promotion across their website, app, or email campaigns. Any offer provisioned to your account can be used as a Direct Offer. When a user clicks a Direct Offer, they are redirected directly to the advertiser’s website.

:::hint{type="success"}
Some Direct Offers include LoyaltyBoost, which rewards users within your app or site upon successful offer completion.&#x20;

[Learn more about "LoyaltyBoost (Rewarded Offers)"](docId\:rgCpPtLuNzHyMKOWVcvxY)&#x20;

:::

## Obtaining Direct Offers

You can obtain Direct Offers in two ways:

1. **Dashboard:** Select offers manually via the UI.
2. **Offer Catalog API:&#x20;**&#x52;etrieve all active offers programmatically.

Continue reading to learn how to select Offers via our Dashboard or explore the [DirectPerks API](docId\:X-Trc9-DEbSkVhrlRTGOR)


# Running Direct Offers

To run a Direct Offer, you typically need:

- **Copy:** Content for your Offers.
- **Creatives:&#x20;**&#x20;Visual assets to complement your Offers.
- **Tracking Link:&#x20;**&#x4C;ink to track user interactions with the Offer.

To obtain these details, log into the Publisher Dashboard and navigate to Offers from the side menu. Locate the Offer you would like to run as a Direct Offer.

:::Iframe{iframeHeight="0" code="<div style=&#x22;position: relative; padding-bottom: calc(51.763888888888886% + 42px); height: 0;&#x22;><iframe src=&#x22;https://play.momentscience.com/embed/clywmx3221etlz9kdanrl48hh&#x22; loading=&#x22;lazy&#x22; title=&#x22;Momentscience: Running Direct Offers&#x22; allow=&#x22;clipboard-write&#x22; frameborder=&#x22;0&#x22; webkitallowfullscreen=&#x22;true&#x22; mozallowfullscreen=&#x22;true&#x22; allowfullscreen style=&#x22;position: absolute; top: 0; left: 0; width: 100%; height: 100%;&#x22;></iframe></div>"}

:::

### Copy

1. Select the three-dot menu for the desired Offer.
2. Choose "Details" to navigate to the Offer Details screen.
3. Collect the copy to run in your Offers.

### Creatives



1. From the same three-dot menu, choose Creatives.
2. Download or copy the creatives needed for your integration.

### &#xD;Tracking Link

- Select Copy Tracking Link from the menu.
- Use the appropriate link type depending on your use case:
  - **Offer Tracking Link:&#x20;**&#x41; general-purpose link that takes the user directly to the advertiser’s landing page.
  - **Email Tracking Link:** A version of the link optimized for email delivery and compliance with ESPs.
  - **Perkswall Tracking Link:** Redirects the user to the specific offer inside your Perkswall interface, if integrated.

:::CodeblockTabs
Offer Tracking Link Example&#x20;

```javascript
https://trk.pubtailer.com/sdk/offer-click?o_id=48887&c_id=21882&p_id=23860
```

Email Tracking Link Example

```javascript
https://trk.pubtailer.com/sdk/em/click?o_id=48887&c_id=21882&p_id=23860
```

Perkswall Tracking Link Example

```javascript
https://naojs.pubtailer.com/?accountId=fbe15c8766f803uf4&c_id=2182
```
:::



You can pass any extra payload information into a Direct Offer tracking link.&#x20;

Learn more about how to [Passing Payload Values](docId\:yZ38zu4_miummWTnnsG98) . This information is passed back to a Postback URL if configured. Learn more about [Handling Postback Events](docId\:U6s7GlbRWPW4hb3zP9xJm) .





## Running Direct Offers (LoyaltyBoost)

LoyaltyBoost Offers rewards to users for engaging with them. They operate similarly to Direct Offers, as described above, with one crucial difference: you must pass a user-identifying attribute in the payload. This ensures that when you receive a postback, the payload object includes this attribute (and any others) you supplied when trafficking the Offer.

In the following example, the `user_id`parameter appended to the standard link contains a value identifying the user who will receive the reward.


:::CodeblockTabs
Example of a direct Offer link with a user\_id attribute and corresponding value

```javascript
https://trk.pubtailer.com/sdk/offer-click?o_id=XXXX&c_id=XXX&p_id=XX&user_id=3a99022vv
```
:::


Upon conversion, the postback URL will receive the `user_id `in the form of a GET "macro" as `{user_id}` and also exist in the POST data.&#x20;

More information about LoyaltyBoost Offers and postbacks can be [Handling Postback Events](docId\:U6s7GlbRWPW4hb3zP9xJm)

***

# Downloading Offer Data

We offer you the option to download your Offer data directly to your device. The downloaded data includes:


| **Key**                 | **Description**                                                                                                |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| Advertiser Name         | The name of the company or individual behind the Offer.                                                        |
| Offer Name              | The name of the Offer used for identification.                                                                 |
| Offer ID                | A unique identifier for the Offer.                                                                             |
| Click URL               | The link users are directed to when interacting with the Offer.                                                |
| CTA Yes                 | Text displayed on the positive call-to-action button.                                                          |
| CTA No                  | Text displayed on the negative call-to-action button.                                                          |
| Description             | Detailed explanation of the Offer.                                                                             |
| Short Description       | A concise overview of the Offer.                                                                               |
| Headline                | The main headline of the Offer.&#xD;<br />&#xD;                                                                |
| Short Headline          | A shorter version of the headline for use in smaller formats.                                                  |
| Images & Creatives URLs | URLs pointing to images or creatives associated with the Offer.                                                |
| Targeting               | Parameters specifying the target audience for the Offer, including platforms, operating systems, and browsers. |

## All Active/Running Offers Data

From the dashboard, You can easily download all your active/running Offers data with just one click. Simply follow these steps in the following demo:

:::Iframe{iframeHeight="0" code="<div style=&#x22;position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 2.2094361334867663; padding: 40px 0 40px 0;&#x22;><iframe src=&#x22;https://play.momentscience.com/embed/clzack7gx4va9z9kd070ua2l5?embed_v=2&#x22; loading=&#x22;lazy&#x22; title=&#x22;MomentScience: Downloading All Offers Data&#x22; allow=&#x22;clipboard-write&#x22; frameborder=&#x22;0&#x22; webkitallowfullscreen=&#x22;true&#x22; mozallowfullscreen=&#x22;true&#x22; allowfullscreen style=&#x22;position: absolute; top: 0; left: 0; width: 100%; height: 100%;&#x22;></iframe></div>"}

:::

## Single Offer Data

From the dashboard, you can download data for a particular Offer to your device in either JSON or CSV format. Simply follow these steps in the following demo:

:::Iframe{iframeHeight="0" code="<div style=&#x22;position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 2.2094361334867663; padding: 40px 0 40px 0;&#x22;><iframe src=&#x22;https://play.momentscience.com/embed/clzad3bko4vhoz9kdrjjk8krs?embed_v=2&#x22; loading=&#x22;lazy&#x22; title=&#x22;MomentScience: Downloading Single Offer Data &#x22; allow=&#x22;clipboard-write&#x22; frameborder=&#x22;0&#x22; webkitallowfullscreen=&#x22;true&#x22; mozallowfullscreen=&#x22;true&#x22; allowfullscreen style=&#x22;position: absolute; top: 0; left: 0; width: 100%; height: 100%;&#x22;></iframe></div>"}

:::

***

📢 If you're running into any issues while going through the integration process, feel free to contact us at [help@momentscience.com](#)&#x20;
