Server-to-Server 설치

S2S 설정은 간단합니다. 고객님께서는 대시보드에서 전환 이벤트를 생성하고, postback URL을 생성하며, 추적 소프트웨어가 전환 시 실행되도록 구성하시게 됩니다. Blockchain-Ads는 고유한 {clickid} 파라미터를 사용하여 클릭과 전환을 원활하게 매칭합니다.

단계 1: 전환 이벤트 생성

1. Blockchain-Ads HUB 대시보드에 로그인하십시오.
2. Advertising > Tracking > Create Conversion으로 이동하십시오.
3. 추적 방법으로 Server to Server를 선택하십시오.
4. 이벤트 세부 정보를 입력하십시오:
   
   • Event Name (이벤트 이름): 예를 들어, "Purchase", "Lead" 또는 "Sign-Up".
   • Revenue Field (수익 필드) (선택 사항): 지불금 또는 주문 가치를 추적하는 경우 활성화하십시오.
5. Save를 클릭하십시오. 다음 형식의 고유한 postback URL을 받게 됩니다:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

• {clickid}: 원본 클릭의 고유 ID (트래커에서 반환됨).
• {revenue}: 전환 가치의 자리 표시자 (예: $10.50의 경우 10.50; 사용하지 않는 경우 생략).

6. 이 URL을 복사하십시오—이것은 전환 데이터를 전송하기 위한 endpoint입니다.

단계 2: 추적 소프트웨어 구성

고객님의 트래커 또는 제휴 플랫폼에서:

1. Blockchain-Ads를 트래픽 소스로 추가하십시오.
   
   • Click ID Parameter를 clickid로 설정하십시오. 이는 캠페인 URL에 추가된 {clickid}를 캐처합니다 (예: https://your-landing-page.com/?clickid=xyz789).
2. postback URL을 설정하십시오.
   
   • 단계 1의 URL을 붙여넣으십시오.
   • 자리 표시자를 트래커의 매크로에 매핑하십시오:
     
     • {clickid} → 트래커의 클릭 ID 매크로 (예: {external_id} 또는 {clickid}).
     • {revenue} → 수익 매크로 (예: {payout} 또는 {revenue}).
   • 일반 트래커에 대한 예시:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=abc123&transaction_value={revenue}

3. 전환 규칙을 정의하십시오:
   
   • 양식 제출 또는 감사 페이지 로드와 같은 이벤트에서 postback을 트리거하십시오.
   • 선택적으로 status (예: &status=approved) 또는 currency (예: &currency=KRW)와 같은 추가 파라미터를 전달하십시오.

단계 3: 캠페인 대상 업데이트

1. Blockchain-Ads에서 캠페인을 편집하십시오.
2. Destination URL을 트래커의 캠페인 링크로 설정하고, {clickid} 매크로가 포함되어 있는지 확인하십시오:

https://your-tracker.com/campaign123?clickid={clickid}

3. 실행하고 테스트하십시오 (아래 참조).

단계 4: 통합 테스트

1. 낮은 예산으로 테스트 캠페인을 생성하십시오.
2. 광고를 클릭하고 전환을 시뮬레이션하십시오 (예: 테스트 제안 완료).
3. 확인하십시오:
   
   • Blockchain-Ads Reports: Reports > Conversions로 이동—클릭 ID가 일치하고 수익이 표시되는지 확인하십시오.
   • 트래커 로그: postback이 성공적으로 실행되었는지 확인하십시오 (4xx/5xx 오류 없음).
4. 수동 테스트를 위해 Postman 또는 curl과 같은 도구를 사용하십시오:

curl "https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid=TEST123&trackerid=abc123&transaction_value=5.00"

5. 200 OK 응답을 기대하십시오.

S2S 추적을 위한 모범 사례

• 보안: 모든 postback에 HTTPS를 사용하십시오. 트래커가 지원하는 경우 IP 화이트리스트를 추가하십시오 (저희의 IP 범위는 support@blockchain-ads.com으로 문의하십시오).
• 인코딩: 오류를 방지하기 위해 값을 URL 인코딩하십시오 (예: 공백은 %20으로 변환).
• 중복 제거: 중복 카운팅을 방지하기 위해 타임스탬프 또는 고유 거래 ID를 포함하십시오.
• 여러 이벤트: 다른 작업에 대해 별도의 전환 이벤트를 생성하고 (예: 리드용 하나, 판매용 하나) 조건부 postback을 사용하십시오.
• 오류 처리: 실패한 postback을 모니터링하십시오—트래커에서 재시도를 구현하십시오 (최대 3회 시도).
• 규정 준수: 항상 개인정보 보호정책에서 추적을 공개하십시오.
• 최적화: 저희의 실시간 보고를 사용하여 S2S 데이터를 분석하고 동적으로 입찰을 조정하십시오.