Keitaro 통합 가이드

서버 간(S2S) 전환 추적을 Keitaro를 사용하여 Blockchain-Ads 네트워크에 설정하려는 경우, Blockchain-Ads를 구성하여 포스트백 URL을 생성하고(Keitaro가 전환 데이터를 전송하는 곳) Keitaro에서 맞춤 트래픽 소스로 통합합니다. 이를 통해 Keitaro가 유입 트래픽에서 {clickid}를 캡처하고 일치하는 클릭 ID, 수익 및 기타 세부 정보와 함께 Blockchain-Ads로 포스트백을 전송합니다.

단계 1: Blockchain-Ads에서 S2S 전환 이벤트 생성하기

1. Blockchain-Ads HUB 대시보드에 로그인하세요.
2. Advertising > Tracking > Create Conversion > Server to Server로 이동하세요.
3. 화면의 지시에 따라 이벤트를 설정하세요:
   
   • 전환 이벤트 이름을 지정하세요(예: "Lead" 또는 "Sale").
   • 이벤트 유형(예: lead, purchase)을 지정하고 해당되는 경우 수익 필드를 추가하세요.
   • 이는 이벤트에 대한 고유한 추적기 ID와 다음 형식의 포스트백 URL을 생성합니다:

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

• {clickid}: 고유한 클릭 ID의 플레이스홀더(Blockchain-Ads가 원래 클릭과 일치시킵니다).
• trackerid: 고정된 이벤트 ID(변경하지 마세요).
• {transaction_value}: 수익/지급액의 선택적 플레이스홀더(수익을 추적하지 않는 경우 생략).

이 전체 포스트백 URL을 복사하세요. Keitaro에서 필요합니다.

4. 이벤트를 저장하세요. 참고: Blockchain-Ads에서 캠페인을 생성할 때 대상 URL을 Keitaro 캠페인 URL로 설정하세요(예: https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads가 실제 클릭 ID 값을 자동으로 추가합니다.

단계 2: Keitaro에서 Blockchain-Ads를 맞춤 트래픽 소스로 추가하기

1. Keitaro 대시보드에 로그인하세요.
2. Traffic Sources > Create로 이동하세요.
3. "From template" 필드에서 "Blockchain-Ads"를 검색하세요. 템플릿이 없는 경우 Custom을 선택하거나 비워 두고 수동으로 구축하세요.
4. 기본 세부 정보를 입력하세요:
   
   • Name: "Blockchain-Ads".
   • Click ID 파라미터: clickid로 설정하세요(이는 Keitaro에게 Blockchain-Ads 트래픽에서 들어오는 ?clickid=xxx 값을 캡처하고 포스트백의 외부 ID로 내부에 저장하도록 지시합니다).
5. 파라미터 템플릿 섹션(메시지가 표시되는 경우):
   
   • 클릭 ID에 대한 행을 추가하세요:
     
     • 열 1 (Alias): 비워 두거나 보고용으로 "External ID"로 설정하세요.
     • 열 2 (Parameter name): clickid.
     • 열 3 (Macro): 비워 두세요(Blockchain-Ads가 실제 값을 직접 추가하므로).
   • 필요한 경우 다른 파라미터를 추가하세요(예: Blockchain-Ads 매크로의 캠페인 ID 또는 subID).
6. S2S Postback 필드에서:
   
   • 단계 1의 포스트백 URL을 붙여넣으세요.
   • Blockchain-Ads 플레이스홀더를 Keitaro 동등물로 교체하세요:
     
     • {clickid} → {external_id}(캡처된 클릭 ID를 전달합니다).
   • 변환된 URL 예시:

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

특정 전환 상태만 전송하려는 경우(예: 승인된 리드) "Send only statuses" 드롭다운 메뉴를 사용하여 선택하세요(예: "Lead", "Sale").

7. Create를 클릭하여 트래픽 소스를 저장하세요.
8. (선택 사항) 여러 캠페인이 있는 경우 Update in campaigns를 체크하여 기존 캠페인에 적용하세요.

단계 3: Keitaro에서 캠페인 설정 및 테스트

1. Campaigns > Create로 이동하거나 기존 캠페인을 편집하세요.
2. Traffic Source로 Blockchain-Ads를 선택하세요.
3. 플로우를 구축하세요: 스트림, 랜딩 페이지, 오퍼를 추가하세요. 전환의 경우:
   
   • 어필리에이트 오퍼를 사용하는 경우 어필리에이트 네트워크에서 Keitaro로 포스트백을 설정하세요(Affiliate Networks 하위).
   • 전환 규칙을 정의하세요(예: 오퍼의 S2S 포스트백, 픽셀 발화 또는 맞춤 이벤트).
4. Keitaro 캠페인 URL을 생성하고 복사하세요(https://your-domain.com/abc?clickid={external_id}와 같이 표시되며, 이를 Blockchain-Ads 캠페인의 대상으로 붙여넣으세요).
5. 테스트:
   
   • Keitaro URL을 가리키는 Blockchain-Ads에서 테스트 캠페인을 시작하세요.
   • 클릭 및 전환을 시뮬레이션하세요(예: 테스트 오퍼를 통해).
   • 캡처된 클릭/전환에 대한 Keitaro 보고서(Reports > Conversions)를 확인하세요.
   • Blockchain-Ads 추적에서 포스트백이 도착하는지 확인하세요(일치하는 클릭 ID 및 수익 포함).
   • 필요한 경우 Postman과 같은 도구를 사용하여 테스트 포스트백을 수동으로 발화하세요.

팁 및 문제 해결

• Keitaro의 플레이스홀더: clickid에는 {external_id}, 금액에는 {revenue}, 이벤트 유형에는 {status}를 사용하세요(예: "lead"를 상태에 매핑). 인코딩되지 않은 값의 경우 접두사 _를 사용하세요(예: {_external_id}).
• 수익/통화: 전환의 통화가 다른 경우 {revenue:USD}를 사용하여 변환하세요.
• 오류: 포스트백에 HTTPS를 사용하는지 확인하세요. 데이터가 흘러가지 않으면 URL 인코딩, 방화벽 차단 또는 일치하지 않는 추적기 ID를 확인하세요. Keitaro는 Logs > Postbacks에서 포스트백 시도를 기록합니다.
• 고급: 여러 이벤트의 경우 Blockchain-Ads에서 별도의 전환 이벤트를 생성하고 Keitaro에 여러 포스트백 URL을 추가하세요(상태당 하나).

이 설정은 쿠키 없이 정확한 속성을 가능하게 합니다. Keitaro에 대한 자세한 내용은 docs.keitaro.io의 문서를 참조하세요.