콜백 실패 문제 해결

Offerwall 보상에 대한 Offerwall 콜백 실패 문제 해결 가이드를 검토하십시오.

읽는 시간 3분

최근 업데이트: 14시간 전

콜백 실패가 증가하거나 사용자가 Offerwall 보상을 받지 않는 경우, 이 문제는 종종 엔드포인트 설정, 네트워크 접근성, 페이로드 처리, HTTP 메서드 불일치와 관련이 있습니다. 다음 문제 해결 가이드를 검토하여 오류의 근본 원인을 식별 결정.

콜백 URL 및 메서드 설정 확인

콜백 실패의 가장 일반적인 원인은 잘못된 URL이거나 요청이 서버에서 예상하는 방식과 일치하지 않는 것입니다. 다음 사항을 확인하려면 대시보드 설정을 확인하십시오.

활성 URL: 유효한 콜백 URL이 구성되어 실수로 제거되거나
```
NO_CALLBACK
```
로 설정되지 않았는지 확인합니다.
HTTP 메서드(GET 대 POST): 콜백 GET(기본값) 또는 POST 요청으로 전송되도록 설정되어 있는지 확인합니다.
- GET 또는 POST 중 하나로 구성된 경우, 선택한 메서드를 수신하고 올바르게 파싱 엔드포인트가 명시적으로 구성되었는지 확인합니다.
- POST로 구성된 경우 서버가 요청 바디 올바르게 읽고 있는지 확인합니다.
형식: URL에 유효한 체계(
```
https://
```
), 호스트 및 경로가 없거나 잘못된 형식의쿼리 문자열이 있는지 확인합니다.
환경: 스테이징 또는 테스트 엔드포인트가 아닌 프로덕션 환경 대한 URL 포인트를 확인합니다.
파라미터: 모든 필수 파라미터와 매크로가 URL 구조, 구조체 있는지 확인합니다.

네트워크, 전송 및 보안 규칙 확인

Offerwall 서버가 엔드포인트에 도달률 수 없는 경우 콜백이 실패할 수 있습니다. 서버 및 네트워크 상태를 확인하여 다음 사항을 확인하십시오.

방화벽 및 WAF: 웹 애플리케이션 방화벽(WAF) 또는 보안 설정을 확인합니다. Offerwall 콜백 IP 주소가 allowlist에 등록되어 있고 트래픽 실수로 차단되지 않았는지 확인합니다.
인증서: 엔드포인트에 유효하고 만료되지 않은 SSL/TLS 인증서 제공되는지 확인합니다.
시간 초과 및 도달 가능성: DNS 해상도 오류, 연결 시간 초과 또는 간헐적인 엔드포인트 유효성 확인
속도 제한: 속도 제한이 활성화되어 있는 경우, 사용 가능한 영역이 큰 콜백이 트리거 블록인지 확인합니다. 서버가 갑작스러운 트래픽 스파이크를 처리할 수 있는지 확인합니다.

HTTP 리스폰스 코드 분석

Offerwall은 200의 OK 응답을 예상합니다. 서버가 다른 HTTP 상태 코드를 반환하면 장애가 기록되고 재시도 가능합니다. 서버 로그에 다음과 같은 일반적인 오류 코드가 있는지 확인합니다.

3xx (다이렉트): 리디렉션을 피합니다. 마이그레이션은 Offerwall 대시보드에서 바로 업데이트되어야 합니다. 콜백 송신기는 예기치 않게 리디렉션되면 페이로드를 끌 수 있습니다.
400(잘못된 요청): 잘못된 형식의 요청을 나타냅니다. 파라미터 누락, 형식 불일치 또는 잘못된 데이터 유형으로 인해 서버가 페이로드를 거부하는지 확인합니다.
401/403(인증 안 함/차단됨): 인증 실패를 나타냅니다. 인증 토큰, 서명 또는 IP allowlist가 최신 상태인지 확인합니다. 최근에 비밀을 변경한 경우 Offerwall이 업데이트되었는지 확인합니다.
404 (찾을 수 없음): 엔드포인트 경로 올바르지 않거나 삭제되었습니다. 콜백 URL을 업데이트하지 않고 최근에 서버 마이그레이션이 수행되었는지 확인합니다.
405 (메서드 허용 안 함): 서버가 HTTP 메서드를 거부하고 있습니다. 이는 거의 항상 콜백 POST로 전송되지만 서버가 GET을 예상하거나 그 반대일 때 발생합니다.
409( 충돌): 종종 중복된 거래 거부 로직으로 인해 발생합니다. 이드포텐시 로직이 너무 적극적이지 않도록 합니다(예: 유효한 재시도 거부).
429(요청이 너무 많음): 서버가 Offerwall을 조절하고 있습니다. 속도 제한을 조정하여 트래픽 폭발을 수용하십시오.
5xx(서버 오류): 서버의 백엔드 불안정성, 서비스 다운타임 또는 애플리케이션 크래시를 나타냅니다.

페이로드 및 파라미터 무결성 검증

콜백이 서버에 도달하지만 사용자가 여전히 보상형 광고 받지 않는 경우 서버가 콜백 콘텐츠 거부할 수 있습니다.

서명 일치: 서명 인증 필요한 경우 해싱 로직이 Offerwall의 예상 포맷과 일치하는지 확인합니다.
매크로 해상도: 사용자 ID, 거래 ID 및 보상 금액이 올바르게 해석되고 문자열로 처리되지 않는지 확인합니다(예: 실제 사용자 ID 대신
```
[USER_ID]
```
읽기).
다운스트림 처리: 200 OK를 반환했지만 유저는 보상이 없는 상태로 남아 있으면 다운스트림 프로세싱을 조사하십시오. 콜백 확인이 실제 사용자 보상 이벤트와 일치하는지 확인합니다.

최근 변경 사항 검토

콜백 오류가 갑자기 발생하면 내부 엔지니어링 로그와 비교하여 오류의 정확한 시간을 크로스 레퍼런스합니다. 다음 질문을 고려하십시오.

최근에 제품 릴리스나 설정 업데이트를 푸시?
서버 비밀 또는 인증 토큰을 교환했나요?
엔드포인트를 마이그레이션하거나 서버 인프라를 업데이트하거나 허용되는 HTTP 메서드를 변경하셨습니까?

추가 지원

이전의 모든 문제 해결 가이드를 확인했지만 콜백 실패가 계속 발생하는 경우 세일즈 담당자 지원 담당자에게 문의하여 다음 정보를 제공하십시오.

오류에 영향을 받는 특정 앱 ID
실패가 관찰된 정확한 시간
실패한 사용자 ID 또는 거래 ID 샘플링
오류 중에 캡처된 모든 관련 서버 로그 또는 HTTP 응답 본문

기술 자료

Development

User Acquisition

Monetization

산업 분야