Install Instructions
After setting up events and actions for your tracker, you have to install it on your website. This can be done by following the instructions on the install instructions tab.
To access the trackers' instructions tab, select the tracker you need to install in the trackers' list. You must choose only one tracker at a time to use this tab. The tab will contain one section for each event created for the selected tracker.
There are several install methods available for this feature: Script, Pixel, Redirect,Apps Flyer and Google Ads Tracking Template. After expanding the section of the event you want to install, you can choose from these options:
Script
Script-based tracking uses code snippets embedded in a website’s pages to capture user interactions. The script collects data on clicks, time spent on pages, and specific actions taken by visitors. However, it requires that users' browsers have JavaScript enabled; otherwise, it will not function.
Events and actions are counted every time the script loads, so it must be installed on specific pages based on what you intend to track. To simplify the installation process, you can also use tag managers like Google Tag Manager (GTM).
These are some advantages of using the Script method:
Valuable Data: Tracks detailed user behaviors, such as clicks, time spent on the page, and navigation paths.
Real-Time Analysis: Provides immediate insights into user activity as it happens.
Use Cases
Script tracking gathers detailed user behavior directly from your website, helping optimize campaigns and improve marketing performance. Below are key applications of this method:
Landing Page Performance: A Software-as-a-Service (SaaS) company can use a script to monitor how users interact with CTAs on a landing page, optimizing conversion rates.
User Journey Analysis: An e-commerce store can track customer navigation from product pages to checkout, identifying drop-off points.
Campaign ROI Measurement: A digital marketing agency can install scripts on client sites to track traffic from PPC campaigns and attribute conversions.
How To Install
On the BMS Trackers page, click on the Install Instructions Tab.
Select the Script option.
Use the copy button
to copy the script displayed.If you have configured custom data fields, use the indicated placeholder to inform the custom data values.
Paste the code into your website, precisely on the page where you want this event to be captured.
Pixel
Pixel tracking involves using an invisible image or embedded code in web pages or emails. When a user accesses the content, the pixel renders and sends back information such as the user’s IP address, device type, and actions taken. This method is widely used in marketing campaigns to measure conversions and ad performance.
Events and actions are tracked each time the pixel renders, so it must be installed on specific pages or emails based on what you intend to monitor. To simplify the installation process, you can use tag managers like Google Tag Manager (GTM).
These are some advantages of using the Pixel method:
Email and Web Integration: Works seamlessly in emails and web pages to track opens, clicks, and conversions.
Precise Retargeting: Captures data to create retargeting audiences and improve your ad campaign's relevance.
Use Cases
Pixel tracking collects data from emails and websites, enabling precise campaign analysis and retargeting. Here are some practical marketing examples:
Email Campaign Tracking: A subscription service can embed a pixel in promotional emails to measure open rates and clicks on discount offers.
Ad Retargeting: A beauty brand can use a pixel to retarget users who viewed a product but didn’t complete a purchase, showing them personalized ads.
Lead Generation Optimization: A real estate agency can install a pixel on its form submission page to track leads generated from specific ad campaigns.
How To Install
On the BMS Trackers page, click on the Install Instructions Tab.
Select the Pixel option.
Use the copy button
to copy the image tag displayed.If you have configured custom data fields, use the indicated placeholder to inform the values.
Paste the code into your website, or email, precisely where you want this event to be captured.
Redirect
URL redirect tracking works by sending users through an intermediate link before reaching the final destination. This intermediate step collects valuable data, such as traffic sources, campaign parameters, and user behavior. It is a practical method for tracking clicks and understanding the performance of external campaigns or affiliate links.
These are some advantages of using the Redirect method:
Effective Attribution: Accurately tracks traffic sources and affiliate performance.
Campaign-Specific Insights: Ideal for measuring the success of external or affiliate campaigns.
Use Cases
URL redirect tracking simplifies performance monitoring by capturing data through intermediary links. Here is how it enhances marketing efforts.
Affiliate Marketing: A VPN provider can offer influencers unique redirect links to track subscriptions and reward top-performing partners.
Ad Platform Comparison: A fitness brand can use redirect links in different ad platforms to determine which platform generates more sign-ups.
Email Campaign Effectiveness: An online education platform can include redirect links in email CTAs to track how many users enroll in courses through the campaign.
How To Install
On the BMS Trackers page, click on the Install Instructions Tab.
Select the Redirect option.
Inform the URL to where you want to redirect the user after the event is captured.
Use the copy button
to copy the displayed URL.Use the generated URL just as you would use the URL you provided.
After installing your events' trackers you should start receiving data from them, it's possible to follow this process on the metrics tab.
Apps Flyer
AppsFlyer is a mobile attribution and marketing analytics platform. It enables businesses to measure and analyze the performance of their mobile advertising campaigns by attributing app installs, in-app events, and conversions to the respective marketing channels or campaigns responsible for generating them.
The platform also offers precise attribution solutions, allowing marketers to identify the sources of app installs, in-app events, and conversions—whether from the BMS network, other ad channels, or organic sources.
These are some advantages of integrating BMS with AppsFlyer:
Powerful Insights: Gain access to detailed data on user behavior, campaign performance, return on investment (ROI), and customer lifetime value (LTV).
Use Cases: Supports a variety of scenarios, including optimizing marketing campaigns, improving user acquisition strategies, and enhancing retention efforts.
Use Cases
AppsFlyer is a platform that tracks user interactions and campaign performance for apps, providing key insights to optimize marketing strategies. Here are its main use cases:
Attribution of App Installs: AppsFlyer can track which campaigns drive the most app installs, helping marketers allocate budgets to the most effective channels.
In-App Event Tracking: AppsFlyer can monitor user actions within the app, such as purchases or content views, providing insights to optimize user engagement.
Fraud Detection: AppsFlyer’s anti-fraud tools can detect and prevent fraudulent installs or clicks, ensuring reliable campaign performance and protecting ROI.
How to integrate BMS with your AppsFlyer account
After creating your account and setting up your app in AppsFlyer, it is time to add BMS as a partner marketplace to send your app's data to our platform. On the AppsFlyer homepage, navigate to the menu on the left, click on Collaborate, and then select Partner Marketplace.
Search for Blue Media Services LTDA using the search bar and select this option in the results list.\
BMS Parter Marketplace Click on
to start setting up the integration.\
Integration Manager Turn the
switch on.Default postbacks are attribution postbacks sent for user actions, such as install, re-install, etc. Select how to send the configured postbacks to our platform.
In-app event postbacks: Turn this switch on to send us your in-app events data, such as add-to-cart, product-viewed, among others.
In-app event postback window: Define the period following an install, re-attribution, or re-engagement during which in-app event postbacks will be sent to our platform.
Click on
to start adding an event.Fill in the details:
AppsFlyer event: Set a name for your event.
Mapped partner event: Copy and paste the BRN code from the BMS trackers' install instructions tab, in the 3rd step.
For users from: Select "This partner only" at the dropdown menu.
Including: Select "Value & no revenue" at the dropdown menu.
Add as many events as you need to.
Click on
to save your integration.
After completing these steps, BMS will be integrated with your AppsFlyer account, and the event data from your app will start being sent to our platform.
Google Ads Tracking Template
Google Tag Manager (GTM) is a tool that centralizes and simplifies the installation of tracking codes on a website without requiring direct changes to the site’s source code. Instead of embedding each script manually, you only need to install the GTM container once, and then manage all trackers, pixels, and events through the GTM dashboard.
GTM works by firing snippets of tracking code based on the rules you configure (called triggers). This allows you to decide which pages or user actions will activate each tag.
This approach eliminates the need for constant code edits, making the process more efficient and secure.
Here are some advantages of using trackers through GTM:
Centralized Management: All tracking scripts and pixels are handled in one place.
Flexibility: Configure conditional triggers such as button clicks, page views, or form submissions.
Reduced Technical Dependency: Marketing teams can manage tags without relying on developers for every update.
Scalability: Perfect for sites running multiple campaigns, since it simplifies deployment and maintenance.
Use Cases
Tracking with GTM enhances insights into user behavior and campaign performance, such as:
Conversion Tracking: An online store can set up a GTM event that fires when a purchase is completed, ensuring accurate ROI attribution.
Page Element Testing: A news site can track which headlines users click on most, optimizing content engagement.
Multi-Channel Campaign Measurement: A marketing agency can install various ad pixels (Google Ads, Facebook Ads, LinkedIn Ads) via GTM without altering the client’s website code.
How to Install
Access you GTM and click on Create a New Tag
In the left menu, click on Tags.
Click New and name your tag as you prefer.
Click on Tag Configuration and choose Custom HTML.
Add the Tracking Script
Copy and paste the script that is shown on the install instruction:\
Google Ads Tracking Template Script Replace the placeholders with your custom values:
REPLACE_WITH_PRICE→ the transaction value (if applicable).REPLACE_WITH_QUANTITY→ the number of items (if applicable).REPLACE_WITH_DEDUPLICATIONID→ a unique transaction or event ID to prevent duplicates.{lpurl}→ leave as-is, it will automatically resolve the landing page URL.
Set the Trigger
Under Triggering, click on + to add a new trigger.
Select Custom Event.
Enter the event name that matches the event pushed into the
dataLayer.Example: if your developers are pushing
dataLayer.push({ event: "purchase" }), usepurchaseas the trigger name.
Save the trigger.
Save and Publish
Save your new tag.
Click Submit in the top right corner.
Add a version name (e.g., Added Tracker Tag) and click Publish.
Additional Information
Check out some external references that may help you through the app configuration and partner integration process:
Last updated
Was this helpful?