Endpoint to update fields for a given campaign.
curl --request PATCH \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id} \
--header 'Content-Type: application/json' \
--data '{
"bannerAdRejectionReason": {
"declineReason": "<string>",
"reasonDetails": "<string>"
},
"budget": {
"amount": 1000,
"type": "daily"
},
"campaignType": "autobidding",
"endDate": "2023-11-07T05:31:56Z",
"externalCampaignId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"name": "Bola-Bola Ad campaign",
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 10.25
}'
{
"adFormat": "listing",
"bidCount": 123,
"budget": {
"amount": 1000,
"amountCarryover": 123,
"amountRemaining": 123,
"amountUsed": 123,
"type": "daily"
},
"campaignBehaviorData": "<string>",
"campaignBehaviorDataByDay": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"campaignType": "manual",
"chargeType": "CPM",
"createdAt": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"exclusivityPrice": 123,
"externalCampaignId": "<string>",
"externalVendorId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"marketplaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bola-Bola Ad campaign",
"promotionType": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"content": {},
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"jsonTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 123,
"vendorId": "<string>",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
The ID of the campaign.
Public Campaign Update Request Body
Successful Response
The campaign model.
curl --request PATCH \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id} \
--header 'Content-Type: application/json' \
--data '{
"bannerAdRejectionReason": {
"declineReason": "<string>",
"reasonDetails": "<string>"
},
"budget": {
"amount": 1000,
"type": "daily"
},
"campaignType": "autobidding",
"endDate": "2023-11-07T05:31:56Z",
"externalCampaignId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"name": "Bola-Bola Ad campaign",
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 10.25
}'
{
"adFormat": "listing",
"bidCount": 123,
"budget": {
"amount": 1000,
"amountCarryover": 123,
"amountRemaining": 123,
"amountUsed": 123,
"type": "daily"
},
"campaignBehaviorData": "<string>",
"campaignBehaviorDataByDay": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"campaignType": "manual",
"chargeType": "CPM",
"createdAt": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"exclusivityPrice": 123,
"externalCampaignId": "<string>",
"externalVendorId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"marketplaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bola-Bola Ad campaign",
"promotionType": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"content": {},
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"jsonTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 123,
"vendorId": "<string>",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
Endpoint to update fields for a given campaign.
curl --request PATCH \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id} \
--header 'Content-Type: application/json' \
--data '{
"bannerAdRejectionReason": {
"declineReason": "<string>",
"reasonDetails": "<string>"
},
"budget": {
"amount": 1000,
"type": "daily"
},
"campaignType": "autobidding",
"endDate": "2023-11-07T05:31:56Z",
"externalCampaignId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"name": "Bola-Bola Ad campaign",
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 10.25
}'
{
"adFormat": "listing",
"bidCount": 123,
"budget": {
"amount": 1000,
"amountCarryover": 123,
"amountRemaining": 123,
"amountUsed": 123,
"type": "daily"
},
"campaignBehaviorData": "<string>",
"campaignBehaviorDataByDay": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"campaignType": "manual",
"chargeType": "CPM",
"createdAt": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"exclusivityPrice": 123,
"externalCampaignId": "<string>",
"externalVendorId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"marketplaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bola-Bola Ad campaign",
"promotionType": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"content": {},
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"jsonTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 123,
"vendorId": "<string>",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
The ID of the campaign.
Public Campaign Update Request Body
Successful Response
The campaign model.
curl --request PATCH \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id} \
--header 'Content-Type: application/json' \
--data '{
"bannerAdRejectionReason": {
"declineReason": "<string>",
"reasonDetails": "<string>"
},
"budget": {
"amount": 1000,
"type": "daily"
},
"campaignType": "autobidding",
"endDate": "2023-11-07T05:31:56Z",
"externalCampaignId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"name": "Bola-Bola Ad campaign",
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 10.25
}'
{
"adFormat": "listing",
"bidCount": 123,
"budget": {
"amount": 1000,
"amountCarryover": 123,
"amountRemaining": 123,
"amountUsed": 123,
"type": "daily"
},
"campaignBehaviorData": "<string>",
"campaignBehaviorDataByDay": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"campaignType": "manual",
"chargeType": "CPM",
"createdAt": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"exclusivityPrice": 123,
"externalCampaignId": "<string>",
"externalVendorId": "<string>",
"isActive": true,
"isAutoTrigger": true,
"isSmart": true,
"marketplaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bola-Bola Ad campaign",
"promotionType": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"content": {},
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"jsonTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"startDate": "2023-11-07T05:31:56Z",
"status": "approved",
"statusUpdatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"targetRoas": 123,
"vendorId": "<string>",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}