Update a Conversion Rule

Submit a JSON object in a PUT or POST request body.
Fields that are omitted or null will not be updated.

📘

When updating a resource, you can use either PUT or POST.
You can submit only the fields of interest. Fields that are omitted or null, will remain unchanged.

EXAMPLES

Update a field

The JSON object in the request body represents the fields to update:

{  
    "display_name": "Updated Test Rule Name"
}

The response contains the updated Conversion Rule object:

{
   "id": 203,
   "display_name": "Updated Test Rule Name",
   "category": "ADD_TO_CART",
   "status": "ACTIVE",
   "type": "EVENT_BASED",
   "event_name": "add-to-cart",
   "condition": {
      "property": null,
      "predicate": null,
      "value": null,
      "children": []
   },
   "effects": [
      {
         "type": "REVENUE",
         "data": "15"
      }
   ],
   "include_in_total_conversions": true,
   "exclude_from_campaigns": false,
   "description": "abc",
   "advertiser_id": "taboola-demo-advertiser",
   "last_modified_by": "[email protected]",
   "audience_size": 12345
}

Archive a Conversion Rule

To archive a Conversion Rule, update it, and set the status to "ARCHIVED":

📘

Unlike other objects in the Taboola Backstage API, the Conversion Rule status field is not read-only.

{
   "status": "ARCHIVED"
}

The response contains the updated Conversion Rule object:

{
    "id": 203,
    "display_name": "Test Rule Name",
    "category": "ADD_TO_CART",
    "status": "ARCHIVED",
    "type": "EVENT_BASED",
    "event_name": "add-to-cart",
    "condition": {
        "property": null
        "predicate": "null",
        "value": "null",
        "children": [
            ]
    },
    "effects": [
        {
            "type": "REVENUE",
            "data": "15"
        }
    ],
    "description": "abc",
    "advertiser_id": "taboola-demo-advertiser",
    "last_modified_by": "[email protected]"
}

Unarchive a Conversion Rule

Similarly, to unarchive a Conversion Rule, update it, and set the status to "ACTIVE":

{
   "status": "ACTIVE"
}

As always, the response contains the updated Conversion Rule object:

{
    "id": 203,
    "display_name": "Test Rule Name",
    "category": "ADD_TO_CART",
    "status": "ACTIVE",
    "type": "EVENT_BASED",
    "event_name": "add-to-cart",
    "condition": {
        "property": null
        "predicate": "null",
        "value": "null",
        "children": [
            ]
    },
    "effects": [
        {
            "type": "REVENUE",
            "data": "15"
        }
    ],
    "description": "abc",
    "advertiser_id": "taboola-demo-advertiser",
    "last_modified_by": "[email protected]"
}
Language