매체사 포스트백

리워드 앱, 부스팅 매체처럼 자체 트래킹 시스템을 쓰는 매체사는 "전환이 일어나면 우리 주소로 알려달라"고 요구합니다. adstage는 이 요청을 링크 단위 설정으로 처리합니다. 매체사가 준 콜백 URL을 넣어두면, 그 링크로 유입된 사용자가 설치·구매 같은 이벤트를 일으킬 때 adstage가 매체사 주소를 대신 호출합니다.

매체사마다 개발이 필요 없습니다. 스펙을 받아 대시보드에 입력하면 바로 연동됩니다.

1. 어디서 설정하나요

딥링크 > 생성 또는 기존 링크의 상세 화면에서 매체사 포스트백 섹션을 켭니다. 설정은 링크마다 따로 저장되므로, 매체사별로 링크를 나눠 만들고 각 링크에 그 매체사의 주소를 넣습니다.

2. 설정 항목

매체사가 "클릭할 때 cb라는 파라미터로 우리 클릭 ID를 넘기겠다"고 하면, 클릭 ID 파라미터명에 cb를 넣습니다.

3. URL 템플릿과 매크로

매체사가 준 주소를 그대로 붙여넣고, 값이 들어가야 하는 자리에 매크로를 씁니다.

https://postback.network.com/install?cb={click_id}&adid={adid}

사용할 수 있는 매크로는 다음과 같습니다.

목록에 없는 매크로를 요구하는 경우

매체사가 {sub_id}, {pub_id}처럼 자기들만 쓰는 값을 요구하면 그대로 쓰면 됩니다. 목록에 없는 매크로는 클릭 시점에 그 이름으로 들어온 파라미터를 그대로 돌려주는(에코) 방식으로 동작합니다.

즉 매체사가 클릭 URL에 ?sub_id=abc123을 붙여 보냈다면, 포스트백의 {sub_id} 자리에 abc123이 채워집니다.

주의하세요

클릭 시 해당 파라미터가 들어오지 않으면 빈 값으로 나갑니다. 매체사 스펙에 있는 파라미터가 실제 클릭 URL에도 포함되는지 확인하세요.

4. 동작 방식

1. 사용자가 매체사 광고를 눌러 adstage 트래킹 링크로 들어옵니다. 이때 클릭 ID와 매체사 파라미터가 함께 기록됩니다.

2. 그 사용자가 설치하거나 설정한 이벤트를 일으키면, adstage가 어트리뷰션으로 매체사 클릭을 찾아냅니다.

3. URL 템플릿의 매크로를 실제 값으로 치환해 매체사 주소를 호출합니다.

중복 방지

같은 클릭에 대해 같은 이벤트는 한 번만 발사됩니다. 사용자가 앱을 여러 번 열거나 이벤트가 중복 수집돼도 매체사에 두 번 보내지 않습니다.

install과 first_open처럼 같은 의미로 쓰이는 이벤트명은 하나로 묶여 처리되므로, 둘 다 들어와도 포스트백은 한 번만 나갑니다.

실패 시 재시도

매체사 서버가 일시적으로 응답하지 않으면 전환이 조용히 유실되지 않도록 자동으로 다시 시도합니다.

5. 연동 전 매체사에 확인할 것

새 매체사와 연동할 때는 다음 네 가지만 받으면 됩니다.

1. 포스트백 URL — 설치용, 그리고 이벤트용이 따로 있으면 그것도
2. 클릭 ID 파라미터명 — 클릭 URL에 어떤 이름으로 식별자를 붙이는지
3. 필요한 매크로 목록 — 어떤 값을 넘겨받길 원하는지
4. 대상 이벤트 — 설치만인지, 구매 등 다른 이벤트도 필요한지

6. 주의사항

• 포스트백 설정은 링크 단위입니다. 한 매체사에 여러 링크를 주는 경우 각 링크에 모두 설정해야 합니다.
• 어트리뷰션이 성립해야 포스트백이 발사됩니다. 매체사 링크를 거치지 않은 유입은 대상이 아닙니다.
• URL에 들어가는 값은 자동으로 URL 인코딩됩니다. 매크로 자리에 값을 미리 인코딩해 넣지 마세요.
• 매체사가 응답 본문으로 성공/실패를 구분하는 경우가 있습니다. adstage는 HTTP 상태 코드로만 판정하며 2xx와 3xx를 성공으로 봅니다. 본문에 오류를 담아 200으로 응답하는 매체사라면 실패를 인지하지 못하므로, 오류 시 4xx·5xx를 반환하도록 요청하세요.