Data Needed Before Beginning Process:
- NBCU Product ID
- NBCU Event Name
Create a Tracker for a NBCU — SAN Install Campaign
- Log in to Free App Analytics.
- 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 > NBCU — 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, Free App Analytics 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.
A. Campaign and Segment selection/creation section.
Install Postback Configuration
- Select Apps & Assets > Partner Configuration.
- Click Add a Configuration.
- Select Media Partner > NBCU — SAN.
- Click Go.
- Select Install > Postback Tools (⋮) > Edit.
- Enter the NBCU Product ID.
- Select the NBCU 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 NBCU — 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 > NBCU — SAN.
- Select an Agency Partner. (optional)
- Select the NBCU — SAN Event that will map to the selected Free App Analytics event.
- Add Reengagement Event.
- Click Save (If no further trackers need to be created).
- Click Save & Add Another Tracker (If additional events 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 NBCU — SAN > Network Tools (⋮) > Postbacks.
- Locate the desired event and Click Create for a new configuration or Edit for an existing configuration.
- Enter the NBCU Product ID.
- Select the NBCU Event Name.
- Click Save.
Standard Post-Install Event List:
Key | Description |
---|---|
session_start | When a user successfully launches an instant of the app. |
trial | When a user successfully signs up for a given trial product. |
sign_up | When a user completes an app sign up. |
subscription | When a user pays for a subscription within a 14 day lookback of exposure (impression or click) to a media campaign. |
checkout_start | User has completed checkout of items in cart. |
purchase | Item has been purchased. |
first_video_view | When the user makes the initial video view. |
video_view | Video complete. |
ad_initiate | Ad has been started. |
content_view | The user has viewed the ad content. |
share_with_friend | Link shared with contact. |
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 14 day click lookback and 14 day impression lookback to meet your business needs.
URL Parameters | Description | Type |
---|---|---|
timestamp | Unix timestamp in seconds. | integer |
campaign_name | Name of the campaign. | string |
campaign_id | ID of the campaign. | string |
country | 2 Digit country code where ad was served. | string |
device_id | ID of the device. | string |
ip | IP of click or impression (IPv4 and IPv6 supported). | string |
Example Attribution Response
Match:
{ "success": true, “attributionMode”: “BMA”, "type": "impression", "metadata": { "creative_id": "Sample Creative", "site_id": "7774bc1af39681954243777812cb7009", "unix_date": "1476137388" }, "match": { "idfa": "777583CD-A667-48BC-B806-444CB2B48606" } }
No Match:
{ "success": false, "attribution_mode": "BMA", "type": null, "matched_by": null, "matched_by_keys": null, "metadata": null, "match": null }