Reco V2 API 연동

ADID 기반으로 개인화 추천 상품을 조회합니다

URL

https://ssp-ext-proxy.adpopcorn.com/coupang/reco/v2

Method

POST

Headers

Content-Type: application/json

크롤링 등과 같은 비정상적인 요청을 방지를 위해 User-Agent 에 python-requests 와 같은 값은 사용할 수 없습니다

Request parameter

Body parameter	Type	설명
site	Site 객체	웹 사이트 요청에 필요합니다 site 및 app은 둘 중 하나만 제공해야 합니다
app	App 객체	앱 요청에 필요합니다 site 및 app은 둘 중 하나만 제공해야 합니다
device	Device 객체	필수 항목입니다
imp	Imp 객체	필수 항목입니다
user	User 객체	선택 사항입니다
affiliate	Affiliate 객체	필수 항목입니다

Site 객체

Parameter	Type	Scope	Description
domain	string	추천	쿠팡 광고가 노출될 최상위 웹 도메인 예) coupang.com
page	string	추천	실제 광고 지면 URL (가능할 경우) 예) https://page.coupang.com/p/bep
id	string		사이트 고유 식별자

App 객체

Parameter	Type	Scope	Description
bundleId	string	추천	안드로이드 번들/패키지명 또는 iOS 번들 식별자 (앱 ID)
domain	string	추천	앱 도메인
id	string		앱의 고유 식별자

Device 객체

Parameter	Type	Scope	Description
id	string	필수	Gogle Advertising ID on Android 또는IDFA on iOS
lmt	number	필수	GAID/IDFA 동의 여부 안드로이드: 0 - 비활성화, 1: 관심 기반 광고 수신 거부 활성화 iOS: 0 - 비활성화, 1: 광고 트래킹 제한 스위치 활성화
ip	string	추천	사용자의 IP 주소 (IPv4)
ua	string	추천	수정하지 않은 사용자 에이전트 문자열

Imp 객체

Parameter	Type	Scope	Description
imageSize	string	필수	상품 이미지 사이즈 (너비x높이) 필요한 화면 비율에 따라 크기 조정 가능 예) 300x250
placementId	string	추천	인벤토리 영역을 위한 ID 고유한 광고 영역을 참조해야 합니다
adType	number	선택사항	광고유형 1: text-only 2: banner (general display ad) 3: native (display native ad) 4: interstitial (full-page ad) 5: non-rewarded video 6: rewarded video
pos	number	선택사항	광고 영역 위치 1: 화면 상단 3: 화면 하단 4: 헤더 5: 푸터 6: 사이드바 7: 전체 화면

User 객체

Parameter	Type	Scope	Description
puid	string	필수	퍼블리셔가 정의한 최종 사용자 ID 제3자 쿠기 또는 ID에 의존하지 않고 사용자를 인식할 수 있는 대체 ID 및 개인정보 보호 우선 방식

Affiliate 객체

Parameter	Type	Scope	Description
subId	string	필수	채널 ID (정산 단위)
subParam	string	선택사항	사용자 추적 및 리포트에 사용할 커스텀 파라미터

JSON

{
    "site": {
        "domain": "test.com",
        "page": "http://www.test.com/abcd",
        "id": "id1"
    },
    "app": {
        "bundleId": "com.coupang.mobile",
        "id": "id2"
    },
    "imp": {
        "imageSize": "300x250",
        "adType": 1,
        "placementId": "pid1",
        "pos": 1
    },
    "device": {
        "id": "00000000-0000-0000-0000-000000000000",
        "lmt": 1,
        "ip": "0.0.0.0",
        "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
    },
    "user": {
        "puid": "1111111"
    },
    "affiliate": {
        "subId": "CPSap22222",
        "subParam": "AF0001"
    }
}

Response

Body parameter	Type	설명
rCode	string	상태코드 0: 정상 204: 추천 상품 없음 400: 파라미터 오류 403: 인증 오류 404: 채널 ID 없음 429: 요청량 초과 500: 서버 오류
rMessage	string	상태메시지
data	object
result	Product[]	상품 리스트

Product 객체

ID	Type	설명
productId	number	상품 ID
productName	string	상품명
productPrice	number	가격 (KRW)
productImage	string	상품 이미지 URL
productUrl	string	상품 페이지의 트래킹 URL
categoryName	string	상품 카테고리 (최대 길이 20자)
isRocket	boolean	로켓 배송 여부
impressionUrl	string	상품의 노출 트래킹 URL로 상품이 보여질때 호출되어야 합니다

200

{
    "rCode": "0",
    "rMessage": "게시글 작성 시, \"파트너스 활동을 통해 일정액의 수수료를 제공받을 수 있음\"을 기재하셔야 합니다",
    "data": {
        "result": [
            {
                "productId": 1232968322,
                "productName": "곰곰 신선한 1A 우유",
                "productPrice": 7380,
                "productImage": "https://ads-partners.coupang.com/openapi/image/xTspdrrR1ec92d3Lxf3YsKvxsiY5KtI0FGHrX1HheZ_g4cIGAJ15p37XgwjLdc_Ctgn6GXDh0ty9d4PHb20sQYOgpSOSZF0we46ksbToHrify0EgHGFS718NP2V7doOBEUkgwewvqVzTLmfwHL4uZw_op6K1ZINtAeFVaGXg2VwGln5ZvZz7UtrPdqwq-JlCXyPO-y-1bNvh-d2zaqxrcI7VcwpNzc4I7jBdkB7KZ82VtwTAzqkgeV2tUqTfSonQ6aVbNFKgQ2TmEmiukR9REgbiCpRJv05kpQaQi6gC4uJ2rOZX0WDUWpe574u8e5N4QOu7STF1Pl3mIkOXI69NnTwzzQehA_85lJlkAP3k-lXbBL2Rtg==",
                "productUrl": "https://link.coupang.com/re2/AFFSDP?lptag=AF1036751&subid=CPSapapp1&pageKey=1232968322&itemId=19223669920&vendorItemId=86340356298&traceid=V0-193-1fc5b0b4f277ae56&requestId=20251031100958614095278693&token=57579G&landing_exp=APP_LANDING_B",
                "categoryName": "로켓프레시",
                "isRocket": true,
                "impressionUrl": "https://ads-partners.coupang.com/openapi/impression/O_EBAOeSNR8fuB7ZO_IR8lFhelrWD7_fmaUAYxbhoZ8w2MLyoVMMj02n5MKse6RPdZD5Qo5IQ_W1fgldBqJz2NONpdBv1PXPrabaLlZgsO7-VMy13uFx4mZ03P8k24pe1EtqHfCBxvYUmZ0N6vTqbRFKb_o5X2D-YSYWfZvHE2mdWv7bi28ZUHlbq4Au4Qi3CXCwjc6QFPzd489EDvTwrFpOJ9xEWrVZezMAR7qqPRFRTzg35UMGFNh9y3lGdMXcQBX_aO5wO_7srlCp04bgxrLGPyPE4XQUwqm4qG3NC7_IIjjuUGPR-DR9lHkb4ZkNSSViXP5IduEI2S51EqKXld7Y5lGDDUuP-XMTc2tH5Wu8lkfMyg=="
            },
            {
                "productId": 7987740493,
                "productName": "5세대 저소음 BLDC 모터 날개없는 선풍기 타워형",
                "productPrice": 139000,
                "productImage": "https://ads-partners.coupang.com/openapi/image/tuTEd3-InAdCATpJtmPVRmSVoajNQJKNDRU8L_KIJHp6Pf40qhVnoQ9XMLSyn8WMbNe1ymlYZkVCkJlKrwO_gNFpdeYunjgCb0wCemfvk9gkXI49QWEOggapgImxNPPVMD4AXCgdqH3UBCbdFkkkxPEIMHy8PhAsLfRyDtYCOQb4ZbrUKOH7w-2_Fvs6xwFmj0IAYlE-vUQy2HUQsrm02sBHBElWDuDDlFIdkqGBSWTRILosUSjQOCCHifQddid43zn4NxAS54rdlIo5uYc9KZSvRwkgmWGjopoCyNK6Zn0p0vpWVGTzeOBVdrlHx1fFtNbZOffNjxQJMVWieoAT1ac6hJmthJkBmLm0nE6DqogEHCVQs9kSlaR3g6w=",
                "productUrl": "https://link.coupang.com/re2/AFFSDP?lptag=AF1036751&subid=CPSapapp1&pageKey=7987740493&itemId=25151521546&vendorItemId=92142036228&traceid=V0-193-f02a803120acb871&requestId=20251031100958614095278693&token=57579G&landing_exp=APP_LANDING_B",
                "categoryName": "가전디지털",
                "isRocket": true,
                "impressionUrl": "https://ads-partners.coupang.com/openapi/impression/Ul0zpjg_H_Cpv_7dUpDbkzjS9gTdKoBMvgR5_IELF1WNkIFxVChUg5mNX_juiWZnsm6hElQmrqXLY74zLNEyLV2l36Lp5Mh4TYqca9YnnZhasLXnw7cbRFraC1tG4QBKHlr0jTqkRKHUeV-ZxphoD8ymdveKMrfQqfghD5c5POtMTtQjd1fIZFEaw3fP_Giq3N6f6M1SK77mOTNAtbmC9IYSWyw58Ezv6UpWd3AO9fii1PE-S4PO5hfqA6HlQhbaacG-mH5TQf5yBA0n0BTjd2SAkrB5n1Wx-CqsVOB--ExY9i4Affe7HhAAbUq4zeHVUIhq1Q7aAt46_XUQ0IyMalZVISdvubZBMgxCsHWQJu66xCH87YrOsoiXzRY="
            }
        ]
    }
}

노출 측정 가이드 라인

노출 트래킹은 고객 측 그리고 추천이 표시되는 디바이스에서 구현되어야 합니다. 노출 URL 트래커는 상품 추천이 최종 사용자에게 노출되고 실제 사람이 상품을 본 경우에만 실행되어야 합니다.