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

연동 가이드

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

API

실적 연동 Endpoint

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

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

연동 파라미터 규격

필드명타입필수설명
wmcliStringV클릭 시 전달받은 고유 클릭 식별자 (필수 유지)
adv_typeStringV광고 실적 유형 (S: 쇼핑, I: 설치 등)
act_typeStringV실적 구분 (purchase: 구매, cancel: 취소)
user_idString전환 고객 고유 식별자
order_idStringV주문/결제 고유 번호 (중복 체크용)
cart_idString장바구니 코드(해당하시는 경우)
prod_codeStringV상품코드
prod_nameStringv상품명
cate_codeString카테고리코드
cate_nameString카테고리명
amountNumberV결제 금액 (숫자만, S 유형 필수)
quantityNumberV구매수량
gaidString구글ADID
idfaString아이폰IDFA
rdateStringV구매일
Sample Code

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

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

PHP
<?php
$url = "https://trc.link-well.co.kr/trc.php";
$params = [
    "wmcli" => "YOUR_WMCLI_HERE",
    "adv_type" => "S",
    "act_type" => "purchase",
    "user_id" => "USER_123",
    "order_id" => "ORDER_456",
    "cart_id" => "CART_456",
    "prod_code" => "PROD_789",
    "prod_name" => "상품명",
    "cate_code" => "CAT_01",
    "cate_name" => "가전제품",
    "amount" => 50000,
    "quantity" => 1,
    "rdate" => "2026-01-01 10:05:55",
];

$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 생성)
➡️
전환 발생
➡️
📡
매체사 포스트백(성과 전송)
유저 클릭
매크로 변수설명비고
{wmcli}매체사 클릭코드필수
{refmid}매체사에서 실적발생시 전달 받으실 값선택
{sub1}추가로 받으실값 선택
{sub2}추가로 받으실값 선택
{sub3}추가로 받으실값 선택
클릭 URL 설정 예시:최종 클릭값 : https://click.link-well.co.kr/click.php?wmcli={wmcli}&refmid={전달받으실값}&sub1={sub1}&sub2={sub2}&sub3={sub3}
포스트백 매크로 변수
매크로 변수설명비고
{click_id}매체사에서 클릭 시 전달한 고유 식별값 (refmid)필수
{adv_type}광고 실적 유형 (S: 쇼핑, I: 설치 등)선택
{act_type}실적 구분 (purchase: 구매, cancel: 취소)선택
{merchant}광고주 정보선택
{order_id}광고주 측에서 발생한 주문/결제 고유 번호선택
{amount}광고주 측에서 발생한 총 결제 금액선택
{user_id}전환이 발생한 고객의 고유 식별자선택
{cart_id}장바구니 코드(해당하시는 경우)선택
{prod_code}상품코드선택
{prod_name}상품명선택
{cate_code}카테고리코드선택
{cate_name}카테고리명선택
{amount}결제 금액 (숫자만, S 유형 필수)선택
{quantity}구매수량선택
{rdate}구매일선택
포스트백 URL 설정 예시:https://api.your-system.com/postback?click_id={click_id}&order_id={order_id}&type={adv_type}