자체 관리형 재화

콜백 URL

<callback_url>?snuid=<user_id>&currency=<currency>&mac_address=<mac_address>//Examplehttp://www.sampledoman.com/payments/offers/tapjoy?&amp;snuid=42&amp;currency=50&amp;mac\_address=00-16-41-34-2C-A6

서버 응답

200

403

200

403

부정 행위 감지 및 예방을 위한 선택적 파라미터

secret_key=

id

currency_id

request_id

verifier

항상 조심해야 할 부정 행위 시나리오

• ID가 재사용되거나 검증자가 잘못된 경우, 해당 콜백 URL은 탭조이에서 전송된 것이 아니므로 사기로 간주해야 합니다.
• 사용자 ID가 오직 정수만으로 구성되어 있다면, 사용자 ID가 조작되지 않았는지 확인하기 위한 간단한 검증을 수행할 것을 권장합니다. 예를 들어, 탭조이는 “001234”와 “1234”를 서로 다른 두 개의 사용자 ID로 간주하지만, 백엔드 서버 로직에서는 그렇지 않을 수 있습니다.

검증자

Digest::MD5.hexdigest("#{id}:#{snuid}:#{currency}:#{secret_key}")

콜백 URL 개선

{   "cp": "some_string",  "currency": {    "currency_sale": "1.0",    "id": "reward_id",    "reward": 100  },  "id": "some_id",  "offer": {    "advertiser_app_name": "a_cool_app",    "currency": {      "max_reward_value": 1360    },    "expires_at": 1768175428,    "icon_url": "some_URL/icon.jpg",    "name": "eye_catching_headline",    "task":{      "is_iap": false,      "name": "event_name"    },    "type": ""  },  "placement":{    "content_type": "offerwall",    "name": "placement_name"  },  "rev": 100,  "timestamp": 1762993750,  "user": {    "id": "user_id"  }}

id

rev

cp

currency.id

currency.reward

currency.currency_sale

currency.max_reward_value

offer.name

offer.type

offer.icon_url

offer.advertiser_app_name

offer.task.name

offer.task.is\_iap

offer.expires_at

placement.name

placement.content_type

user.id

timestamp

HMAC_SHA-256(<Request-Body>,<Secret-Key>)

X-Tapjoy-Signature => 7205ccfdfa1fe28cd05a1b56a9508d898cc938aa555a6c18848097fe4ee0975b

cp

사용자 ID

snuid

setUserID

// Recommended approach using connect flagNSDictionary *connectFlags = @{TJC_OPTION_USER_ID : @"<USER_ID_HERE>"};[Tapjoy connect:@"SDK_KEY_GOES_HERE" options:connectFlags];// Setting the user id directly[Tapjoy setUserIDWithCompletion:@"<USER_ID_HERE>" completion:^(BOOL success, NSError *error) {}];

사용자 잔액 설정

TJPlacement *placement = [TJPlacement placementWithName:@"placementName" delegate:nil]; [placement setBalance:100 forCurrencyId:@"1234" withCompletion:^(NSError * _Nullable error) { if (error != nil) { //Failure NSString *message = error.localizedDescription; } else { //Success } }]; 

필수 금액

TJPlacement* placement = [TJPlacement placementWithName:@"placementName" delegate:nil]; placement setRequiredAmount:100 forCurrencyId:@"1234" withCompletion:^(NSError * _Nullable error) { if (error != nil) { //Failure NSString *message = error.localizedDescription; } else { //Success } } ``` </Tab><Tab title="iOS (Swift)"> ```swift let placement = TJPlacement(name: "placementName", delegate: nil) placement?.setRequiredAmount(100, forCurrencyId: "1234", withCompletion: { error in if let error = error { //Failure let message = error.localizedDescription } else { //Success } }) 

보상 콜백 IP 화이트리스트

18.215.207.8918.235.142.16523.20.255.11323.23.134.1653.210.188.323.215.42.1403.217.209.1773.218.95.353.219.236.533.231.137.161

탭조이 관리형에서 자체 관리형으로 전환

• 새 SDK 키로 새 앱을 생성해야 합니다. 이렇게 하면 최신 버전으로 업그레이드하지 않은 이전 버전 앱 사용자에게 영향을 미치지 않습니다. 셀프 관리형 재화 버전의 앱에 동일한 SDK 키를 사용하면, 탭조이 관리형 재화 버전의 모든 사용자가 오퍼 완료 시 보상을 받지 못하게 됩니다.
• 기존 앱 ID를 참조하는 모든 광고 캠페인을 비활성화하고, 새 앱 ID를 참고하도록 광고 캠페인을 재구성해야 합니다.
• 자체 관리형으로 전환하려면 앱에서 코드를 변경해야 합니다. getCurrencyBalance, awardCurrency, spendCurrency는 관리형 재화에서만 사용 가능하므로 사용할 수 없습니다.
• 변경을 고려하기 전에 세일즈 담당자에게 문의하는 것이 좋습니다.
• 자체 관리형 재화에서 탭조이 관리형 재화로의 전환은 불가능합니다. 변경을 진행하기 전에 반드시 전환 의사를 확인하시기 바랍니다.

1. 첫 실행 시 기존 SDK 키(탭조이 관리형 재화 사용)로 getCurrencyBalance 호출하여 잔액을 조회합니다.
2. getCurrencyBalance에서 반환된 값으로 잔액을 업데이트합니다.
3. 이후 모든 실행에서는 새 SDK 키를 사용합니다.