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

# Enable BuzzScreen (New)

> Connect BuzzScreen to Branch to attribute clicks and installs on lock-screen reward advertising campaigns.

## Overview

[BuzzScreen](https://www.buzzvil.com/en) is a lock-screen advertising product from Buzzvil, a South Korean adtech company, that displays reward-based ads on the device lock screen. Connect BuzzScreen 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 BuzzScreen in the [new Branch experience](https://help.branch.io/marketer-hub/new-branch-overview.md). For information on BuzzScreen in legacy Branch, visit our [legacy guide](https://help.branch.io/marketer-hub/buzzscreen.md).

### Partner capabilities

| Capability | Details |
| --- | --- |
| Company type | Non-SAN ad network |
| Deep linking | Supported |
| Attribution | Contact BuzzScreen for details. |
| Ad campaign types | Contact BuzzScreen for details. |
| Ad formats | Contact BuzzScreen for details. |
| Click types | Contact BuzzScreen for details. |
| Supported platforms | iOS, Android, Amazon, Windows |
| Link wrapping | Contact BuzzScreen for details. |
| Cost ingestion support | Contact BuzzScreen for details. |
| Pricing models | CPI, CPC, CPM, CPA, CPV |

## Before you begin

To set up the BuzzScreen 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 BuzzScreen account with admin access.
- [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 BuzzScreen

To begin, navigate to **Configuration > Ad Partners > BuzzScreen**.

BuzzScreen doesn't require credentials to activate. The integration is enabled automatically when you select **Enable BuzzScreen** on the BuzzScreen page.

## Configure attribution

By default, BuzzScreen uses your global app attribution settings. To set attribution windows specific to BuzzScreen, enable the **Override global app settings** toggle on the **Attribution windows** tab.

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 BuzzScreen automatically activates postbacks, including `INSTALL`, `OPEN`, and `COMPLETE_REGISTRATION`. The default postback URL template is:

```
https://track.buzzvil.com/action/pb/cpa/tune/?bz_tracking_id=${ (last_attributed_touch_data.~click_id)! }&publisher_id=${ (last_attributed_touch_data.~secondary_publisher)! }&campaign_id=${ (last_attributed_touch_data.sub_publisher)! }&event_type=install&publisher_sub1=${ (last_attributed_touch_data.publisher_sub1)! }&publisher_sub2=${ (last_attributed_touch_data.publisher_sub2)! }&package_name=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="IOS"><@break/><#elseif bundle.os == "ANDROID">${(bundle.android.package_name)!}</#if><@break/></#if></@loop>&timestamp=${ (timestamp/1000)?long }
```

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 BuzzScreen 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 = BuzzScreen`.
- **In BuzzScreen**: confirm that forwarded events are appearing in your BuzzScreen attribution reporting.

## Data mappings

### Campaign data

Branch populates the following fields from BuzzScreen campaign data.

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

### Link parameters

By default, Branch automatically appends these link parameters to BuzzScreen ad links. When a user clicks the link, BuzzScreen provides the corresponding values, which Branch ingests and uses for attribution and reporting.

| Branch parameter | Link placeholder |
| --- | --- |
| Click ID | `{bz_tracking_id}` |
| Secondary Publisher | `{publisher_id}` |
| Custom Link Macro | `{sub_publisher}` |
| Custom Link Macro | `{publisher_sub1}` |
| Custom Link Macro | `{publisher_sub2}` |
| Campaign ID | `{campaign_id}` |
| Click AAID | `{adid}` |
| Click IDFA | `{adid}` |