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

# Read conversion value configurations.

Read conversion value configurations under an existing Product.

# 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}/skan-conversion-config": {
      "get": {
        "summary": "Read conversion value configurations.",
        "description": "Read conversion value configurations under an existing Product.",
        "operationId": "DspApi_ReadProductSKANConversionConfig",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error. Detailed cause can be found in the `details` field.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "product_id",
            "description": "The ID of the Product related to the MMPI which will be updated.",
            "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"
          }
        }
      },
      "messagesReadProductSKANConversionConfigError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigErrorAPIErrorInfo"
            }
          }
        }
      },
      "messagesReadProductSKANConversionConfigErrorAPIErrorInfo": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/messagesReadProductSKANConversionConfigErrorAPIErrorInfoErrorReason"
          },
          "error_log_id": {
            "type": "string"
          },
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "messagesReadProductSKANConversionConfigErrorAPIErrorInfoErrorReason": {
        "type": "string",
        "enum": [
          "ERROR_REASON_UNKNOWN"
        ],
        "default": "ERROR_REASON_UNKNOWN"
      },
      "messagesReadProductSKANConversionConfigResponse": {
        "type": "object",
        "properties": {
          "skan_conversion_config": {
            "$ref": "#/components/schemas/MmpIntegrationConversionValueConfigurationItem"
          }
        }
      }
    }
  }
}
```