查询TikTok - 推广广告 - 广告组
POST
/basicOpen/multiplatform/ads/queryTiktokAdGroupList接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/multiplatform/ads/queryTiktokAdGroupList | HTTPS | POST | 1 |
请求参数
endDatestringlengthintegerpageintegerstartDatestringadvertiserIdsarray<any>bidStrategiesarray<any>budgetTypesarray<any>campaignIdsarray<any>currenciesarray<any>objectiveTypearray<any>orderFieldstringorderTypestringownerBcIdsarray<any>searchTypestringsearchValuearray<any>serviceStatusarray<any>statusarray<any>summaryCurrencystring请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryTiktokAdGroupList?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"endDate": "2024-11-12",
"length": 20,
"page": 1,
"startDate": "2024-11-01",
"advertiserIds": [123456789012345],
"bidStrategies": ["BID_TYPE_CUSTOM"],
"budgetTypes": ["BUDGET_MODE_DAY"],
"campaignIds": [123456789012345,987654321098765],
"currencies": ["USD","CNY"],
"objectiveType": ["PRODUCT_SALES","WEB_CONVERSIONS"],
"orderField": "spend",
"orderType": "DESC",
"ownerBcIds": [123456,789012],
"searchType": "ad_group_name",
"searchValue": ["\u6d4b\u8bd5\u5e7f\u544a\u7ec4"],
"serviceStatus": ["ACTIVE"],
"status": ["STATUS_ENABLE","STATUS_DISABLE"],
"summaryCurrency": "USD"
}'返回结果
Json Object
codeinteger必填dataobject必填隐藏子属性
listarray<object>必填隐藏子属性
adGroupIdstringadGroupNamestringadvertiserIdstringadvertiserNamestringattributionEventCountstringaverageVideoPlaystringaverageVideoPlayPerUserstringbidstringbidDisplayModestringbidModestringbidStrategystringbilledCoststringbillingEventstringbudgetstringbudgetTypestringcampaignIdstringcampaignNamestringcashSpendintegerclickAttributionWindowstringclicksintegercnyBilledCostnumbercnyCashSpendnumbercnyCostPerOnsiteInitiateCheckoutCountnumbercnyCostPerOnsiteOnWebCartnumbercnyCostPerOnsiteOnWebDetailnumbercnyCostPerOnsiteShoppingnumbercnySpendnumbercnyTotalOnsiteShoppingValuenumbercompanyIdstringconversionintegerconversionRatestringcostPer1000ReachedstringcostPerConversionstringcostPerOnsiteInitiateCheckoutCountstringcostPerOnsiteOnWebCartstringcostPerOnsiteOnWebDetailstringcostPerOnsiteShoppingstringcostPerResultstringcpcstringcpmstringcreateTimestringctrstringcurrencystringdisplayTimezonestringengagedViewintegerengagedView15sintegerfrequencyintegergmtOffsetstringgrossImpressionsintegeridstringimpressionsintegerinvestEndTimestringinvestStartTimestringliveEffectiveViewsintegerliveProductClicksintegerliveUniqueViewsintegerliveViewsintegermetricsCnyRateMissingCountintegermodifyTimestringobjectiveTypestringonsiteInitiateCheckoutCountintegeronsiteInitiateCheckoutCountRatestringonsiteOnWebCartintegeronsiteOnWebCartRatestringonsiteOnWebDetailintegeronsiteOnWebDetailRatestringonsiteShoppingintegeronsiteShoppingRatestringonsiteShoppingRoasstringownerBcIdstringownerBcNamestringpacingstringproductSourcestringreachintegerrealTimeConversionintegerrealTimeConversionRateV2stringrealTimeCostPerConversionstringrealTimeCostPerResultstringrealTimeResultintegerreportDatestringreportUpdateTimestringresultintegerresultRatestringscheduledBudgetstringserviceStatusstringshoppingAdsTypestringspendstringsplitTestStatusstringstatusstringtotalOnsiteInitiateCheckoutCountValuestringtotalOnsiteOnWebCartValuestringtotalOnsiteOnWebDetailValuestringtotalOnsiteShoppingValuestringvaluePerOnsiteInitiateCheckoutCountstringvaluePerOnsiteOnWebCartstringvaluePerOnsiteOnWebDetailstringvaluePerOnsiteShoppingstringvideoCompletionRatestringvideoPlayActionsintegervideoViews2sRatestringvideoViews6sRatestringvideoViewsP100integervideoViewsP25integervideoViewsP25RatestringvideoViewsP50integervideoViewsP50RatestringvideoViewsP75integervideoViewsP75RatestringvideoWatched2sintegervideoWatched6sintegerviewAttributionWindowstringtotalinteger必填error_detailsarray<any>必填messagestring必填request_idstring必填response_timestring必填totalinteger必填返回成功示例
{
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
"response_time": "2024-11-12 16:00:00",
"data": {
"list": [
],
"total": 100
},
"total": 1
}