How to Implement Conversion Tracking in Gamoshi Dashboard

This guide explains how to set up conversion tracking within the Gamoshi Dashboard.

This guide explains how to set up conversion tracking within the Gamoshi Dashboard, allowing you to track and analyze conversion events. Several methods are available, depending on the type of activity (app or web) and whether an external tracking provider is used.

Supported Conversion Types

Script – Web conversions only
Pixel – Available for both web and app conversions

1. Script-Based Web Conversion Tracking

For web-based conversions, you can provide the advertiser with a conversion script to track events directly, bypassing the need for an external provider.

a. Direct Integration (Gamoshi Script)

- The Gamoshi script is embedded directly into the webpage.
- It listens for relevant events in real time and triggers conversion tracking immediately.

b. External Event Trigger (via Third-Party Manager)

- The advertiser uses a third-party event management tool (e.g., Google Tag Manager).
- The external system detects the event and triggers the Gamoshi script accordingly.

2. Pixel-Based Conversion Tracking

Suitable when the advertiser relies on an external measurement provider.
Gamoshi supplies a pixel that is triggered when the conversion event occurs.
Pixel deployment can be client-side or server-side, depending on the provider’s specifications and integration requirements.

Setting Up Conversions and Goals in the Conversions Screen

In the Advertisers Module → Conversions screen, you can define conversions and set specific conversion goals for both app and web activities. This screen supports more complex tracking scenarios by enabling multiple goals per conversion.

Step-by-Step Guide

For App Conversions:

Define a Conversion:
- Name the conversion, select App in the "Conversion Type" dropdown, choose the relevant advertiser, and put in the Target URL.
- Click the "Create Conversion" button.
- The target URL will be the default for all the advertiser's creatives associated with the conversion. You can override this Target URL on the creative level.
Set Conversion Goals:
- Create goals based on the events you wish to track.
Generate and Share Pixel URLs:
- For each goal, copy the Pixel URL and share it with the advertiser so they can implement it within their tracking system. You can also use the 'Copy all Goals Pixels' icon to copy all pixels together.

For Web Conversions:

Define a Conversion:
- Name the conversion, select Web in the "Conversion Type" dropdown, and enter the conversion domain URL and Target URL.
- If the Gamoshi script should handle events on the webpage, activate the 'Listen On Events' switch. If not, and you are using an external provider or Google Tag Manager, deactivate the 'Listen On Events' switch.
Set Conversion Goals:
- Add goals based on the desired conversion events.
- If the "Listen On Events" switch is active, populate the "CSS Selector" field in the goal if a specific button needs to activate the event.
Provide Tracking Options:
- If using an External Provider, Copy each goal's Pixel URL to provide to the partner for implementation.
- If Not Using an External Provider:
  - In the conversion record’s Actions column, select "Copy Script for Web" .This script should be placed on the advertiser's conversion page.
  - To trigger events manually, you can also share individual Pixel URLs or scripts for each goal.
- You can also generate full integration, including the conversion script and all relevant pixels, by pressing the "Generate Integration" icon at the Goals grid table.

Conversion Tracking Examples

Web Conversion Script Example

<script>
   window.g_conversion_tracking = {
      id : 65,
      uuid: 'b3ded0f0-02b5-449e-a31e-a35ae299c50c',
      bidder_host: 'rtb.bidder.com',
      event_mode : false
   };
</script>
<script src="https://rtb.bidder.com/static/web_conv.min.js"></script>

If you use the CSS selector in the goals, the following parameter will be added to the script: event_mode: true. Please take a look at the example below. Using the CSS selector usually means that the advertiser doesn't have a system or mechanism to fire the event using a pixel or event function, and they need the Gamoshi script to do it by indicating the CSS selector in the goal.

<script>
   window.g_conversion_tracking = {
      id : 65,
      uuid: 'b3ded0f0-02b5-449e-a31e-a35ae299c50c',
    bidder_host: 'rtb.bidder.com',
      event_mode : true
   };
</script>
<script src="https://rtb.bidder.com/static/web_conv.min.js"></script>

Web Goal Script Example

// Goal Tracking Script
// ------------------------------------
// Goal: email now (ID: 87, Type: ClickToAction)
// Conversion Tracking: gfgft (ID: 62)
// ------------------------------------

<script>
  // Trigger the goal tracking function
  window.fireOnGoal(87);
</script>

// ------------------------------------
// Optional Parameters:
// 1. Conversion Value (Decimal) - The monetary value of the conversion in dollars.
// 2. Conversion Order ID (String) - A unique identifier for the order or event.
// 3. Conversion External User Id (String) - An identifier for another global user id.
//
// Including these parameters allows you to track and analyze conversions in the analytics dashboard.
// ------------------------------------

// Example Usage:
// Tracking a conversion with a price of $1.40 and an order ID of 'order-1234'
// window.fireOnGoal(87, 1.4, 'order-1234', 'external-user-id');

// ------------------------------------

For advanced usage, the window.fireOnGoal method can accept two additional parameters: revenue (in dollars) and order ID.

Example:

window.fireOnGoal(42, 2.3, 'order_1234'); 
// Here, 2.3 is the revenue, and 'order_1234' is the order ID.

Example of a Pixel URL

https://rtb.bidder.com/conversion/pixel/
e92ce6c4-94f0-4fa9-a1fb-6e1f2a5d8593/87/1743505000126/im.gif?gam_pb=[POST_BACK_DATA]

Associating a conversion with a creative

For the conversion to be active, you need to associate it with a creative.

Step-by-Step Guide

Open the relevant creative in "Edit" mode.
Open the "Conversion & tracking" section and choose the relevant conversion.
Just so you know, you need to select an advertiser for the creative before selecting a conversion; when you do that, you will see only the advertiser's relevant conversions in the conversions select box.
Deactivating the "Use Conversion Tracking Url" switch allows you to choose not to use the conversion target URL, allowing you to enter a specific Target URL for the creative.
Press the "Update" button.