Overview

YouAppi is a mobile performance advertising platform specializing in retargeting campaigns for iOS and Android apps. Connect YouAppi 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.

Note: this guide is for new Branch

Please note that this guide is about integrating YouAppi in the new Branch experience. For information on YouAppi in legacy Branch, visit our legacy guide.

Partner capabilities

Capability	Details
Company type	Non-SAN ad network
Deep linking	Supported
Attribution	Click-through attribution, View-through attribution
Ad campaign types	Retargeting campaigns
Click types	Client-side click
Supported platforms	iOS, Android
Link wrapping	Not supported
Cost ingestion support	Supported
Cost ingestion types	API
Cost time zone	GMT
Cost data scheduling	At 4, 9, 12, 18, 24, 36, 48, 72, 96, 120, 240, 360, 480, and 720 hours from midnight
Pricing models	CPI, CPC, CPA

Before you begin

To set up the YouAppi integration, you need:

• Ad partner integrations enabled for your Branch account. Availability varies by Branch plan. See Branch pricing or contact your Branch representative.
• A Branch account with access to Configuration > Ad Partners and admin permissions to enable and configure integrations.
• The Branch SDK implemented in your app (iOS | Android) with event tracking configured.
• A YouAppi account with admin access. Contact your YouAppi account manager to obtain your Advertiser ID.

Enable YouAppi

1. Navigate to Configuration > Ad Partners > YouAppi.
2. Select Partner settings to open the Manage account dialog.
3. Under Postback Credentials, enter your YouAppi Advertiser ID, available from your YouAppi account manager.
4. Select Save.

To update these credentials later, select Partner settings on the YouAppi page to reopen the Manage account dialog.

Configure attribution

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

For more information, follow Configure attribution in the general Ad Partner Integration Guide.

Configure postbacks

Enabling YouAppi automatically activates postbacks for INSTALL. The default INSTALL postback URL is:

https://service.youappi.com/tracking/event?params={params}&trackertoken={trackertoken}&eventid={eventid}&deviceadid={deviceadid}&deviceidfa={deviceidfa}&click_ts={click_ts}&install_ts={install_ts}&event_ts={event_ts}&event_ip={event_ip}&country={country}&bundle_id={bundle_id}&google_ref=youappi_referrer&user_agent={user_agent}&tracker=branch&ya_reen_id={ya_reen_id}&ya_adv_id={advertiserID}&eventid={event_name}&os={os}&eventvalue={event_value}&device_model={device_model}&items={event_data}&idfv={idfv}

To add postbacks for additional events or to customize behavior, follow Configure postbacks in the general Ad Partner Integration Guide.

Import cost data

YouAppi cost ingestion uses API authentication. The API Key is entered in the same Manage account dialog as your postback credentials.

1. From the YouAppi page in Configuration > Ad Partners, select Partner settings to open the Manage account dialog.
2. Under Cost Data Credentials, enter your API Key.
3. Select Save.

After saving, the Cost Data card on the Status tab updates to reflect the connected state.

Create a Branch Ad Link

To attribute conversions from YouAppi campaigns, create a Branch Ad Link and use it in your YouAppi campaign setup. See Branch Ad Links.

Verify your data

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

• In Branch Liveview: 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: review attributed installs, events, and cost data where Ad Partner Name = YouAppi.
• In YouAppi: confirm that forwarded events are appearing in your YouAppi attribution reporting.

Cost data appears after approximately 24 hours. Confirm campaigns are actively running in YouAppi before troubleshooting missing cost data.

Data mappings

Campaign data

Branch populates the following fields from YouAppi campaign data.

Branch field	Partner data
~advertising_partner_name	YouAppi (static)
~campaign	Campaign name
~ad_set_name	Ad set name
~ad_name	Ad name