# Modaramo Media

> Set up Modaramo Media with AnyTrack to track conversions accurately and optimize ROAS. simplify your marketing stack with unified conversion attribution across multiple ad platforms.

## Modaramo Media Integration Overview

The Modaramo Media and AnyTrack integration simplifies conversion tracking by sending data directly from Modaramo Media to AnyTrack. From there, your conversion data flows automatically to Google Ads, Facebook ``Conversion API``, and TikTok API for complete visibility across all channels.

<Prerequisites
  title="Before you begin"
  items={[
    { label: "You have an AnyTrack account with a paid subscription", done: true },
    { label: "You have an active Modaramo Media affiliate account", done: true },
    { label: "The AnyTrack <code>Tracking Tag</code> is installed on your website", done: true },
  ]}
/>

### How does the Modaramo Media AnyTrack integration work:

1. **Traffic**: AnyTrack collects traffic source and first-party data when visitors land on your website.
2. **Engagements**: When visitors click Modaramo Media affiliate links, AnyTrack captures the `OutboundClick` event and triggers tracking API requests to your analytics and Tracking Tags.
3. **Conversions**: AnyTrack receives conversion data in real-time from Modaramo Media via Postback URL when visitors convert on the merchant's website.
4. **Attribution**: AnyTrack processes conversions and reports them across the AnyTrack Dashboard.
5. **`Conversion API`**: AnyTrack forwards conversions to your ad platforms' ``Conversion API`` to optimize machine learning and ad performance with complete conversion data.

### Technical details

| Reference       | Value           | Information                                                                        |
| --------------- | :-------------- | :--------------------------------------------------------------------------------- |
| Tracking Group  | `modaramomedia` | The Tracking Group reference can be used to activate <Glossary>AutoTag</Glossary>. |
| Subid Parameter | `aff_click_id`  | The Subid Parameter used to pass the AnyTrack `click_id`.                          |
| Tracking Method | `Postback URL`  | -                                                                                  |

### Standard Conversions

| Event Name      | Details                                                 | Data Source     |
| :-------------- | :------------------------------------------------------ | :-------------- |
| `OutboundClick` | When a visitor clicks on Modaramo Media offer links.    | AnyTrack JS Tag |
| `Lead`          | When a free registration is recorded in Modaramo Media. | Postback URL    |
| `Purchase`      | When a user generates a commission in Modaramo Media.   | Postback URL    |

### The Modaramo Media Postback URL

The Postback URL is fully pre-defined and ready to be implemented with your Modaramo Media account.

```http
https://t1.anytrack.io/hBtoE3hN/collect/modaramomedia?aff_click_id={aff_click_id}&offer_id={offer_id}&offer_name={offer_name}&offer_ref={offer_ref}&goal_id={goal_id}&affiliate_id={affiliate_id}&affiliate_name={affiliate_name}&affiliate_ref={affiliate_ref}&source={source}&aff_sub={aff_sub}&aff_sub2={aff_sub2}&aff_sub3={aff_sub3}&aff_sub4={aff_sub4}&aff_sub5={aff_sub5}&aff_unique1={aff_unique1}&aff_unique2={aff_unique2}&aff_unique3={aff_unique3}&aff_unique4={aff_unique4}&aff_unique5={aff_unique5}&offer_url_id={offer_url_id}&offer_file_id={offer_file_id}&file_name={file_name}&advertiser_id={advertiser_id}&advertiser_ref={advertiser_ref}&adv_sub={adv_sub}&transaction_id={transaction_id}&sale_amount={sale_amount}&currency={currency}&payout={payout}&device_id={device_id}&session_ip={session_ip}&ip={ip}&datetime={datetime}
```

## Setup Guide

### Step #1: Add Modaramo Media to your AnyTrack Account

1. Go to the **[Integration Catalog](https://dashboard.anytrack.io/catalog/)**, search for Modaramo Media.

2. Now click on the [Modaramo Media card](https://dashboard.anytrack.io/catalog/modaramomedia)and then Click on Install.

### Step #2: Connect your Modaramo Media account

1. Copy the predefined Postback URL
2. Go to modaramo.com affiliate account
3. Navigate to the offer you wish to track
4. Scroll down and open the Tracking Tag / Postback settings
5. Click on “add a new pixel/postback”
6. Select the code type “postback"
7. Select the Goal
8. Paste the postback URL
9. Click on Create

### Step #3: Adjust the Conversion Event Mapping

The Event Mapping allows you to define which events to track and map them to Conversion Events you will forward to your Ads Integrations (e.g., Facebook `Conversion API`)

***

## Validate your integration

This section will enable you to validate the main aspects of your setup.

<Callout icon="🔎" theme="default">
  ### Install the AnyTrack Pixel Helper Extension

  Install the [AnyTrack Pixel Helper](https://chromewebstore.google.com/detail/anytrack-pixel-helper/ojmhkmdpagjeopleoeihbhgejcfoijjn) Chrome extension to verify the AnyTrack Tag is installed on your website. It also shows connected ad platforms and browser-side events. [View the Pixel Helper guide](/docs/anytrack-chrome-extension).
</Callout>

### Link tracking

Since Tracking starts when visitors clicks on offer links, you verify that your links are tracked and AutoTagged.

### AutoTag Methods

<Callout icon="🔥" theme="default">
  ### Reminder about AutoTag:

  **AutoTag** is a function that is enabled by default through the AnyTrack Tracking Tag, and that appends `aff_click_id` & `click_id` data to affiliate links. Learn [more about AutoTag](/docs/autotag).
</Callout>

* **Default**: By default, AnyTrack automatically identifies and AutoTags Modaramo Media links found on your website.
* **AutoScan**: AnyTrack scans links that are embedded in redirects plugins and AutoTags them accordingly.
* **Manual**:
  * **Tracking Group Attribute**: You add the tracking group attribute to links according to their tracking requirements. For example: `data-tracking-group="hasoffers"` or `rel="hasoffers"`. More about [Tracking Group](/docs/tgid).
  * **Click ID Token:** You Manually append the `subid`: `&aff_click_id=--CLICK-ID--` to the offer link.

Once the links are set up, you can check in your Modaramo Media account reports and see whether the `aff_click_id` parameters are passed to the offer links.

**Here is an example of how you would manually update links from`hasoffers`:**

```html
<a href="https://example.foo/goto/modaramomedia" data-tracking-group="hasoffers">Hover on theModaramo Media Demo   
Link to see the AnyTrack `click_id`</a>
```

<HTMLBlock html={"\n<a href=\"https://example.foo/goto/modaramomedia\" data-tracking-group=\"hasoffers\">Hover on the Modaramo Media Demo Link to see the AnyTrack <code>click_id</code></a>\n"} />

> 📘 **Tracking**
>
> Tracking Group refers to the integration technology. For example, Modaramo Media <Glossary>Tracking Group</Glossary> tracking group is `hasoffers` and ClickBank is `ClickBank`. <Glossary>The Tracking Group</Glossary>

### Conversion Tracking

To validate your setup, you wait for a conversion or trigger a test conversion yourself and inspect the conversion logs.

**Modaramo Media conversion payload example**

```json

{
  "AnyTrack": "1100l35864",
  "customer_type": "existing",
  "country": "US",
  "referer": "https://www.chewy.com/",
  "search_keyword": null,
  "search_engine_id": null,
  "conversion_time": "1684692689",
  "`conversion_id`": "1011l2002827904",
  "publisher_reference":"mz7yYainzaN6hkc52QVBg",
  "publisher_commission": "10.57",
  "creative_id": "0",
  "source_referer": null,
  "advertiser_reference": null,
  "conversion_type": "1",
  "creative_type": "0",
  "conversion_reference": "1354998698",
  "metadata_query_string": null,
  "currency": "USD",
  "tracking_method": "clickref",
  "value": "52.85",
  "items": [
    {
      "item_code": null,
      "item_id": "1011l860699483",
      "item_sku": "332503",
      "item_commission": "3.5720",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "3.5720",
      "item_meta": null,
      "item_status": "1",
      "item_value": "17.8600",
      "item_category": "11130",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1011l860699484",
      "item_sku": null,
      "item_commission": "0.0000",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "0.0000",
      "item_meta": null,
      "item_status": "1",
      "item_value": "0.0000",
      "item_category": "COMMISSION",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1101l859617416",
      "item_sku": "677350",
      "item_commission": "6.9980",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "6.9980",
      "item_meta": null,
      "item_status": "1",
      "item_value": "34.9900",
      "item_category": "2802",
      "item_vertical": null
    }
  ],
  "campaign_id": "1100l517",
  "query_string": null,
  "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1"
}

```

***

<FaqAccordion
  title="FAQ and Troubleshooting"
  icon="fa-duotone fa-circle-question"
  items={[
    {
      question: "Can I import past conversions into AnyTrack?",
      answer: "No. AnyTrack can only ingest conversions that have been triggered following a visitor session on your website."
    },
    {
      question: "Can I track direct linking campaigns?",
      answer: "Yes, but this requires a custom setup. Please refer to this <a href='/docs/deeplink'>article</a>."
    },
    {
      question: "Can I use a different <code>subid</code> parameter than the one predefined by AnyTrack?",
      answer: "No."
    },
    {
      question: "Can I track conversions without the <code>click_id</code>?",
      answer: "No. The <code>click_id</code> passed to the Modaramo Media links is required to track conversions."
    },
    {
      question: "The Conversion Event Name is not what I am expecting, how can I change it?",
      answer: "You can update the Event Mapping in the Integration page.  "
    }
  ]}
/>