API /sp/targets/bid/recommendations how to use PAT_CATEGORY_REFINEMENT type ?

[LionSniper]

when request body is :
{
"targetingExpressions": [
{
"type": "PAT_CATEGORY_REFINEMENT",
"value": ""
}
],
"campaignId": "ABC123",
"recommendationType": "BIDS_FOR_EXISTING_AD_GROUP",
"adGroupId": "CDE123"
}

When the type in targetingExpressions is PAT_CATEGORY_REFINEMENT, what should be filled in the value? and what the difference between PAT_CATEGORY_REFINEMENT and PAT_CATEGORY ?

I can not successfully test the case of PAT_CATEGORY_REFINEMENT, please give me an example, thanks！

[elizafarley]

Hi @LionSniper,

PAT_CATEGORY contains only a category ID, like:

"targetingExpression": {
   "type": "PAT_CATEGORY",
   "value": "123456"
}

PAT_CATEGORY_REFINEMENTS will return both the category, and possible refinements (like brand or price) in a single expression. Here's an example:

"targetingExpression": {
   "type": "PAT_CATEGORY_REFINEMENT",
   "value": "category=\"12456\" price=20-90"
}

Hope that helps!

[rajatanand86]

Hello
I am looking at how to get bid recommendaitons for each keyword, can someone please help here?

[Alekxys29]

Hi @elizafarley , I'm currently having some difficulty figuring out how to format these targetDetails for the PAT_CATEGORY_REFINEMENT bid recommendation:

{
    "productCategoryId": "12345678",
    "productCategoryResolved": "Disposable Forks",
    "productBrand": "12345678",
    "productBrandResolved": "BRAND NAME HERE",
    "productPriceGreaterThan": "5",
    "productRatingLessThan": "5",
    "productRatingGreaterThan": "1",
    "productPrimeShippingEligible": true
}

Could you please provide an example of the correct formatting for this? Thanks a lot!

[elizafarley]

Are you looking for the format that will be returned by the recommendations endpoints, or the format you would use in the request to the /sp/targets endpoint?

[Alekxys29]

@elizafarley

The format for the value that I will use in a request to /sp/targets/bid/recommendations, given the above values where type is PAT_CATEGORY_REFINEMENT.

[elizafarley]

Try this format:

{
"type": "PAT_CATEGORY_REFINEMENT",
"value": "category=\"12345\" brand=\"12345\" prime-shipping-eligible=\"true\" price=19.99-49.99 rating=4-5"
}