Create Sponsored Brands Profile for Campaign
Note: The v1 endpoint is no longer supported and is now deprecated. Please use v2 for all usage.
Using v2 URL, you can create dual Sponsored Brands profiles for a campaign.
v2 URL: POST /api/v2/sba_profile
- First profile created will be enabled by default
- Second profile created will be disabled by default
- Any new profile will be created as “pending review” by default
- Only enabled profile will serve on a live campaign
- Only two profiles can be created at max per ad group
- If you create two profiles for an ad group then:
- Only 1 profile can be enabled at a time
- To disable an “enabled” profile, you need to enable the “disabled” profile
Query Parameters
| Parameter | Notes | Type | Required | Possible Values |
|---|---|---|---|---|
| campaignId | The ID of the campaign | integer | Y | A valid campaign ID |
| adGroupId | The ID of the ad group | integer | Y | A valid ad group ID |
| searchAmpName | The name of the Brand. This field should not be left empty. | string | Y | Name of the brand that is part of this profile. It should be max. 35 characters, all of which are NOT recommended to be special characters |
| headlineText | Custom headline text showcasing why customers should buy your products. This field is required. | string | Y | Piece of text that explains your brand value within following constraints:
|
| clickUrl | The destination URL or landing page URL. It is the website address that a visitor lands on when he/she clicks on the ad. This field is required. | string | Y | Clickable URL must be https://www.walmart.com URL that displays product(s) for the advertised brand. It can be either of:
clickUrl requirements:
Note: If requirements not met, the request will fail with encode issue. |
Sample Request 1
curl -X POST \
'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v2/sba_profile' \
--header 'Authorization: Bearer <auth_token>' \
--header 'WM_SEC.AUTH_SIGNATURE: ***********' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \
--header 'WM_CONSUMER.intimestamp: 1565309779'\
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--data '[
{ "campaignId": 12345, "adGroupId": 54321, "searchAmpName": "Great Value", "headlineText": "This is Great Value", "clickUrl": "https://www.walmart.com", }
]'Response
| Element | Description | Type |
|---|---|---|
| code | The response code can have following values: success, failure | string |
| details | Details of the error if value of response code is failure | string |
| sbaProfileId | ID of the Sponsored Brands profile | integer |
Sample Response
[ { "code": "success", "details": "", " sbaProfileId ": 600001 }, { "code": "failure", "details": "error message", " sbaProfileId ": 0 }
]Updated 22 days ago