광고주

캠페인을 집행한 광고주용 API 입니다. 담당자를 통해 광고주 계정과 API Key를 발급해주세요.

도메인 및 API Key는 별도로 제공됩니다.

캠페인 집행 담당자에게 문의해주세요.

리스트 타입

리스트명

ListType

캠페인 리스트

광고그룹 리스트

광고물 리스트

에러코드

코드

설명

000

성공

001

시스템에 에러가 발생했습니다.

002

알 수 없는 오류가 발생했습니다.

003

조회 권한이 없습니다.

004

존재하지 않는 API 입니다.

005

Parameter 정보가 잘못되었습니다.

006

날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.

전체 캠페인 목록

Request URL

URL

Method

/S-Plus_api/getCampaignListAll.xml

Get

/S-Plus_api/getCampaignListAll.json

Get

Request Parameters

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

adver

권한

sDate

Integer

20160101

캠페인 시작 일자

eDate

Integer

20160131

캠페인 종료 일자

Response Fields

이름

타입

코드 예시

설명

AllCam_Count

Integer

100

반환되는 리스트 행 수

AllCampaigns.AllCampaign

AllCam_No

Integer

12345

캠페인ID

AllCam_Status

String

0: 준비 1: 진행 2: 중지 3: 완료 4: 삭제

AllCam_Name

String

메조_테스트캠페인

캠페인명

AllCam_sDate

String

2016-01-01 00:00

캠페인 시작일

AllCam_eDate

String

2016-01-01 00:00

캠페인 종료일

AllCam_Imp

Integer

1000

노출

AllCam_ImpP

Integer

1000

노출+

AllCam_Click

Integer

1000

클릭

AllCam_CTR

Integer

1000

노출 대비 클릭

AllCam_CTRP

Integer

1000

노출+ 대비 클릭

AllCam_CV

Integer

1000

전환 수

AllCam_CVR

Integer

1000

클릭 대비 전환율(%)

Response Sample

<?xml version="1.0" encoding="utf-8" ?>
<message>
     <error>
           <code>000</code>
           <message>성공</message>
     </error>
        <result>
                <AllCamCount>10</AllCamCount> 
                <AllCampaigns>
                        <AllCampain>
                                <AllCam_No>1234</AllCam_No>
                                <AllCam_Status>1</AllCam_Status>
                                <AllCam_Name>메조_테스트캠페인</AllCam_Name>
                                <AllCam_sDate> 2016-01-01 00:00</AllCam_sDate>
                                <AllCam_eDate> 2016-01-01 00:00 </AllCam_eDate>
                                <AllCam_Imp> 1000 </AllCam_Imp>
                                <AllCam_ImpP> 1000 </AllCam_ImpP>
                                <AllCam_Click> 1000 </AllCam_Click>
                                <AllCam_CTR> 1000 </AllCam_CTR>
                                <AllCam_CTRP> 1000 </AllCam_CTRP>
                                <AllCam_CV> 1000 </AllCam_CV>
                                <AllCam_CVR> 1000 </AllCam_CVR>
                        </AllCampain>
                        <AllCampain>
                            ……
                        </AllCampain>
                </AllCampaigns>
        </result>
</message>

캠페인 목록

Request URL

URL

Method

/S-Plus_api/getCampaignList.xml

Get

/S-Plus_api/getCampaignList.json

Get

Request Parameters

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

adver

권한

Cam_No

Integer

12345

캠페인ID

sDate

Integer

20160101

캠페인 시작 일자

eDate

Integer

20160131

캠페인 종료 일자

Response Fields

이름

타입

코드 예시

설명

Cam_Count

Integer

100

반환되는 리스트 행 수

Cam_Name

String

메조_테스트캠페인

캠페인명

CamInfo_Goal

Integer

100

캠페인 목표량

CamInfo_sDate

Integer

2016-01-01 0:00

캠페인 시작일

CamInfo_eDate

String

2016-01-01 0:00

캠페인 종료일

CamInfo_Status

String

0: 준비 1: 진행 2: 중지 3: 완료 4: 삭제

CamInfo_tBudjet

Integer

10000000

캠페인 총 예산

CamInfo_Brand

String

메조몰

캠페인 브랜드

CamInfo_Category

String

유통/유통기타

캠페인 카테고리

CamInfo_Agency

String

제일기획

캠페인 대행사

CamInfo_Agency2

String

이노션

캠페인 대대행사

CamInfo_Rep

String

메조미디어

캠페인 렙사

Campaigns.Campaign

Cam_Daily

String

2016-01-01

일자

Cam_Imp

Integer

1000

노출

Cam_Click

Integer

1000

클릭

Cam_CTR

Integer

1000

노출 대비 클릭

Cam_CPC

Integer

1000

CPC 단가

Cam_CPM

Integer

1000

CPM 단가

Cam_CPV

Integer

1000

CPV 단가

Response Sample

<?xml version="1.0" encoding="utf-8" ?>
<message>
     <error>
           <code>000</code>
           <message>성공</message>
     </error>
        <result>
                <Cam_Count>10</Cam_Count> 
                <Cam_Name>메조미디어 캠페인</Cam_Name> 
                <CamInfo_sDate>2016-06-01</CamInfo_sDate> 
                <CamInfo_eDate>2016-06-31</CamInfo_eDate> 
                <CamInfo_Status>1</CamInfo_Status> 
                <CamInfo_tBudjet>10000</CamInfo_tBudjet> 
                <CamInfo_Brand>메조브랜드</CamInfo_Brand> 
                <CamInfo_Category>가정용품/주방용품</CamInfo_Category> 
                <CamInfo_Agency>제일기획</CamInfo_Agency> 
                <CamInfo_Agency2>이노션</CamInfo_Agency2> 
                <CamInfo_Rep>메조미디어</CamInfo_Rep> 
                <AllCampaigns>
                        <AllCampain>
                                <AllCam_No>1234</AllCam_No>
                                <AllCam_Status>1</AllCam_Status>
                                <AllCam_Name>메조_테스트캠페인</AllCam_Name>
                                <AllCam_sDate> 2016-01-01 00:00</AllCam_sDate>
                                <AllCam_eDate> 2016-01-01 00:00 </AllCam_eDate>
                                <AllCam_Imp> 1000 </AllCam_Imp>
                                <AllCam_ImpP> 1000 </AllCam_ImpP>
                                <AllCam_Click> 1000 </AllCam_Click>
                                <AllCam_CTR> 1000 </AllCam_CTR>
                                <AllCam_CTRP> 1000 </AllCam_CTRP>
                                <AllCam_CV> 1000 </AllCam_CV>
                                <AllCam_CVR> 1000 </AllCam_CVR>
                        </AllCampain>
                        <AllCampain>
                            ……
                        </AllCampain>
                </AllCampaigns>
        </result>
</message>

광고 그룹 목록

Request URL

URL

Method

/S-Plus_api/getADGroupList.xml

Get

/S-Plus_api/getADGroupList.json

Get

Request Parameters

Main Request

캠페인 목록 API를 통해 반환된 Cam_No를 이용하여 해당 캠페인 하위에 포함되어 있는 광고그룹 목록을 요청합니다.

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

adver

권한

Cam_No

Integer

12345

캠페인ID

sDate

Integer

20160101

기간 조회 시작일

eDate

String

20160130

기간 조회 종료일

AGP

Integer

00001

광고그룹 목록 수

Sub Request

Main Request를 통해 반환된 AG_No와 AG_Product_Type을 이용하여 해당 광고그룹의 상세 리포트를 요청합니다.

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

adver

권한

sDate

Integer

20250101

기간 조회 시작일

eDate

String

20250130

기간 조회 종료일

Cam_No

Integer

12345

캠페인ID

AG_No

Integer

00001

광고그룹ID

AG_Product_Type

String

banner

banner, movie, native

Response Fields

Main Response

이름

타입

코드 예시

설명

AG_Count

Integer

100

반환되는 리스트 행 수

ADGroups.ADGroup

AG_No

Integer

00001

광고그룹ID

AG_Name

String

메조_테스트_띠배너

광고그룹명

AG_Status

String

0: 준비 1: 진행 2: 중지 3: 완료 4: 삭제

AG_Product_Type

String

Banner

banner, movie, native

AG_Product

String

배너_320X50

광고상품명

AG_Imp

String

1000

노출

AG_ImpP

String

1000

노출+

AG_Click

String

1000

클릭

AG_CTR

String

1000

노출 대비 클릭

AG_CTRP

String

1000

노출+ 대비 클릭

AG_CV

String

1000

전환 수

AG_CVR

String

1000

클릭 대비 전환율(%)

Sub Response

AG_Product_Type 이 banner 일 경우

이름

타입

코드 예시

설명

AG_Sub_B_Count

Integer

100

반환되는 리스트 행 수

ADGroups_Sub_B.ADGroup_Sub_B

Cam_No

Integer

12345

캠페인ID

AG_No

Integer

12345

광고그룹ID

AG_Sub_Date

String

2016-01-01 00:00

일자

AG_Sub_Imp

String

1000

노출

AG_Sub_Click

String

1000

클릭

AG_Sub_CTR

String

1000

노출 대비 클릭

AG_Sub_CV

String

1000

전환 수

AG_Sub_CVR

String

1000

클릭 대비 전환율(%)

AG_Product_Type 이 movie 일 경우

이름

타입

코드 예시

설명

AG_Sub_M_Count

Integer

100

반환되는 리스트 행 수

ADGroups_Sub_M.ADGroup_Sub_M

Cam_No

Integer

12345

캠페인ID

AG_No

Integer

12345

광고그룹ID

AG_Sub_Date

String

2016-01-01 00:00

일자

AG_Sub_Imp

Integer

1000

노출

AG_Sub_ImpP

Integer

1000

노출+

AG_Sub_View

Integer

1000

시청

AG_Sub_Click

Integer

1000

클릭

AG_Sub_CTR

Integer

1000

노출 대비 클릭

AG_Sub_CTRP

Integer

1000

노출+(15초) 대비 클릭

AG_Sub_VTR

Integer

1000

노출당 시청 비율

AG_Sub_VTRP

Integer

1000

노출+(15초)당 시청 비율

AG_Sub_CVTR

Integer

1000

노출당 재생+클릭

AG_Sub_CVTRP

Integer

1000

노출+(15초)당 재생+클릭

AG_Sub_Start

Integer

1000

동영상 시작시 노출 수

AG_Sub_1Q

Integer

1000

동영상 25% 재생시 노출 수

AG_Sub_2Q

Integer

1000

동영상 50% 재생시 노출 수

AG_Sub_3Q

Integer

1000

동영상 75% 재생시 노출 수

AG_Sub_Complete

Integer

1000

동영상 재생 종료시 노출 수

AG_Sub_CV

String

1000

전환 수

AG_Sub_CVR

String

1000

클릭 대비 전환율(%)

Response Sample

Main Response Sample

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Count>10</AG_Count>
        <ADGroups>
            <ADGroup>
                <AG_No>1234</AG_No>
                <AG_Name>메조_테스트_띠배너</AG_Name>
                <AG_Status>1</AG_Status>
                <AG_Product_Type>banner</AG_Product_Type>
                <AG_Product>배너_320X50</AG_Product>
                <AG_Imp>1000</AG_Imp>
                <AG_ImpP>1000</AG_ImpP>
                <AG_Click>1000</AG_Click>
                <AG_CTR>1000</AG_CTR>
                <AG_CTRP>1000</AG_CTRP>
                <AG_CV>1000</AG_CV>
                <AG_CVR>1000</AG_CVR>
            </ADGroup>
            <ADGroup>
                ……
            </ADGroup>
        </ADGroups>
    </result>
</message>

Sub Response Sample

AG_Product_Type 이 banner 일 경우

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Sub_B_Count>10</AG_Sub_B_Count>
        <ADGroups_Sub_B>
            <ADGroup_Sub_B>
                <Cam_No>1234 </Cam_No>
                <AG_No>12345</AG_No>
                <AG_Sub_Date>2016-01-01 00:00</AG_Sub_Date>
                <AG_Sub_Imp>1000</AG_Sub_Imp>
                <AG_Sub_Click>1000</AG_Sub_Click>
                <AG_Sub_CTR>1000</AG_Sub_CTR>
                <AG_Sub_CV>1000</AG_Sub_CV>
                <AG_Sub_CVR>1000</AG_Sub_CVR>
            </ADGroup_Sub_B>
            <ADGroup_Sub_B>
                ……
            </ADGroup_Sub_B>
        </ADGroups_Sub_B>
    </result>
</message>

AG_Product_Type 이 movie 일 경우

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Sub_M_Count>10</AG_Sub_M_Count>
        <ADGroups_Sub_M>
            <ADGroup_Sub_M>
                <Cam_No>1234</Cam_No>
                <AG_No>12345</AG_No>
                <AG_Sub_Date>2016-01-01 00:00</AG_Sub_Date>
                <AG_Sub_Imp>1000</AG_Sub_Imp>
                <AG_Sub_ImpP>1000</AG_Sub_ImpP>
                <AG_Sub_View>1000</AG_Sub_View>
                <AG_Sub_Click>1000</AG_Sub_Click>
                <AG_Sub_CTR>1000</AG_Sub_CTR>
                <AG_Sub_CTRP>1000</AG_Sub_CTRP>
                <AG_Sub_VTR>1000</AG_Sub_VTR>
                <AG_Sub_VTRP>1000</AG_Sub_VTRP>
                <AG_Sub_CVR>1000</AG_Sub_CVR>
                <AG_Sub_CVTR>1000</AG_Sub_CVTR>
                <AG_Sub_CVTRP>1000</AG_Sub_CVTRP>
                <AG_Sub_Start>1000</AG_Sub_Start>
                <AG_Sub_1Q>1000</AG_Sub_1Q>
                <AG_Sub_2Q>1000</AG_Sub_2Q>
                <AG_Sub_3Q>1000</AG_Sub_3Q>
                <AG_Sub_Complete>1000</AG_Sub_Complete>
            </ADGroup_Sub_M>
            <ADGroup_Sub_M>
                ……
            </ADGroup_Sub_M>
        </ADGroups_Sub_M>
    </result>
</message>

광고물 목록

Request URL

URL

Method

/S-Plus_api/getADList.xml

Get

/S-Plus_api/getADList.json

Get

Request Parameters

Main Request

캠페인 목록 API를 통해 반환된 Cam_No를 이용하여 해당 캠페인 하위에 포함되어 있는 광고그룹 목록을 요청합니다.

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

adver

권한

Cam_No

Integer

12345

캠페인ID

sDate

Integer

20160101

기간 조회 시작일

eDate

String

20160130

기간 조회 종료일

ADP

Integer

00001

광고그룹 목록 수

Sub Request

Main Request를 통해 반환된 AD_No와 AD_Product_Type을 이용하여 해당 광고그룹의 상세 리포트를 요청합니다.

이름

타입

기본값

코드 예시

설명

USER

String

XXXXXX

ID 암호화

Auth_Type

String

XXXXXXX

권한

sDate

Integer

20160101

기간 조회 시작일

eDate

String

20160130

기간 조회 종료일

Cam_No

Integer

12345

캠페인ID

AD_No

Integer

00001

광고그룹ID

AD_Product_Type

String

banner

banner, movie, native

Response Fields

Main Response

이름

타입

코드 예시

설명

AD_Count

Integer

100

반환되는 리스트 행 수

ADs.AD

AD_No

Integer

광고물 ID

AD_Name

String

메조_테스트_띠배너

광고물명

AD_Status

String

0: 준비 1: 진행 2: 중지 3: 완료 4: 삭제

AD_Product_Type

String

Banner

banner, movie, native

AD_Product

String

배너_320X50

광고상품명

AD_imgURL

String

http://www.a.com/image.jpg

이미지 배너 소재 경로

AD_movieURL

String

http://www.a.com/movie.mp4

동영상 소재 경로

AD_Imp

String

1000

노출

AD_ImpP

String

1000

노출+

AD_Click

String

1000

클릭

AD_CTR

String

1000

노출 대비 클릭

AD_CTRP

String

1000

노출+ 대비 클릭

AD_CV

String

1000

전환 수

AD_CVR

String

1000

클릭 대비 전환율(%)

Sub Response

AD_Product_Type 이 banner 일 경우

이름

타입

코드 예시

설명

AD_Sub_B_Count

Integer

100

반환되는 리스트 행 수

ADs_Sub_B.AD_Sub_B

Cam_No

Integer

12345

캠페인ID

AD_No

Integer

12345

광고물 ID

AD_Sub_Date

String

2016-01-01 00:00

일자

AD_Sub_Imp

String

1000

노출

AD_Sub_Click

String

1000

클릭

AD_Sub_CTR

String

1000

노출 대비 클릭

AD_Sub_CV

String

1000

전환 수

AD_Sub_CVR

String

1000

클릭 대비 전환율(%)

AD_Product_Type 이 movie 일 경우

이름

타입

코드 예시

설명

AD_Sub_M_Count

Integer

100

반환되는 리스트 행 수

ADs_Sub_M.AD_Sub_M

Cam_No

Integer

12345

캠페인ID

AD_No

Integer

12345

광고물 ID

AD_Sub_Date

String

2016-01-01 00:00

일자

AD_Sub_Imp

Integer

1000

노출

AD_Sub_ImpP

Integer

1000

노출+

AD_Sub_View

Integer

1000

시청

AD_Sub_Click

Integer

1000

클릭

AD_Sub_CTR

Integer

1000

노출 대비 클릭

AD_Sub_CTRP

Integer

1000

노출+(15초) 대비 클릭

AD_Sub_VTR

Integer

1000

노출당 시청 비율

AD_Sub_VTRP

Integer

1000

노출+(15초)당 시청 비율

AD_Sub_CVTR

Integer

1000

노출당 재생+클릭

AD_Sub_CVTRP

Integer

1000

노출+(15초)당 재생+클릭

AD_Sub_Start

Integer

1000

동영상 시작시 노출 수

AD_Sub_1Q

Integer

1000

동영상 25% 재생시 노출 수

AD_Sub_2Q

Integer

1000

동영상 50% 재생시 노출 수

AD_Sub_3Q

Integer

1000

동영상 75% 재생시 노출 수

AD_Sub_Complete

Integer

1000

동영상 재생 종료시 노출 수

AD_Sub_CV

String

1000

전환 수

AD_Sub_CVR

String

1000

클릭 대비 전환율(%)

Response Sample

Main Response Sample

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Count>10</AD_Count>
        <ADs>
            <AD>
                <AD_No>1234</AD_No>
                <AD_Name>메조_테스트_띠배너</AD_Name>
                <AD_Status>1</AD_Status>
                <AD_Product_Type>banner</AD_Product_Type>
                <AD_Product>배너_320X50</AD_Product>
                <AD_imgURL>http://www.a.com/image.jpg</AD_imgURL>
                <AD_MovieURL>http://www.a.com/movie.mp4</AD_MovieURL>
                <AD_Imp>1000</AD_Imp>
                <AD_ImpP>1000</AD_ImpP>
                <AD_Click>1000</AD_Click>
                <AD_CTR>1000</AD_CTR>
                <AD_CTRP>1000</AD_CTRP>
                <AD_CV>1000</AD_CV>
                <AD_CVR>1000</AD_CVR>
            </AD>
            <AD>
                ……
            </AD>
        </ADs>
    </result>
</message>

Sub Response Sample

AG_Product_Type 이 banner 일 경우

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Sub_B_Count>10</AD_Sub_B_Count>
        <ADs_Sub_B>
            <AD_Sub_B>
                <Cam_No>1234 </Cam_No>
                <AD_No>12345</AD_No>
                <AD_Sub_Date>2016-01-01 00:00</AD_Sub_Date>
                <AD_Sub_Imp>1000</AD_Sub_Imp>
                <AD_Sub_Click>1000</AD_Sub_Click>
                <AD_Sub_CTR>1000</AD_Sub_CTR>
                <AD_Sub_CV>1000</AD_Sub_CV>
                <AD_Sub_CVR>1000</AD_Sub_CVR>
            </AD_Sub_B>
            <AD_Sub_B>
                ……
            </AD_Sub_B>
        </ADs_Sub_B>
    </result>
</message>

AG_Product_Type이 movie 일 경우

<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Sub_M_Count>10</AD_Sub_M_Count>
        <ADs_Sub_M>
            <AD_Sub_M>
                <Cam_No>1234</Cam_No>
                <AD_No>12345</AD_No>
                <AD_Sub_Date>2016-01-01 00:00</AD_Sub_Date>
                <AD_Sub_Imp>1000</AD_Sub_Imp>
                <AD_Sub_ImpP>1000</AD_Sub_ImpP>
                <AD_Sub_View>1000</AD_Sub_View>
                <AD_Sub_Click>1000</AD_Sub_Click>
                <AD_Sub_CTR>1000</AD_Sub_CTR>
                <AD_Sub_CTRP>1000</AD_Sub_CTRP>
                <AD_Sub_VTR>1000</AD_Sub_VTR>
                <AD_Sub_VTRP>1000</AD_Sub_VTRP>
                <AD_Sub_CVR>1000</AD_Sub_CVR>
                <AD_Sub_CVTR>1000</AD_Sub_CVTR>
                <AD_Sub_CVTRP>1000</AD_Sub_CVTRP>
                <AD_Sub_Start>1000</AD_Sub_Start>
                <AD_Sub_1Q>1000</AD_Sub_1Q>
                <AD_Sub_2Q>1000</AD_Sub_2Q>
                <AD_Sub_3Q>1000</AD_Sub_3Q>
                <AD_Sub_Complete>1000</AD_Sub_Complete>
            </AD_Sub_M>
            <AD_Sub_M>
                ……
            </AD_Sub_M>
        </ADs_Sub_M>
    </result>
</message>

PreviousReport API Next대행사

Last updated 7 months ago

hashtag리스트 타입

hashtag에러코드

hashtag전체 캠페인 목록

hashtagRequest URL

hashtagRequest Parameters

hashtagResponse Fields

hashtagResponse Sample

hashtag캠페인 목록

hashtagRequest URL

hashtagRequest Parameters

hashtagResponse Fields

hashtagResponse Sample

hashtag광고 그룹 목록

hashtagRequest URL

hashtagRequest Parameters

hashtagMain Request

hashtagSub Request

hashtagResponse Fields

hashtagMain Response

hashtagSub Response

hashtagResponse Sample

hashtagMain Response Sample

hashtagSub Response Sample

hashtag광고물 목록

hashtagRequest URL

hashtagRequest Parameters

hashtagMain Request

hashtagSub Request

hashtagResponse Fields

hashtagMain Response

hashtagSub Response

hashtagResponse Sample

hashtagMain Response Sample

hashtagSub Response Sample

리스트 타입

에러코드

전체 캠페인 목록

Request URL

Request Parameters

Response Fields

Response Sample

캠페인 목록

Request URL

Request Parameters

Response Fields

Response Sample

광고 그룹 목록

Request URL

Request Parameters

Main Request

Sub Request

Response Fields

Main Response

Sub Response

Response Sample

Main Response Sample

Sub Response Sample

광고물 목록

Request URL

Request Parameters

Main Request

Sub Request

Response Fields

Main Response

Sub Response

Response Sample

Main Response Sample

Sub Response Sample