Ads and Commerce

Product Catalog Marketplace Partner Signals

Updated: Mar 5, 2026

Reading

You can’t perform this operation on this endpoint.

Creating

You can't perform this operation on this endpoint.

Updating

/{product_catalog_id}/marketplace_partner_signals

You can update a ProductCatalog by making a POST request to /{product_catalog_id}/marketplace_partner_signals.

Parameters

Parameter Description
conversion_type
enum {ATTRIBUTED, IN_SESSION}
conversion_type
Identifier on whether the specified event happened within the original session of the user landing on the partner's page (IN_SESSION) or within the attribution window after the initial session (ATTRIBUTED)
event_id
string
event_id
Unique identifier for conversion events. If there are multiple conversion events tied to a single mp_clid, this field will be used to differentiate between those events
event_name
enum {PURCHASE, ADD_TO_CART, VIEW_ITEM, OFFER_SUBMITTED, PURCHASE_VIA_OFFER, TEST}
event_name
TEST events can be used to send test data to confirm API functionality that Marketplace will ignore
required
event_source_url
string
event_source_url
event_time
datetime/timestamp
event_time
required
offer_data
JSON object
offer_data

original_price float
original_price
required
offer_price float
offer_price
required
currency string
currency
required
Show child parameters
order_data
JSON object
order_data

order_details array<JSON object>
Default value: []
order_details

item_price float
item_price
required
item_quantity int64
item_quantity
required
item_id string
item_id
required
Show child parameters
currency string
currency
required
order_total float
order_total
required
Show child parameters
user_data
JSON object
user_data
required

mp_clid string
mp_clid
required
Show child parameters

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.
Struct  {
success: bool,
validation_status:  List  [ Struct  {
errors:  List  [ Struct  {
message: string,
}],
warnings:  List  [ Struct  {
message: string,
}],
}],
}

Error Codes

Error Code Description
100
Invalid parameter

Deleting

You can't perform this operation on this endpoint.