Skip to main content

How Tracking Works

Learn how Besitos tracks user activity from an offer click through conversion and reward.

When a user starts an offer, Besitos and the advertiser's tracking systems work together to attribute the user's activity. As the user completes the applicable activity, Besitos records conversions and makes the results available through reporting, postbacks, and API.

Tracking and conversion behavior varies by offer type. Games use installs and in-app events, deals use qualifying actions, and surveys use survey qualification and completion. When troubleshooting an issue, start with the offer type to identify the applicable tracking or qualification flow.

The tracking process can vary by offer and integration method. Understanding the basic journey can help you plan your integration, know what to test, and communicate more effectively with the Besitos team when something doesn't work as expected.


Tracking involves multiple systems

Tracking depends on data being recorded and shared accurately between your platform, Besitos, game studios, and attribution providers (MMPs). Each has its own systems, rules, maintenance, and uptime, so delays or gaps can sometimes occur even when your integration and device settings are configured correctly.

Because tracking involves multiple systems, what happens in one part of the journey can affect what you see in another. Besitos works with partners to investigate tracking issues, recover missing activity where possible, and improve the reliability of the overall tracking experience.


The tracking journey

At a high level, a user's activity follows this path:

Click → Redirect → Install or Action → Attribution → Event or Goal → Conversion → Postback → Reward

Not every offer type follows the same path. For example, a game may require an install and multiple goals, while a deal uses a different qualifying action, and a survey requires completion.

The key is that the user's activity must stay connected to the correct offer and user throughout the journey.

1. Click

The user selects an offer.

The click initiates the tracking flow and associates the applicable user and offer information with the activity.

Where to verify: Offer Wall and Traffic reports, where applicable.


2. Redirect

The user is sent through the Besitos tracking URL before continuing to the advertiser or offer destination.

The tracking flow associates information such as the partner user ID, offer ID, segment information, and applicable device identifiers with the click.

Where to verify: Besitos records the click but doesn't expose it as a standalone checkpoint.


3. Install or action

The user completes the action required to continue the offer. For games, this typically means installing the game through the offer flow.

Users who install through a different path, such as searching for the game in an app store, may not be attributed to the offer.

For deals, the qualifying action may be signing up or making a purchase.

Where to verify for games: After a tracked install, the game can appear in My Games for iFrame partners or in the in-progress state in the API experience for API partners. It should also show up in the Offer Wall report for iFrame partners.


4. Attribution

The advertiser's MMP associates the install with the original offer click and determines whether the activity qualifies for attribution.

For game offers, eligibility may depend on whether the user is new to the game.

Where to verify: Attribution itself isn't directly visible to the partner or Besitos in all cases.

See [User & Device Eligibility Checklist for Tracking] for applicable eligibility requirements.


5. Event or goal

The advertiser's MMP sends applicable activity to Besitos, such as an app launch, install, gameplay event, purchase, or other qualifying action.

For games, an install or activity such as launching the game may itself be a goal. Other games may require multiple goals or milestones.

Where to verify: Users can see applicable progress in their game experience. Partners can use the available reporting and conversion data.

See Troubleshooting Missing Installs or Game Progress when expected progress doesn't appear.


6. Conversion

When Besitos receives a qualifying conversion event, it records the conversion and makes the resulting conversion data available through reporting and, where enabled, the Conversions Data API.

Where to verify:

  • Conversions report

  • Conversions Data API

See Reporting Verification & Reconciliation for guidance on comparing these sources.


7. Postback

When postbacks are configured, Besitos sends conversion information to the partner's webhook.

Postbacks are delivered as GET requests that contain the relevant conversion data. A successful delivery requires an HTTP 200 response.

Where to verify:


8. Reward

After the conversion is recorded, the reward enters the applicable validation process.

The user may see the reward as pending before it becomes available, depending on the applicable reward rules.

An advertiser may later reverse a conversion if it determines the activity doesn't qualify. Your system should use transaction_id to associate the reversal with the original conversion.


Tracking identifiers

Several identifiers help connect a user's activity to the correct partner, offer, device, and conversion throughout the tracking journey.

Identifier

What it does

partner_id

Identifies your Besitos partner account.

partner_user_id

Identifies the user in your system and is passed through the tracking flow.

sub_id

Identifies an optional segment or placement.

info

Stores optional information you want to pass through the tracking flow, such as your own click or session ID.

device_id

Identifies the user's device for applicable tracking and eligibility checks.

idfa / gaid

Device advertising IDs used by the advertiser's MMP to help attribute installs and activity.

offer_id

Identifies the offer associated with the activity.

goal_id

Identifies the specific game goal completed, where applicable.

transaction_id

Uniquely identifies a conversion and should be used to associate postbacks with the original conversion.

These identifiers don't all appear at every stage or in every integration. Their availability depends on the offer and your integration method.

See User ID & Segmentation Guidelines, In-App Tracking Best Practices, and Postback Data for details about specific identifiers.


Who's involved?

Several systems and people can be involved in the tracking process.

  • End user: Interacts with offers and completes the required actions.

  • Partner: Integrates Besitos into your platform, identifies users, and receives conversion data to credit rewards.

  • Besitos: Hosts the offer, records applicable conversions, sends postbacks, and provides conversion data.

  • Advertiser and MMP: Handle attribution and activity tracking for applicable offers.

Exact responsibilities depend on your integration method and the offer type.


What your integration is responsible for

Your responsibilities depend on your integration method. In general, Besitos manages offer tracking and conversion processing, while your integration provides the user and offer connections needed to display offers and receive conversion information.

iFrame partners

Besitos provides the offerwall and manages the offer experience and underlying tracking.

Your implementation is responsible for:

API partners

With an API integration, your team controls how Besitos offers are displayed and incorporated into your experience.

Your implementation is responsible for:

  • Passing the required user information when making API requests.

  • Displaying and managing the Besitos offers in your experience.

  • Configuring a postback to receive conversion information from Besitos.

Besitos receives the applicable conversion/activity information through its own tracking and attribution systems and makes the resulting conversion data available to you.


Tracking and reporting are different

Tracking and reporting work together, but they answer different questions.

  • Tracking connects an individual user's activity to an offer and conversion.

  • Reporting provides information about the resulting activity so you can review, reconcile, and monitor conversions and rewards.

Verify both before launch.

See Integration Smoke Test and Reporting Verification & Reconciliation to learn how to verify your integration.


How to think about tracking problems

When troubleshooting tracking, identify the last confirmed event and the first missing event. Then use the troubleshooting article for that stage.

For example:

  • The user clicked an offer, but no install was recorded.

  • The user installed the game, but progress isn't appearing.

  • A conversion appears in Besitos, but your system didn't receive a postback.

  • Your system received the postback, but the reward is incorrect.

Identifying the first missing or incorrect checkpoint helps you focus your investigation.


What you need to know

You don't need to understand every technical detail of tracking to implement and succeed with Besitos.

The most important things to remember are:

  • Keep the user's identity consistent throughout the tracking journey.

  • Don't interfere with the offer or tracking flow.

  • Configure postbacks to receive conversion data.

  • Test the tracking journey before launch.

  • When something goes wrong, identify the first checkpoint that failed.

Did this answer your question?