# KMA (KissMyAds)

> Learn how to integrate KissMyAds (KMA) with AnyTrack, the conversion tracking and attribution platform, to improve ROAS and simplifies affiliate marketing conversion data.

## KMA (KissMyAds) Integration Overview

The KMA (KissMyAds) & AnyTrack integration allows you to connect your marketing campaigns and track conversions. The connection sends conversion data from KMA to AnyTrack, where it is then forwarded to various platforms such as Google Ads, Facebook `Conversion API` and TikTok API. This helps you optimize performance of your campaigns by seeing exactly which ones are performing best, in real-time. With this integration, you can get an accurate picture of how well each ad campaign is doing so that adjustments can be made for maximum ROI.

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

### How does the KMA (KissMyAds) AnyTrack integration work:

1. **Traffic**: When visitors land on your website, AnyTrack collects traffic source data and First Party data.
2. **Engagements**: When visitors click on your KMA (KissMyAds) affiliate links, AnyTrack does a few things:
   1. Collects granular data tied to the `OutboundClick`.
   2. Triggers Event Tracking API requests to your Tracking Tags and analytics.
3. **Conversions:** When visitors convert on the merchant's website, AnyTrack receives real time conversion data through Postback URL.
4. **Attribution:** AnyTrack processes the conversion data and reports it across various reporting sections of the AnyTrack Dashboard.
5. **`Conversion API`:** AnyTrack then sends your conversions to your **Ad Platforms' `Conversion API`** so you can feed your ad platform's Machine Learning, AI and automatic optimization according to 100% of your conversion data.

### Technical details

| Reference       | Value          | Information                                                                        |
| --------------- | :------------- | :--------------------------------------------------------------------------------- |
| Tracking Group  | `kma`          | The Tracking Group reference can be used to activate <Glossary>AutoTag</Glossary>. |
| Subid Parameter | `d3`           | 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 KMA (KissMyAds) offer links.    | AnyTrack JS Tag |
| `Lead`          | When a free registration is recorded in KMA (KissMyAds). | Postback URL    |
| `Purchase`      | When a user generates a commission in KMA (KissMyAds).   | Postback URL    |

### The KMA (KissMyAds) Postback URL

The Postback URL is fully pre-defined and ready to be implemented with your KMA (KissMyAds) account.

```http
https://t1.anytrack.io/hBtoE3hN/collect/kma?date={date}&date_unix={date_unix}&status={status}&zeustrack_status={zeustrack_status}&affise_status={affise_status}&loyalead_status={loyalead_status}&ip={ip}&stream={stream}&sum={sum}&currency={currency}&data1={data1}&data2={data2}&data3={data3}&data4={data4}&data5={data5}&orderid={orderid}&bannerid={bannerid}&campaignid={campaignid}&countrycode={countrycode}
```

## Setup Guide

### Step #1: Add KMA (KissMyAds) to your AnyTrack Account

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

2. Now click on the [KMA (KissMyAds) card](https://dashboard.anytrack.io/catalog/kma)and then Click on Install.

### Step #2: Connect your KMA (KissMyAds) account

1. Copy the predefined Postback URL
2. [Login](https://cabinet.kma.biz) to your affiliate account.
3. Navigate to: Tools >> Global Postback
4. Paste the postback URL
5. Save

### 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 `d3` & `click_id` data to affiliate links. Learn [more about AutoTag](/docs/autotag).
</Callout>

* **Default**: By default, AnyTrack automatically identifies and AutoTags KMA (KissMyAds) 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="kma"` or `rel="kma"`. More about [Tracking Group](/docs/tgid).
  * **Click ID Token:** You Manually append the `subid`: `&d3=--CLICK-ID--` to the offer link.

Once the links are set up, you can check in your KMA (KissMyAds) account reports and see whether the `d3` parameters are passed to the offer links.

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

```html
<a href="https://example.foo/goto/kma" data-tracking-group="kma">Hover on theKMA (KissMyAds) Demo   
Link to see the AnyTrack `click_id`</a>
```

<HTMLBlock html={"\n<a href=\"https://example.foo/goto/kma\" data-tracking-group=\"kma\">Hover on the KMA (KissMyAds) Demo Link to see the AnyTrack <code>click_id</code></a>\n"} />

> 📘 **Tracking**
>
> Tracking Group refers to the integration technology. For example, KMA (KissMyAds) <Glossary>Tracking Group</Glossary> tracking group is `kma` 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.

**KMA (KissMyAds) 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 KMA (KissMyAds) 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.  "
    }
  ]}
/>