Service Guide
Linkwell, 링크웰 제휴마케팅

연동 가이드

링크웰 광고 시스템과의 기술 연동을 위한 상세 가이드를 안내해 드립니다.

API

실적 연동 Endpoint

실적 발생 시 아래의 URL로 GET 호출을 전송해 주시기 바랍니다.

https://trc.link-well.co.kr/trc.php
Spec

연동 파라미터 규격

필드명타입필수설명
wmcliStringV클릭 시 전달받은 고유 클릭 식별자 (필수 유지)
adv_typeStringV광고 실적 유형 (S: 쇼핑, I: 설치 등)
user_idStringV전환 고객 고유 식별자
order_idStringV주문/결제 고유 번호 (중복 체크용)
amountNumberV결제 금액 (숫자만, S 유형 필수)
cpsdataJSON-상세 품목 정보 (JSON Array 포맷)
JSON

Sample Data (JSON)

cpsdata 파라미터에 포함될 개별 상품 정보의 구조입니다.

JSON
[
  {
    "buy_type": "P",
    "product_code": "PROD_999",
    "product_name": "테스트상품A",
    "category_code": "CAT_01",
    "category_name": "카테고리1",
    "quantity": 1,
    "price": 30000
  },
  {
    "buy_type": "P",
    "product_code": "PROD_888",
    "product_name": "테스트상품B",
    "category_code": "CAT_02",
    "category_name": "카테고리2",
    "quantity": 2,
    "price": 15000
  }
]
Sample Code

서버 연동 샘플 코드 (Server-to-Server)

가장 많이 사용되는 서버 언어별 통합 예시 코드입니다.

PHP
<?php
$url = "https://trc.link-well.co.kr/trc.php";
$params = [
    "wmcli" => "YOUR_WMCLI_HERE",
    "adv_type" => "S",
    "user_id" => "USER_123",
    "order_id" => "ORDER_456",
    "amount" => 50000,
    "cpsdata" => json_encode([
        [
            "buy_type" => "P",
            "product_code" => "PROD_789",
            "product_name" => "테스트상품",
            "category_code" => "CAT_01",
            "category_name" => "카테고리명",
            "quantity" => 1,
            "price" => 50000
        ]
    ])
];

$query = http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
For Publisher

매체사 포스트백 (Postback)

링크웰 시스템에서 발생한 성과 데이터를 매체사 시스템으로 실시간 전송하는 방법입니다.

🖱️
유저 클릭
➡️
🔗
링크웰 서버(Click ID 생성)
➡️
전환 발생
➡️
📡
매체사 포스트백(성과 전송)
포스트백 매크로 변수
매크로 변수설명비고
{click_id}매체사에서 클릭 시 전달한 고유 식별값 (refmid)필수
{adv_type}광고 실적 유형 (S: 쇼핑, I: 설치 등)선택
{order_id}광고주 측에서 발생한 주문/결제 고유 번호선택
{amount}광고주 측에서 발생한 총 결제 금액선택
{user_id}전환이 발생한 고객의 고유 식별자선택
{cpsdata}전환된 상품 정보선택
포스트백 URL 설정 예시:https://api.your-system.com/postback?click_id={click_id}&order_id={order_id}&type={adv_type}