Sign in
Ad Conversion Value Rules

Retrieve a conversion value rule

get/ad_conversion_value_rules/{id}

Response

Rule

account_idstring required

Business that owns this shared, editable rule.

adjustment_type'fixed' | 'percentage' required

Set a fixed amount or change the original value by a signed percentage.

created_atstring required

When the rule was created, as an ISO 8601 timestamp.

idstring required

Conversion value rule ID, prefixed adcvr_.

metadataobject required

Free-form string keys and values for the caller.

percentage_changenumber nullable required

Signed percent change: 20 increases by 20%, negative 20 decreases by 20%. The sent value cannot go below zero. Null for a fixed rule.

status'active' | 'paused' required

Whether this rule is active or paused.

updated_atstring required

When the rule was edited, as an ISO 8601 timestamp.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "adjustment_type": "fixed",
  "created_at": "2026-01-01T12:00:00.000Z",
  "events": [
    {
      "event_name": "lead"
    }
  ],
  "fixed_value": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "id": "adcvr_xxxxxxxxxxxxxx",
  "metadata": {},
  "status": "active",
  "targets": [
    {
      "platform": "meta",
      "resource_title": "Shine Time Auto Detailing",
      "scope": "business"
    }
  ],
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes