> For the complete documentation index, see [llms.txt](https://help.branch.io/llms.txt).

# Enable Wider Planet (New)

> Connect Wider Planet to Branch to attribute clicks and installs on audience targeting and retargeting campaigns.

## Overview

[Wider Planet](https://www.widerplanet.com/) is a South Korean demand-side platform (DSP) and data management platform (DMP) that offers big-data audience targeting and retargeting. Connect Wider Planet to Branch to attribute clicks and installs and configure Postbacks.

For more information about integrating ad partners in general, visit our [Ad Partner Integration Guide](https://help.branch.io/marketer-hub/ad-partner-integration-guide-new.md).

> **Note: this guide is for new Branch**
>
> Please note that this guide is about integrating Wider Planet in the [new Branch experience](https://help.branch.io/marketer-hub/new-branch-overview.md). For information on Wider Planet in legacy Branch, visit our [legacy guide](https://help.branch.io/marketer-hub/wider-planet.md).

### Partner capabilities

| Capability | Details |
| --- | --- |
| Company type | DSP |
| Deep linking | Supported |
| Attribution | Click-through attribution |
| Ad campaign types | Retargeting campaigns |
| Ad formats | Banner, Interstitial |
| Click types | Client-side click |
| Supported platforms | iOS, Android |
| Link wrapping | Supported |
| Cost ingestion support | Supported (via click/impression tracking link) |
| Pricing models | CPI, CPC, CPM, CPA, CPV |

## Before you begin

To set up the Wider Planet integration, you need:

- Ad partner integrations enabled for your Branch account. Availability varies by Branch plan. See [Branch pricing](https://www.branch.io/pricing/) or contact your Branch representative.
- A Branch account with access to **Configuration > Ad Partners** and admin permissions to enable and configure integrations.
- A Wider Planet account with admin access. You'll need the following credential, available from your Wider Planet account manager: Wider Planet Client ID.
- [PAM](https://help.branch.io/marketer-hub/predictive-aggregate-measurement.md) enabled (recommended).

> **Note: PAM uses two separate toggles**
>
> The **PAM for Publishers** toggle for this partner, found under **Partner settings** > **Manage account**, is separate from the account-level **PAM switch**. **PAM for Publishers** must be enabled to reconcile conversion events with your partner. To attribute events with PAM, you also need PAM enabled on the [Attribution page](https://help.branch.io/account-hub/attribution-page-new.md) under **Configuration** > **Attribution**. Learn more in our [PAM Overview](https://help.branch.io/marketer-hub/predictive-aggregate-measurement.md#pam-for-publishers).

## Enable Wider Planet

To begin, navigate to **Configuration > Ad Partners > Wider Planet**.

Enter your **Wider Planet Client ID**, then select **Enable Wider Planet** on the Wider Planet page. Contact your Wider Planet account manager if you need this value.

## Configure attribution

To configure attribution windows, select the **Attribution windows** tab on the Wider Planet page.

To minimize discrepancies when comparing Branch and Wider Planet reporting, match your Branch attribution windows to the settings in your Wider Planet account.

| Attribution type | Default | Wider Planet's recommendation |
| --- | --- | --- |
| Click to start session | 1 day | 90 days |
| Click to install | 7 days | 30 days |
| Click to conversion event | 30 days | 90 days |
| Impression to start session | 1 day | 1 day |
| Impression to install | 1 day | 1 day |
| Impression to conversion event | 7 days | 1 day |
| Deep linking duration | 120 minutes | — |

For more information, follow [Configure attribution](https://help.branch.io/marketer-hub/ad-partner-integration-guide-new.md#configure-attribution) in the general [Ad Partner Integration Guide](https://help.branch.io/marketer-hub/ad-partner-integration-guide-new.md).

## Configure postbacks

Enabling Wider Planet automatically activates postbacks for `INSTALL`, `OPEN`, and `PURCHASE`. The default postback URL template is:

```
http://astg.widerplanet.com/delivery/wpc.php?v=1&ver=4.0&r=1&pb_aff=branch&ty=AppInstall&device=app&charset=utf-8&ti=${ (ad_network.credentials.client_id)! }&wpiad=<#if (user_data.os)! == "IOS" && (user_data.idfa)!?has_content >${(user_data.idfa)!}<#elseif (user_data.os)! == "IOS">${(user_data.idfv)!}<#elseif (user_data.os)! == "ANDROID"&& (user_data.aaid)!?has_content  >${(user_data.aaid)!}<#elseif (user_data.os)! == "ANDROID">${(user_data.android_id)!}<#elseif (user_data.os)! == "ROKU" >${(user_data.roku_rida)!}<#elseif (user_data.os)! == "SAMSUNG"  >${(user_data.samsung_ifa)!}<#elseif (user_data.os)! == "LG"  >${(user_data.lg_ifa)!}<#elseif (user_data.os)! == "PANASONIC" >${(user_data.panasonic_ifa)!}<#elseif (user_data.os)! == "WINDOWS"  >${(user_data.windows_aid)!}<#elseif (user_data.os)! == "PLAYSTATION" >${(user_data.playstation_ifa)!}<#elseif (user_data.os)! == "XBOX" >${(user_data.xbox_msai)!}</#if>&bundleid=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID">${(bundle.android.package_name)!}<#elseif bundle.os == "IOS">${(bundle.ios.bundle_id)!}</#if><@break/></#if></@loop>&appversion=${ (user_data.app_version)! }&ts=${ (timestamp/1000)?long }&ref=${ (last_attributed_touch_data.~click_id)! }&dm=${ (user_data.model)! }&useragent=${ (user_data.user_agent)! }&campaignid=${ (last_attributed_touch_data.~campaign_id)! }&t0=AppInstall&i0=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID">${(bundle.android.package_name)!}<#elseif bundle.os == "IOS">${(bundle.ios.bundle_id)!}</#if><@break/></#if></@loop>-${ (user_data.app_version)! }&p0=0&q0=1&dlid=${ (last_attributed_touch_data.~click_id)! }&cparams=${ (last_attributed_touch_data.cparams)! }&_evt=${ (name)! }
```

To add postbacks for additional events or to customize behavior, follow [Configure postbacks](https://help.branch.io/marketer-hub/ad-partner-integration-guide-new.md#configure-postbacks) in the general [Ad Partner Integration Guide](https://help.branch.io/marketer-hub/ad-partner-integration-guide-new.md).

## Create a Branch Ad Link

Create a Branch Ad Link to use in your Wider Planet campaigns. Branch uses the link to attribute clicks and deep link users into your app.

Follow [Create Ad Links](https://help.branch.io/marketer-hub/ad-links-new.md).

## Verify your data

After your integration is connected and events are flowing, you can verify data is reaching Branch:

- **In Branch** [**Liveview**](https://app.branch.io/testing-and-monitoring/events): confirm that events from your app appear in real time. This is the fastest way to confirm SDK events are firing.
- **In Branch** [**Analysis dashboards**](https://help.branch.io/marketer-hub/analysis-data-sources-new.md): review attributed installs and events where `Ad Partner Name = Wider Planet`.
- **In Wider Planet**: confirm that forwarded events are appearing in your Wider Planet attribution reporting.

## Data mappings

### Campaign data

Branch populates the following fields from Wider Planet campaign data.

| Branch field | Partner data |
| --- | --- |
| `~advertising_partner_name` | `"Wider Planet"` (static) |