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 Links > Campaign Manager.
- Click Add a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter the Tracker Name.
- Select Tracker Type > Acquisition. (default setting)
- Select Media Partner > Lyft SAN.
- Select Agency Partner. (optional)
- Enter the Destination URL.
- 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).
NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document.
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.
NOTE: The Destination URL is not relevant and should simply be your website.
Install Postback Configuration
- Select Apps & Assets > Partner Configuration.
- Click Add a Configuration.
- Select Media Partner > Lyft SAN.
- Click Go.
- Select Install > Postback Tools (⋮) > 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 a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter a Tracker Name.
- Select Tracker Type > Reengagement.
- Select Media Partner > Lyft SAN.
- Select an Agency Partner. (optional)
- Select the desired Lyft SAN Event.
- Click Save (If no further trackers need to be created).
- Click Save & Create Postback (to navigate directly to the Partner Configuration page).
NOTE: A Reengagement event can be added by clicking on the “+” and removed by clicking “X“.
Post-Install Event Postback Configuration:
- Select Apps & Assets > Partner Configuration.
- Select Lyft SAN > Network Tools (⋮) > 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
}