---
updatedAt: 2026-06-08T03:35:06.000Z
agentTools:
  projectIndex: https://developer.moloco.cloud/llms.txt
---

# Read conversion value configuration from an integrated MMP.

Read conversion value configuration stored in the MMP that is integrated with the Product using the tracking company and bundle ID data from its postback integration data.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Moloco Ads Campaign Management API",
    "description": "Moloco Ads Campaign Management API provides functionalities for Moloco Ads Campaigns.",
    "version": "1.10",
    "contact": {
      "name": "Moloco Inc.",
      "url": "https://www.moloco.com"
    }
  },
  "paths": {
    "/cm/v1/products/{product_id}/mmp-skan-conversion-config": {
      "get": {
        "summary": "Read conversion value configuration from an integrated MMP.",
        "description": "Read conversion value configuration stored in the MMP that is integrated with the Product using the tracking company and bundle ID data from its postback integration data.",
        "operationId": "DspApi_ReadProductSKANConversionConfigFromMmp",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigFromMmpResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error. Detailed cause can be found in the `details` field.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigFromMmpError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "product_id",
            "description": "The ID of the Product to import SKAdNetwork conversion value configuration.\nThe type of product OS should be IOS.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Product"
        ]
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "servers": [
    {
      "url": "https://api.moloco.cloud"
    }
  ],
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "ConversionValueConfigurationItemConversionValueScheme": {
        "type": "string",
        "enum": [
          "UNKNOWN_CONVERSION_VALUE_SCHEME",
          "CONVERSION_VALUE_SCHEME_SINGLE_EVENT",
          "CONVERSION_VALUE_SCHEME_MULTIPLE_EVENTS",
          "CONVERSION_VALUE_SCHEME_CUSTOM_EVENTS",
          "CONVERSION_VALUE_SCHEME_SKAN_V4_EVENTS"
        ],
        "default": "UNKNOWN_CONVERSION_VALUE_SCHEME"
      },
      "ConversionValueConfigurationItemCvConfigurationAutoRefresh": {
        "type": "object",
        "properties": {
          "enable_auto_refresh": {
            "type": "boolean",
            "description": "Enables automatically importing the latest SKAdNetwork CV configuration\nfrom the integrated MMP and updating CV config items."
          },
          "refresh_result": {
            "$ref": "#/components/schemas/CvConfigurationAutoRefreshAutoRefreshResult",
            "description": "Result status of auto refresh.",
            "readOnly": true
          },
          "refresh_error_message": {
            "type": "string",
            "description": "Auto refresh error message in case the refresh request failed.",
            "readOnly": true
          },
          "last_auto_refreshed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the last auto SKAdNetwork CV configuration refresh occurred.",
            "readOnly": true
          }
        },
        "description": "Settings for automatically importing and updating SKAdNetwork conversion value configuration from MMP."
      },
      "ConversionValueConfigurationItemCvConfigurationForCustomEvents": {
        "type": "object",
        "properties": {
          "cv_events": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/CvConfigurationForCustomEventsEventList"
            },
            "description": "Information on relationships between conversion value and events for custom event scheme.\nThe key of this map is the registered conversion value between 1 to 63.\nThe value of this map is the list of events for each conversion value."
          }
        }
      },
      "ConversionValueConfigurationItemCvConfigurationForCustomEventsEventInfo": {
        "type": "object",
        "properties": {
          "event_name": {
            "type": "string",
            "description": "In-app event."
          },
          "event_value": {
            "type": "string",
            "description": "String set by the developer containing data to be decoded\nby the AdAccount in their systems.\nTypically this is in the format of a JSON."
          },
          "revenue_interval": {
            "$ref": "#/components/schemas/adcloudcommonFloatingPointRange",
            "description": "Optional. Revenue range for the event."
          },
          "predict_revenue_interval": {
            "$ref": "#/components/schemas/adcloudcommonFloatingPointRange",
            "title": "Optional. Revenue range for customer's predicted future spending.\nReference: https://mlc.atlassian.net/browse/MMP-166"
          },
          "event_counter": {
            "type": "integer",
            "format": "int32",
            "description": "Number of times the event is duplicated on decoding.\nTypically it represents the number of times the user performed a given action.\nMinimum value 1."
          },
          "hours_from_install": {
            "type": "integer",
            "format": "int32",
            "description": "Hours elapsed since the install. Minimum value: 1.\nThe value for all rows of a given conversion_value must be identical.\nMeaning different values for different conversion values is permitted."
          }
        },
        "title": "EventInfo holds data for decoding conversion value to events.\nReference: https://support.appsflyer.com/hc/en-us/articles/360014696297-Custom-conversion-value-decode-for-SKAdNetwork#decode-csv-file-specification",
        "required": [
          "event_name",
          "event_counter",
          "hours_from_install"
        ]
      },
      "ConversionValueConfigurationItemCvConfigurationForMultipleEvents": {
        "type": "object",
        "properties": {
          "cv_events": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Information on relationships between conversion value and event name for multiple events scheme.\nThe key of this map is the registered conversion value between 0 to 5.\nThe value of this map is the event name."
          }
        }
      },
      "ConversionValueConfigurationItemCvConfigurationForSingleEvent": {
        "type": "object",
        "properties": {
          "cv_revenue_events": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForSingleEventEventInfo"
            },
            "description": "Information on relationships between conversion value and (event name & revenue interval) for single event scheme.\nThe key of this map is the registered conversion value between 1 to 63.\nThe value of this map is a EventInfo message.\nEventInfo without revenue value should be unique.\nFor the same event name, conversion value should be consecutive.\nRange min value cannot be smaller than previous range's max value.\nAt least 4 Purchase Value should be registered for each event."
          }
        }
      },
      "ConversionValueConfigurationItemCvConfigurationForSingleEventEventInfo": {
        "type": "object",
        "properties": {
          "event_name": {
            "type": "string"
          },
          "revenue_interval": {
            "$ref": "#/components/schemas/adcloudcommonFloatingPointRange",
            "description": "Revenue value cannot be negative.\nRange min value cannot be larger than the range max value."
          }
        }
      },
      "ConversionValueConfigurationItemCvConfigurationForSkanV4Events": {
        "type": "object",
        "properties": {
          "postbacks": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/CvConfigurationForSkanV4EventsPostback"
            }
          }
        }
      },
      "CvConfigurationAutoRefreshAutoRefreshResult": {
        "type": "string",
        "enum": [
          "UNKNOWN",
          "OK",
          "ERROR"
        ],
        "default": "UNKNOWN"
      },
      "CvConfigurationForCustomEventsEventList": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForCustomEventsEventInfo"
            },
            "description": "events hold multiple EventInfo."
          }
        }
      },
      "CvConfigurationForSkanV4EventsPostback": {
        "type": "object",
        "properties": {
          "postback_sequence_index": {
            "type": "integer",
            "format": "int32"
          },
          "measurement_window": {
            "type": "integer",
            "format": "int32"
          },
          "coarse_grained_values": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/CvConfigurationForCustomEventsEventList"
            },
            "description": "Information on relationships between coarse-grained conversion value and its detailed events.\nThe possible keys of the map are low, medium or high."
          },
          "fine_grained_values": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/CvConfigurationForCustomEventsEventList"
            },
            "description": "Information on relationships between fine-grained conversion value and its detailed events.\nThe key of this map is the registered conversion value between 1 to 63."
          }
        }
      },
      "MmpIntegrationConversionValueConfigurationItem": {
        "type": "object",
        "properties": {
          "effective_date": {
            "type": "string",
            "description": "The start date of the CV configuration in the form of YYYY-MM-DD."
          },
          "scheme": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemConversionValueScheme",
            "description": "Scheme of CV configuration.\nThere are two types of scheme single event scheme and multiple events scheme."
          },
          "cv_single": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForSingleEvent"
          },
          "cv_multi": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForMultipleEvents"
          },
          "cv_custom": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForCustomEvents"
          },
          "cv_skan_v4": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationForSkanV4Events"
          },
          "auto_refresh": {
            "$ref": "#/components/schemas/ConversionValueConfigurationItemCvConfigurationAutoRefresh",
            "description": "Settings for SKAdNetwork conversion value configuration auto-refresh."
          }
        },
        "description": "Conversion value configuration.\nShow the valid item among the history in the storage entity.\n(Most recent item of which the effective date is not later than current date.)\nUse case in MCP: https://help.moloco.com/hc/en-us/articles/1500012981641-SKAdNetwork-Conversion-Value-Configuration- ."
      },
      "adcloudcommonFloatingPointRange": {
        "type": "object",
        "properties": {
          "start": {
            "type": "number",
            "format": "double"
          },
          "end": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "messagesReadProductSKANConversionConfigFromMmpError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigFromMmpErrorAPIErrorInfo"
            }
          }
        }
      },
      "messagesReadProductSKANConversionConfigFromMmpErrorAPIErrorInfo": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigFromMmpErrorAPIErrorInfoErrorReason"
          },
          "error_log_id": {
            "type": "string"
          },
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "messagesReadProductSKANConversionConfigFromMmpErrorAPIErrorInfoErrorReason": {
        "type": "string",
        "enum": [
          "ERROR_REASON_UNKNOWN"
        ],
        "default": "ERROR_REASON_UNKNOWN"
      },
      "messagesReadProductSKANConversionConfigFromMmpResponse": {
        "type": "object",
        "properties": {
          "skan_conversion_config": {
            "$ref": "#/components/schemas/MmpIntegrationConversionValueConfigurationItem"
          }
        }
      }
    }
  }
}
```