Support Home > Analytics, Reports & API > 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:

  • Host: https://skad.api.kochava.com
    GET /v2/partner/kochava/model/apple-app-id/{apple_app_id}
  • 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:

  • curl -H 'Authentication-Key: {auth_key}' /
     https://skad.api.kochava.com/v2/partner/kochava/model/apple-app-id/{apple_app_id}
    
  • 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 —

  • Request

    curl -H 'Authentication-Key: <auth key> \ 
    https://skad.api.kochava.com/v2/partner/kochava/model/apple-app-id/123456789
    
  • Request

    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.

 

Track only that the install occurred.

  • {
      "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"
    }
  • {
      "max_measurement_window": 0,
      "conversion_model_name": "Install Only",
      "default_currency": "USD",
      "conversion_value_mapping": null,
      "last_updated": "2020-10-19T19:58:59Z"
    }
    

User performance is measured based on how much revenue the user generated within the measurement window.

  • {
      "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"
    }
  • {
      "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 performance is measured based on events completed by the user, regardless of order, within the measurement window.

  • {
      "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"
    }
  • {
      "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"
            }
          ]
        }
      ]
    }
    

User performance is measured based on the number of times the user completed the event(s) within the measurement window.

  • {
      "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"
    }
  • {
      "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
              }
            }
          ]
        }
      ]
    }
    

User performance is measured based on the highest value event completed by the user within the measurement window.

  • {
      "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"
    }
  • {
      "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
                ]
              }
            }
          ]
        }
      ]
    }
    

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
    }
  ]
}

 
 

Last Modified: Oct 11, 2023 at 7:30 am