GoogleAdsGoogleadsV25Services__GenerateConversionRatesResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-generate-conversion-rates-response-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__GenerateConversionRatesResponse",
  "description": "Response message for ReachPlanService.GenerateConversionRates, containing conversion rate suggestions for supported plannable products.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-v25-generateconversionrates-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__GenerateConversionRatesResponse",
  "type": "object",
  "properties": {
    "conversionRateSuggestions": {
      "description": "A list containing conversion rate suggestions. Each repeated element will have an associated product code. Multiple suggestions may share the same product code.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__ConversionRateSuggestion"
      },
      "type": "array"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Services__ConversionRateSuggestion": {
      "type": "object",
      "properties": {
        "conversionRateModel": {
          "description": "Model type used to calculate the suggested conversion rate.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "The value is unknown in this version.",
            "Suggested conversion rate for the authenticated customer based on the previous 70 days.",
            "Suggested conversion rate based on an aggressive rate for the entire inventory.",
            "Suggested conversion rate based on a conservative rate for the entire inventory.",
            "Suggested conversion rate based on the median rate for the entire inventory."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "CUSTOMER_HISTORY",
            "INVENTORY_AGGRESSIVE",
            "INVENTORY_CONSERVATIVE",
            "INVENTORY_MEDIAN"
          ]
        },
        "surfaceTargeting": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__SurfaceTargeting",
          "description": "The surfaces associated with the plannable product. If not present, the conversion rate is considered surface agnostic for this product."
        },
        "conversionRate": {
          "description": "The suggested conversion rate. The value is between 0 and 1 (exclusive).",
          "type": "number",
          "format": "double"
        },
        "plannableProductCode": {
          "type": "string",
          "description": "The code associated with the plannable product (for example: DEMAND_GEN). To list all plannable product codes, use ReachPlanService.ListPlannableProducts."
        }
      },
      "description": "A conversion rate suggestion."
    },
    "GoogleAdsGoogleadsV25Services__SurfaceTargeting": {
      "type": "object",
      "properties": {
        "surfaces": {
          "type": "array",
          "description": "List of surfaces available to target.",
          "items": {
            "type": "string",
            "x-enumDescriptions": [
              "Not specified.",
              "The value is unknown in this version.",
              "Discover feed ad surface.",
              "Gmail ad surface.",
              "In-Feed ad surface.",
              "In-Stream bumper ad surface.",
              "In-Stream non-skippable ad surface.",
              "In-Stream skippable ad surface.",
              "Shorts ad surface.",
              "Google Display Network ad surface.",
              "In-Stream non-skippable (30 seconds) ad surface."
            ],
            "enum": [
              "UNSPECIFIED",
              "UNKNOWN",
              "DISCOVER_FEED",
              "GMAIL",
              "IN_FEED",
              "IN_STREAM_BUMPER",
              "IN_STREAM_NON_SKIPPABLE",
              "IN_STREAM_SKIPPABLE",
              "SHORTS",
              "GOOGLE_DISPLAY_NETWORK",
              "IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS"
            ]
          }
        }
      },
      "description": "Container for surfaces for a product. Surfaces refer to the available types of ad inventories such as In-Feed, In-Stream, and Shorts."
    }
  }
}