Create a Lyft SAN Campaign

Contents

The following document describes how to set up a campaign for Lyft SAN. Kochava enhances your install and event data with the Lyft SAN ad impression or click metadata directly from Lyft SAN to allow for extremely accurate and complete data.

Data Needed Before Beginning Process:

Lyft Product ID.
Lyft Event Name.

Create a Link for a Lyft SAN Install Campaign

Log in to Kochava.
Select the desired Account and App.
Select Engagement > Campaign Manager.

Feature Note: To add this menu item to your Favorites Menu, select the “+” sign that appears when you hover over the menu. The Features Menu provides quick access to your most frequently visited areas of the Kochava UI.

Click + Add (Tracker) or Select Segment Tools (⋮) > Add Tracker.

Enter the Tracker Name.

NOTE: When a Tracker is created, Kochava automatically generates a name for the Tracker. We recommend that you replace the Tracker name at this point with a clear name of your choosing.

Select Tracker Type > Acquisition. (default setting)
Select Media Partner > Lyft SAN.
Select Agency Partner. (optional)
Enter the Destination URL.

NOTE: The Destination URL is not relevant and should simply be your website.

Enter a Deep Link. (optional)
Enter any Custom Parameter(s). (optional)
Click Save. (If no further trackers need to be created)
Click Save & Add Another Tracker. (If additional trackers need to be created)
Click Save & Create Postback (to navigate directly to the Partner Configuration page).

Install Postback Configuration

Select Apps & Assets > Partner Configuration.

Feature Note: To add this menu item to your Favorites Menu, select the “+” sign that appears when you hover over the menu. The Features Menu provides quick access to your most frequently visited areas of the Kochava UI.

Click Add a Configuration.
Select Media Partner > Lyft SAN.
Click Go.
Select Install > 🖉 (Edit).
Enter the Lyft Product ID.
Select the Lyft Event Name > first_open.
Click Save.

Reengagement Configuration

The information within this section provides the steps necessary to establish a reengagment campaign. If a reengagment campaign does not need to be created, the information in this section may be disregarded.

NOTE: If a reengagement campaign does not need to be set up, but the data associated with post-install events needs to be sent to Lyft SAN follow the steps within the Create a Postback Section below.

Create a Reengagement Segment:

Locate the desired Campaign.
Select Campaign Tools (⋮) > Add a Segment.
Enter a Segment Name.
Enter a Segment Description. (optional)
Click Submit.

Create a Reengagement Tracker:

Click + Add (Tracker) or Select Segment Tools (⋮) > Add Tracker.
Enter a Tracker Name.
Select Tracker Type > Reengagement.
Select Media Partner > Lyft SAN.
Select an Agency Partner. (optional)
Select the desired Lyft SAN Event.

NOTE: A Reengagement event can be added by clicking on the “+” and removed by clicking “X“.

Click Save (If no further trackers need to be created).
Click Save & Create Postback (to navigate directly to the Partner Configuration page).

Post-Install Event Postback Configuration:

Select Apps & Assets > Partner Configuration.

Expand Lyft SAN Postbacks.
Locate the desired event and Click Create for a new configuration or 🖉 (Edit) for an existing configuration.
Enter the Lyft Product ID.
Select the Lyft Event Name.
Click Save.

Standard Post-Install Event List:

Key	Description
first_open	The install or first launch of the application.
session_start	When a user successfully launches an instance of the app.
start_trial	When a user successfully signs up for a given trial product.
subscribe	When a user pays for a subscription.
sign_up	When a user completes an app sign up.
share_with_friend	Link shared with contact.
video_view	Video complete.
level_complete	When the user completes a level within the app.
first_video_view	When the user makes the initial video view.
checkout_start	User has completed checkout of items in cart.
purchase	Item has been purchased.
ad_initiate	Ad has been started.

Click and Impression Attribution Macros:

Click-through attribution, also known as click tracking, is the term used when a click leads to a user action within a certain attribution window. View-through attribution, also known as impression tracking, is the term used when an impression leads to a user action within a certain attribution window. The attribution window is supported for 30 day click lookback and 14 day impression lookback to meet your business needs.

URL Parameters	Description	Type
campaign_group	Account level ID.	string
campaign_name	Name of the campaign.	string
creative_name	Name of the creative.	string
creative_id	ID of the creative.	string
country	2 Digit country code where ad was served.	string
site_name	Human-readable name of the site where the ad was served.	string
ad_type	The type of ad served.	string
ad_size	The size of the ad served.	string

Example Attribution Response

Match:

{
"success": true,
            "attributionMode": "BMA", 
	"type": "impression",
	"metadata": {
"campaign_group": "campaign_group",
"campaign_name" : "campaign_name",
"creative_name" : "creative_name",
"creative_id": "creative_id",
"country" : "country",
"site_name": "site_name",
"ad_type" : "ad_type",
"ad_size" : "ad_size"
	},
	"match": {
		"idfa": "EA7583CD-A667-48BC-B806-42ECB2B48606"
	}
}

No Match:

{
    "success": false,
    "attribution_mode": "BMA",
    "type": null,
    "matched_by": null,
    "matched_by_keys": null,
    "metadata": null,
    "match": null
}

Updated on August 19, 2025

Was this article helpful?

Yes No

Marketers

Developers

Partners