Synd Report API 매뉴얼

주의: 이 API는 등록된 IP 주소에서만 접근이 가능합니다. API 사용 전 반드시 담당자에게 IP 주소 등록을 요청해 주세요.

요청 URL (HTTP Method: GET)

http://media.photoda.kr/v3/provide/api/synd_report/?loginid=&begin_day=20250219&end_day=20250219

위 URL은 예시입니다. 실제 요청 시 파라미터 값을 적절히 변경하여 사용하세요.

요청 파라미터

파라미터	설명	예시	필수 여부
loginid	로그인 ID		필수
begin_day	조회 시작일	20250219	필수
end_day	조회 종료일	20250219	필수
pageid	페이지 ID	0Fjp	선택
campaignid	캠페인 ID	0Pjj	선택

응답 구조 (JSON)

{
    "result": {
        "request_limit": {
            "count": 1,
            "message": ""
        },
        "param": {
            "success": 1,
            "error": "",
            "loginid": "",
            "campaignid": null,
            "pageid": null,
            "begin_day": "20250219",
            "end_day": "20250219"
        },
        "data": [
            {
                "date": "20250219",
                "mediaid": "04xV",
                "medianame": "매체명",
                "pageid": "0Fjp",
                "pagename": "M_바이라인하단(300*250)",
                "campaignid": "0Pjj",
                "campaignname": "HNS_슬라이드SA_1차",
                "impr": 0,
                "click": 0,
                "ctr": 0,
                "revenue": 0
            },
            // ... 추가 데이터 항목
        ]
    }
}

응답 필드 설명

1. request_limit

필드	설명	타입	비고
count	현재 요청 횟수	Integer	1분 동안 요청 최대 횟수 : 60회
message	제한 관련 메시지	String	제한에 도달하면 경고 메시지 표시

2. param

필드	설명	타입	비고
success	요청 성공 여부	Integer	1: 성공, 0: 실패
error	에러 메시지	String	성공 시 빈 문자열
loginid	로그인 ID	String	요청에 사용된 로그인 ID
campaignid	캠페인 ID	String	요청 시 지정한 경우 해당 값, 미지정 시 null
pageid	페이지 ID	String	요청 시 지정한 경우 해당 값, 미지정 시 null
begin_day	조회 시작일	String	YYYYMMDD 형식
end_day	조회 종료일	String	YYYYMMDD 형식

3. data

필드	설명	타입	비고
date	데이터 날짜	String	YYYYMMDD 형식
mediaid	미디어 ID	String	매체 고유 식별자
medianame	미디어 이름	String
pageid	페이지 ID	String	지면 고유 식별자
pagename	페이지 이름	String
campaignid	캠페인 ID	String	캠페인 고유 식별자
campaignname	캠페인 이름	String
impr	노출 수	Integer	광고가 표시된 횟수
click	클릭 수	Integer	광고가 클릭된 횟수
ctr	클릭률 (Click-Through Rate)	Float	클릭 수 / 노출 수 * 100
revenue	정산	Integer	해당 날짜의 총 수익