1. Home
  2. Marketers
  3. Advanced Tools
  4. SKAdNetwork Conversion Model API
  1. Home
  2. Marketers
  3. SKAdNetwork Conversion Model API

SKAdNetwork Conversion Model API

Get Conversion Value Mapping

The Conversion Model Pull API allows for retrieving an app’s conversion model and SKAdNetwork conversion value mappings.

Request:

v4.0+

Host: https://skad.api.kochava.com
GET /v2/partner/kochava/model/apple-app-id/{apple_app_id}

Legacy

Host: https://skad.api.kochava.com
GET /v1/partner/kochava/model/apple-app-id/{apple_app_id}

Headers:

  • Authentication-Key: set to authentication key provided by Kochava

Example —

v4.0+
curl -H 'Authentication-Key: {auth_key}' /
 https://skad.api.kochava.com/v2/partner/kochava/model/apple-app-id/{apple_app_id}
Legacy
curl -H 'Authentication-Key: {auth_key}' /
 https://skad.api.kochava.com/v1/partner/kochava/model/apple-app-id/{apple_app_id}
  • {auth_key} – replace with your authentication key
  • {apple_app_id} – replace with the numerical Apple App ID (the ID of the app listed on the App Store)

Response:

All responses will be in JSON format.

API Access —

  • Access to a given app’s conversion model requires that the target app have a postback triggered configured for the media partner attempting to access the model via this API and that the media partner is registered as a Kochava SKAdNetwork-integrated partner.
  • The authentication key should be requested from our integrations team via integrations@kochava.com.

Response Examples —

v4.0+
curl -H 'Authentication-Key: <auth key> \ 
https://skad.api.kochava.com/v2/partner/kochava/model/apple-app-id/123456789
Legacy
curl -H 'Authentication-Key: <auth key> \ 
https://skad.api.kochava.com/v1/partner/kochava/model/apple-app-id/123456789

NOTE: Only the first 10 conversion values are shown for brevity.

Install Only: Track only that the install occurred.
v4.0+
{
  "apple_app_id": 987654321,
  "max_measurement_window": 0,
  "conversion_model_name": "Install Only",
  "default_currency": "USD",
  "model_source": "Kochava SDK",
  "conversion_value_mapping": null,
  "last_updated": "2023-04-21T19:12:48Z"
}
Legacy
{ 
"max_measurement_window": 0, 
"conversion_model_name": "Install Only", 
"default_currency": "USD", 
"conversion_value_mapping": null, 
"last_updated": "2020-10-19T19:58:59Z" 
}
Revenue: User performance is measured based on how much revenue the user generated within the measurement window.
v4.0+
{
  "apple_app_id": 987654321,
  "max_measurement_window": 518400,
  "conversion_model_name": "Revenue",
  "default_currency": "USD",
  "model_source": "Kochava SDK",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": ""
    },
    {
      "conversion_value": 0,
      "description": "$0",
      "measurement_window": 0,
      "min": "0",
      "max": "0",
      "revenue": {
        "coarse_value": "low",
        "min": "0",
        "max": "0"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 1,
      "description": "$0-0.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "0",
      "max": "0.99",
      "revenue": {
        "coarse_value": "low",
        "min": "0",
        "max": "0.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 2,
      "description": "$1-1.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "1",
      "max": "1.99",
      "revenue": {
        "coarse_value": "low",
        "min": "1",
        "max": "1.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 3,
      "description": "$2-2.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "2",
      "max": "2.99",
      "revenue": {
        "coarse_value": "low",
        "min": "2",
        "max": "2.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 4,
      "description": "$3-3.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "3",
      "max": "3.99",
      "revenue": {
        "coarse_value": "medium",
        "min": "3",
        "max": "3.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 5,
      "description": "$4-4.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "4",
      "max": "4.99",
      "revenue": {
        "coarse_value": "medium",
        "min": "4",
        "max": "4.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 6,
      "description": "$5-5.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "5",
      "max": "5.99",
      "revenue": {
        "coarse_value": "high",
        "min": "5",
        "max": "5.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 7,
      "description": ">=$6",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "6",
      "revenue": {
        "coarse_value": "high",
        "min": "6"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 8,
      "description": "$0",
      "measurement_window": 1,
      "min": "0",
      "max": "0",
      "revenue": {
        "coarse_value": "low",
        "min": "0",
        "max": "0"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 9,
      "description": "$0-0.99",
      "measurement_window": 1,
      "events": [
        {
          "name": "Purchase"
        }
      ],
      "partner_events": [
        {
          "name": "Purchase"
        }
      ],
      "min": "0",
      "max": "0.99",
      "revenue": {
        "coarse_value": "low",
        "min": "0",
        "max": "0.99"
      },
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
  ],
  "last_updated": "2023-04-21T17:35:25Z"
}
Legacy
{
  "max_measurement_window": 432000,
  "conversion_model_name": "Revenue",
  "default_currency": "USD",
  "last_updated": "2020-10-19T19:56:40Z",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": "$0",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 0,
      "description": "$0",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 1,
      "description": "$0-4.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 2,
      "description": "$5-9.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 3,
      "description": "$10-14.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 4,
      "description": "$15-19.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 5,
      "description": "$20-24.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 6,
      "description": "$25-29.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 7,
      "description": "$30-34.99",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 8,
      "description": "$0",
      "measurement_window": 1,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 9,
      "description": "$0-4.99",
      "measurement_window": 1,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 10,
      "description": "$5-9.99",
      "measurement_window": 1,
      "events": [
        {
          "name": "Purchase"
        },
        {
          "name": "Donate",
          "filters": {
            "foo": [
              "bar",
              "baz"
            ]
          }
        },
        {
          "name": "My Custom Event"
        }
      ]
    }
  ]
}
User Journey: User performance is measured based on events completed by the user, regardless of order, within the measurement window.
v4.0+
{
  "apple_app_id": 987654321,
  "max_measurement_window": 518400,
  "conversion_model_name": "User Journey",
  "default_currency": "USD",
  "model_source": "Kochava SDK",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": ""
    },
    {
      "conversion_value": 0,
      "description": "",
      "measurement_window": 0,
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 1,
      "description": "Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 2,
      "description": "Event 2",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 2",
          "coarse_value": "medium"
        }
      ],
      "partner_events": [
        {
          "name": "Event 2",
          "coarse_value": "medium"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 3,
      "description": "Event 1, Event 2",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 2",
          "coarse_value": "medium"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 2",
          "coarse_value": "medium"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 4,
      "description": "Event 3",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 5,
      "description": "Event 1, Event 3",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 6,
      "description": "Event 2, Event 3",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 2",
          "coarse_value": "medium"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 2",
          "coarse_value": "medium"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 7,
      "description": "Event 1, Event 2, Event 3",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 2",
          "coarse_value": "medium"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        },
        {
          "name": "Event 2",
          "coarse_value": "medium"
        },
        {
          "name": "Event 3",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 8,
      "description": "",
      "measurement_window": 1,
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 9,
      "description": "Event 1",
      "measurement_window": 1,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
  ],
  "last_updated": "2023-04-21T17:36:20Z"
}
Legacy
{
  "max_measurement_window": 432000,
  "conversion_model_name": "User Journey",
  "default_currency": "USD",
  "last_updated": "2020-10-19T19:49:54Z",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": "_Install",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 0,
      "description": "_Install",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 1,
      "description": "_Install, Purchase",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 2,
      "description": "_Install, My Custom Event",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 3,
      "description": "_Install, Purchase, My Custom Event",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Purchase"
        },
        {
          "name": "My Custom Event"
        }
      ]
    },
    {
      "conversion_value": 4,
      "description": "_Install, Checkout",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Checkout"
        }
      ]
    },
    {
      "conversion_value": 5,
      "description": "_Install, Purchase, Checkout",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Purchase"
        },
        {
          "name": "Checkout"
        }
      ]
    },
    {
      "conversion_value": 6,
      "description": "_Install, My Custom Event, Checkout",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "My Custom Event"
        },
        {
          "name": "Checkout"
        }
      ]
    },
    {
      "conversion_value": 7,
      "description": "_Install, Purchase, My Custom Event, Checkout",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Purchase"
        },
        {
          "name": "My Custom Event"
        },
        {
          "name": "Checkout"
        }
      ]
    },
    {
      "conversion_value": 8,
      "description": "_Install",
      "measurement_window": 1,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 9,
      "description": "_Install, Purchase",
      "measurement_window": 1,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 10,
      "description": "_Install, My Custom Event",
      "measurement_window": 1,
      "events": [
        {
          "name": "_Install"
        },
        {
          "name": "My Custom Event"
        }
      ]
    }
  ]
}
Engagement: User performance is measured based on the number of times the user completed the event(s) within the measurement window.
v4.0+
{
  "apple_app_id": 987654321,
  "max_measurement_window": 518400,
  "conversion_model_name": "Engagement",
  "default_currency": "USD",
  "model_source": "Kochava SDK",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": ""
    },
    {
      "conversion_value": 0,
      "description": "0x",
      "measurement_window": 0,
      "engagement_count": 0,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 1,
      "description": "1x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 1,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 2,
      "description": "2x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 2,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 3,
      "description": "3x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 3,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 4,
      "description": "4x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 4,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 5,
      "description": "5x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 5,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 6,
      "description": "6x, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 6,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 7,
      "description": "7x+, Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 7,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 8,
      "description": "0x",
      "measurement_window": 1,
      "engagement_count": 0,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
    {
      "conversion_value": 9,
      "description": "1x, Event 1",
      "measurement_window": 1,
      "events": [
        {
          "name": "Event 1"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1"
        }
      ],
      "engagement_count": 1,
      "event_occurrence": {
        "high": 10,
        "low": 0,
        "medium": 5
      }
    },
  ],
  "last_updated": "2023-04-21T17:37:10Z"
}
Legacy
{
  "max_measurement_window": 432000,
  "conversion_model_name": "Engagement",
  "default_currency": "USD",
  "last_updated": "2020-10-19T19:54:08Z",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": "0x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open"
        }
      ]
    },
    {
      "conversion_value": 0,
      "description": "0x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 0
          }
        }
      ]
    },
    {
      "conversion_value": 1,
      "description": "1x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 1
          }
        }
      ]
    },
    {
      "conversion_value": 2,
      "description": "2x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 2
          }
        }
      ]
    },
    {
      "conversion_value": 3,
      "description": "3x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 3
          }
        }
      ]
    },
    {
      "conversion_value": 4,
      "description": "4x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 4
          }
        }
      ]
    },
    {
      "conversion_value": 5,
      "description": "5x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 5
          }
        }
      ]
    },
    {
      "conversion_value": 6,
      "description": "6x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 6
          }
        }
      ]
    },
    {
      "conversion_value": 7,
      "description": "7x, Add to Wishlist",
      "measurement_window": 0,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 7
          }
        }
      ]
    },
    {
      "conversion_value": 8,
      "description": "0x, Add to Wishlist",
      "measurement_window": 1,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 8
          }
        }
      ]
    },
    {
      "conversion_value": 9,
      "description": "1x, Add to Wishlist",
      "measurement_window": 1,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 9
          }
        }
      ]
    },
    {
      "conversion_value": 10,
      "description": "2x, Add to Wishlist",
      "measurement_window": 1,
      "events": [
        {
          "name": "App Open",
          "meta": {
            "count": 10
          }
        }
      ]
    }
  ]
}
Highest Value Event: User performance is measured based on the highest value event completed by the user within the measurement window.
v4.0+
{
  "apple_app_id": 987654321,
  "max_measurement_window": 518400,
  "conversion_model_name": "Highest Event",
  "default_currency": "USD",
  "model_source": "Kochava SDK",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": ""
    },
    {
      "conversion_value": 0,
      "description": "",
      "measurement_window": 0,
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 1,
      "description": "Event 1",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 2,
      "description": "Event 2",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 2",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 2",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 3,
      "description": "Event 3",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 3",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 3",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 4,
      "description": "Event 4",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 4",
          "coarse_value": "medium"
        }
      ],
      "partner_events": [
        {
          "name": "Event 4",
          "coarse_value": "medium"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 5,
      "description": "Event 5",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 5",
          "coarse_value": "medium"
        }
      ],
      "partner_events": [
        {
          "name": "Event 5",
          "coarse_value": "medium"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 6,
      "description": "Event 6",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 6",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 6",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 7,
      "description": "Event 7",
      "measurement_window": 0,
      "events": [
        {
          "name": "Event 7",
          "coarse_value": "high"
        }
      ],
      "partner_events": [
        {
          "name": "Event 7",
          "coarse_value": "high"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 8,
      "description": "",
      "measurement_window": 1,
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
    {
      "conversion_value": 9,
      "description": "Event 1",
      "measurement_window": 1,
      "events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "partner_events": [
        {
          "name": "Event 1",
          "coarse_value": "low"
        }
      ],
      "locking_window": {
        "maximum_conversion_value": false,
        "event": ""
      }
    },
  ],
  "last_updated": "2023-04-21T17:33:46Z"
}
Legacy
{
  "max_measurement_window": 432000,
  "conversion_model_name": "Highest Event",
  "default_currency": "USD",
  "last_updated": "2020-10-19T19:56:01Z",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": "_Install",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 0,
      "description": "_Install",
      "measurement_window": 0,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 1,
      "description": "Registration",
      "measurement_window": 0,
      "events": [
        {
          "name": "Registration"
        }
      ]
    },
    {
      "conversion_value": 2,
      "description": "Level Complete",
      "measurement_window": 0,
      "events": [
        {
          "name": "Level Complete",
          "filters": {
            "id": [
              1
            ]
          }
        }
      ]
    },
    {
      "conversion_value": 3,
      "description": "Level Complete",
      "measurement_window": 0,
      "events": [
        {
          "name": "Level Complete",
          "filters": {
            "id": [
              5
            ]
          }
        }
      ]
    },
    {
      "conversion_value": 4,
      "description": "Purchase",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 5,
      "description": "Purchase",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 6,
      "description": "Purchase",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 7,
      "description": "Purchase",
      "measurement_window": 0,
      "events": [
        {
          "name": "Purchase"
        }
      ]
    },
    {
      "conversion_value": 8,
      "description": "_Install",
      "measurement_window": 1,
      "events": [
        {
          "name": "_Install"
        }
      ]
    },
    {
      "conversion_value": 9,
      "description": "Registration",
      "measurement_window": 1,
      "events": [
        {
          "name": "Registration"
        }
      ]
    },
    {
      "conversion_value": 10,
      "description": "Level Complete",
      "measurement_window": 1,
      "events": [
        {
          "name": "Level Complete",
          "filters": {
            "id": [
              1
            ]
          }
        }
      ]
    }
  ]
}
Custom: Tracks conversion value meanings for models not created or tracked by the Kochava SDK, such as a server to server field.
{
  "conversion_model_name": "[Custom] My Custom Model",
  "default_currency": "USD",
  "last_updated": "2020-10-19T19:57:33Z",
  "conversion_value_mapping": [
    {
      "conversion_value": null,
      "description": "5 value",
      "measurement_window": 5
    },
    {
      "conversion_value": 0,
      "description": "0 value",
      "measurement_window": 0
    },
    {
      "conversion_value": 1,
      "description": "1 value",
      "measurement_window": 1
    },
    {
      "conversion_value": 2,
      "description": "2 value",
      "measurement_window": 2
    },
    {
      "conversion_value": 3,
      "description": "3 value",
      "measurement_window": 3
    },
    {
      "conversion_value": 4,
      "description": "4 value",
      "measurement_window": 4
    },
    {
      "conversion_value": 63,
      "description": "63 value",
      "measurement_window": 63
    }
  ]
}
Updated on December 27, 2024

Was this article helpful?