1.Campaign

请求说明
  • 该接口对大小写敏感,请求的地址及参数需要严格按照规定的大小;
  • 接口可查询自2021-01-01起的campaign维度数据。
URL
请求协议
  • HTTPS
请求类型
  • GET
请求参数
Parameters Tpye Requirement Default Expample desc
username string Y none username username
token string Y none 8f60c8102d29fcd 525162d02eed4566b md5(API_KEY.md5(time)) ex:md5(YM6L7FZ5KY1U16bCBMER+md5(1470499200))
timestamp int Y none 1569859200 Request unix timestamp
date_begin string Y none 2021-06-01 YYYY-MM-DD
date_end string Y none 2019-06-02 YYYY-MM-DD
media string Y none toutiao,tiktok,tencent,kuaishou,baidu_sem,baidu_feed,kwai 媒体名字
product string N none Simply Guitar_G2C NativeX Product Name

Token的生成

  • 在请求参数中传入 username, timestamp, token 来通过认证,token 由 API _KEY, 请求时间 timestamp 生成
  • 规则 md5(API_KEY.md5(time)) "." 为字符串连接符

上述所提到的 API_KEY 需要相关人员申请

限流

接口请求采用限流措施:限制每分钟最多20次请求

返回字段

Field Type Example Desc
code int 200 200 Success !=200 Fail
message string success the code message
data array '[...]' return Data

data字段

Field Type Example Desc
date string 2019-12-01 Date Time YYYY-MM-DD
media string tiktok Media Name
account_id string 1665030325122059 Account Id
campaign_id string 1675351064177726 Campaign Id
campaign_name string 单个12247_0_PL顾客买面包解说 Campaign Name
geo string CN Country Id
impression int 1234 Impression
click int 123 Click
media_conversion int 12 Conversion
platform string ios Os
media_spend float 22.86 Spend
product string Object Hunt_Global NativeX Product Name

json样例

{
    {
        "code": 200,
        "message": "success",
        "data": [
            {
                "media": "toutiao",
                "date": "2021-01-07",
                "account_id": "1665030325122059",
                "campaign_id": "1675351064177726",
                "campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615-RR20",
                "geo": "CN",
                "impression": 976,
                "click": 295,
                "media_conversion": 42,
                "media_spend": 11.02,
                "platform": "ios",
                "product": "Object Hunt_Global"
            },
            {
                "media": "toutiao",
                "date": "2021-01-07",
                "account_id": "1665030325122059",
                "campaign_id": "1677165183558701",
                "campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615",
                "geo": "CN",
                "impression": 1167,
                "click": 420,
                "media_conversion": 48,
                "media_spend": 13.23,
                "platform": "ios",
                "product": "Object Hunt_Global"
            },
            {
                "media": "toutiao",
                "date": "2021-01-07",
                "account_id": "1665030325122059",
                "campaign_id": "1677167816094755",
                "campaign_name": "单个_12247_0_PL_顾客买面包解说-pl0615-RR30+渠道-copy1",
                "geo": "CN",
                "impression": 854,
                "click": 312,
                "media_conversion": 35,
                "media_spend": 10.48,
                "platform": "ios",
                "product": "Object Hunt_Global"
            }
      }
}

results matching ""

    No results matching ""