Deal Buyer Setting service

Article
03/06/2024

The Deal Buyer Setting Service lets buyers give deals an internal alias for clarity in the UI and assign a status to deals so buyers have more control over which deals they’re targeting. Note that these deal settings are only available to the buyers who created them and are not visible to the seller of the deal.

Note

Buyers can use the Deal Buyer Access Saervice to view the deals available to them and the deal_targetsfield in the Profile Service to target them. Sellers can use the Deal Service to set up and manage deals.

REST API

HTTP Method	Endpoint	Description
`GET`	`https://api.appnexus.com/deal-buyer-setting`	View all of your deal settings.
`GET`	`https://api.appnexus.com/deal-buyer-setting?id=ID`	View a specific deal setting.
`GET`	`https://api.appnexus.com/deal-buyer-setting?deal_id=DEAL_ID`	View the settings for a specific deal.
`GET`	`https://api.appnexus.com/deal-buyer-setting?id=1,2,3`	View multiple deal settings by ID using a comma-separated list.
`GET`	`https://api.appnexus.com/deal-buyer-setting/meta`	Find out which fields you can filter and sort by.
`POST`	`https://api.appnexus.com/deal-buyer-setting`	Add settings for a deal.
`PUT`	`https://api.appnexus.com/deal-buyer-setting?id=ID`	Modify settings for a deal.

JSON fields

Field	Type	Description
`acceptance_status`	string	The status of the deal: - `active` - `inactive` - `declined` - `pending` Note: `pending` status is not allowed in a `PUT` request Default: The default for this field depends on the value of the `member.default_accept_deals` field (see Member Service). If `member.default_accept_deals` is `true`, the default for `acceptance_status` is `active`; if `member.default_accept_deals` is `false`, the default for `acceptance_status` is `pending`.
`buyer_bidder_id`	int	The bidder ID of the member. For buyers, this will always be `2`. Read Only Default: `null`
`buyer_member_id`	int	The ID of the member who can buy the deal. A deal will either be set up with a buyer member ID or a buyer seat code. This is your Xandr member ID. Read Only
`buyer_seat_code`	string	The code of the buyer seat who can buy the deal. A deal will either be set up with a buyer member ID or a buyer seat code. This is your Xandr member ID. Read Only Default: `null`
`comments`	string (65534)	Not yet being used by the UI. The custom comments to display in the UI for the deal. Default: `null`
`deal_id`	int	The ID of the deal to which the settings apply. Required On: `POST`
`deal_alias`	string (254)	The alias of the deal, as it will appear in the UI. Default: `null`
`id`	int	The ID of the deal settings Required On: `PUT` Default: auto-incremented number.

Examples

Add deal setting

If a deal-buyer-setting object has already been created for the deal, the POST request will return the following error message: "The buyer_member_id, deal_id combination was not unique." To modify this deal-buyer-setting, first make a GET https://api.appnexus.com/deal-buyer-setting?deal_id=DEAL_ID request to return the deal-buyer-setting ID. Then use the deal-buyer-setting ID with a PUT https://api.appnexus.com/deal-buyer-setting?id=ID request to modify the deal-buyer-setting.

$ cat deal_settings.json
 
{
    "deal-buyer-setting": {
        "deal_id": 22896,
        "deal_alias": "This is an alias",
        "comments": "this is a comment on a deal",
        "acceptance_status": "active"
    }
}

$ curl -b cookies -c cookies -X POST -d @deal_settings.json 'https://api.appnexus.com/deal-buyer-setting'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "12005",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-setting": {
            "id": 12005,
            "deal_id": 22896,
            "deal_alias": "This is an alias",
            "comments": "this is a comment on a deal",
            "buyer_member_id": 546,
            "acceptance_status": "active"
        }
    }
}

Modify deal settings

$ cat deal_settings_update.json
 
{
    "deal-buyer-setting": {
        "deal_alias": "new deal alias"
    }
}

$ curl -b cookies -c cookies -X PUT -d @deal_settings_update.json 'https://api.appnexus.com/deal-buyer-setting?id=11777'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "11777",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-setting": {
            "id": 11777,
            "deal_id": 560402,
            "deal_alias": "new deal alias",
            "comments": null,
            "buyer_member_id": 546,
            "acceptance_status": "active"
        }
    }
}

View all of your deal settings

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-setting'
 
{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-settings": [
            {
                "id": 9980,
                "deal_id": 558605,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            },
            {
                "id": 10950,
                "deal_id": 559575,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            },
            {
                "id": 11777,
                "deal_id": 560402,
                "deal_alias": "new deal alias",
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            }, 
            {
                "id": 1802,
                "deal_id": 550427,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            },
            {
                "id": 1937,
                "deal_id": 550562,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            }
        ]
    }
}

View the settings for a specific deal settings ID

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-setting?id=11777'

{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-settings": [
            {
                "id": 11777,
                "deal_id": 560402,
                "deal_alias": "new deal alias",
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            }
        ]
    }
}

View the settings for a specific deal ID

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-setting?deal_id=560402'

{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-settings": [
            {
                "id": 11777,
                "deal_id": 560402,
                "deal_alias": "new deal alias",
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            }
        ]
    }
}

View the settings for multiple deal IDs

$ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-setting?deal_id=560402,559575,558605'

{
    "response": {
        "status": "OK",
        "start_element": 0,
        "num_elements": 100,
        "deal-buyer-settings": [
            {
                "id": 9980,
                "deal_id": 558605,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            },
            {
                "id": 10950,
                "deal_id": 559575,
                "deal_alias": null,
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            },
            {
                "id": 11777,
                "deal_id": 560402,
                "deal_alias": "deal alias",
                "comments": null,
                "buyer_member_id": 546,
                "acceptance_status": "active"
            }
        ]
    }
}

Share via