[Paid] Tapjoy Offerwall Ads Extension (SDK 14.3.0)

Extensions
, , ,
1

🧩 TapjoyOfferWall

An extension to monetize your application with Tapjoy Offferwall ads.

image
image1020×331 5.66 KB

:memo: Specifications

:package: Package: com.jewel.tapjoyofferwall
:floppy_disk: Size: 779.75 KB
:money_bag: Price: 10 USD
:gear: SDK Version: 14.3.0
:mobile_phone: Minimum API Level: 21
:date: Released On: 2025-05-06T18:00:00Z
:japanese_application_button: Beta Tester: @luishandy305
:white_check_mark: Premium Subscription: Required
:laptop: Built & documented using: FAST v3.2.2
:handshake: Supported builders: Kodular, AppInventor & others.
:credit_card: Payment methods: Download | Wise | Xoom | PayPal | Binance | Crypto | UPI (:india:) | JazzCash (:pakistan:) | Bkash (:bangladesh:)

Demo blocks

blocks (2)
blocks (2)1503×689 83.2 KB

Testing video

I’ve showed only the test Offerwall.

Events:

TapjoyOfferWall has total 20 events.

ConnectSuccess

Indicates the SDK has successfully connected to the Tapjoy servers.

ConnectSuccess_Event

ConnectWarning

If we connect successfully but there is a non-blocking issue ConnectWarning will fire first. Currently this feature will only detect issues with UserId when sent in ConnectFlags.

ConnectWarning_Event

Parameter Type
code number
message text

ConnectFailure

If we cannot connect to the servers successfully, ConnectFailure will fire.

ConnectFailure_Event

Parameter Type
code number
message text

ContentDismiss

Triggered when the content is dismissed.

ContentDismiss_Event

Parameter Type
placement any

ContentReady

This is called when the content is actually available to display.

ContentReady_Event

Parameter Type
placement any

ContentShow

Triggered once the content shown.

ContentShow_Event

Parameter Type
placement any

PurchaseRequest

Called when user clicks the product link in IAP promotion content. Put the code that actually triggers the IAP here.

PurchaseRequest_Event

Parameter Type
placement any
requestId text
token text
productId text

RequestFailure

Triggered if failed to fetch content.

RequestFailure_Event

Parameter Type
placement any
code number
message text

RequestSuccess

This just means the SDK has made contact with Tapjoy’s servers. It does not necessarily mean that any content is available.

RequestSuccess_Event

Parameter Type
placement any

RewardRequest

Called when the content closed in reward content.

RewardRequest_Event

Parameter Type
placement any
requestId text
token text
itemId text
quantity number

ShowFailure

Triggered if the content is failed to show.

ShowFailure_Event

Parameter Type
placement any
message text

GotEarnedCurrency

Get notifications whenever Tapjoy currency is earned.

GotEarnedCurrency_Event

Parameter Type
currencyName text
balance number

GotCurrencyBalance

You will be notified with the currency balance.

GotCurrencyBalance_Event

Parameter Type
currencyName text
balance number

CurrencyBalanceFailure

You will be notified of an error condition.

CurrencyBalanceFailure_Event

Parameter Type
message text

SpendCurrencyResponse

You will be notified with the currency balance.

SpendCurrencyResponse_Event

Parameter Type
currencyName text
balance number

SpendCurrencyResponseFailure

You will be notified of an error condition.

SpendCurrencyResponseFailure_Event

Parameter Type
message text

AwardCurrencyResponse

You will be notified about the currency balance in the completion block, with the parameter currencyName providing the name of the currency and amount providing the user’s balance.

AwardCurrencyResponse_Event

Parameter Type
currencyName text
balance number

AwardCurrencyResponseFailure

You will be notified of an error condition.

AwardCurrencyResponseFailure_Event

Parameter Type
message text

UserIdSetSuccess

User id set is successful.

UserIdSetSuccess_Event

UserIdSetFailure

Failed to set user id.

UserIdSetFailure_Event

Parameter Type
code number
message text

Methods:

TapjoyOfferWall has total 15 methods.

Connect

The Tapjoy connect call is extremely important, as none of Tapjoy’s products or functionality will work if it is not implemented correctly.

Connect_Method
Connect_Method459×105 9.52 KB

Parameter Type
userId text
sdkKey text
logLevel TapjoyLogLevel (helper blocks)
  • Enums for TapjoyLogLevel: Debug, Info, Error, Warning

RequestContent

Be sure the Placement name string in your code matches the Placement name in the dashboard exactly. Before you request content please ensure that the Tapjoy connect call has succeeded. Do not make a request before you have received the ConnectSuccess callback.

RequestContent_Method

Parameter Type
placementName text
entryPoint TapjoyEntryPoint (helper blocks)
  • Enums for TapjoyEntryPoint: Default, Unknown, Other, MainMenu, Hud, Exit, Fail, Complete, Inbox, Init, Store

IsContentAvailable

Please note that IsContentAvailable means that there is an ad available, but that does not mean it has finished downloading.

IsContentAvailable_Method

  • Return type: boolean
Parameter Type
placement any

IsContentReady

Returns true if it has finished loading.

IsContentReady_Method

  • Return type: boolean
Parameter Type
placement any

ShowContent

Show the content if its ready.

ShowContent_Method

Parameter Type
placement any

GetCurrencyBalance

We recommend calling CurrencyBalance as often as possible so the user’s balance is always up-to-date. Common places to check the user’s balance are when the app launches, when the app resumes, when Tapjoy views close, and when placement content disappears.

GetCurrencyBalance_Method

SpendCurrency

Spend some amount of virtual currency of a user.

SpendCurrency_Method

Parameter Type
amount number

AwardCurrency

Award some amount of virtual currency of a user.

AwardCurrency_Method

Parameter Type
amount number

PrivacyPolicy

Configure the privacy policy.

PrivacyPolicy_Method
PrivacyPolicy_Method511×130 18.2 KB

Parameter Type
subjectToGdpr TapjoyPrivacyStatus (helper blocks)
userConsent TapjoyPrivacyStatus (helper blocks)
belowConsentAge TapjoyPrivacyStatus (helper blocks)
usPrivacy text
  • Enums for TapjoyPrivacyStatus: True, False, Unspecified

StartSession

Start a new session.

StartSession_Method

EndSession

End the current session.

EndSession_Method

ClearUserTags

Clear user tags.

ClearUserTags_Method

DismissContent

Dismiss the content manually.

DismissContent_Method

TrackPurchase

Track a purchase.

TrackPurchase_Method

Parameter Type
currencyCode text
price number

GetPlacementName

Get placement name from a placement object.

GetPlacementName_Method

  • Return type: text
Parameter Type
placement any

Setters:

TapjoyOfferWall has total 8 setter properties.

UserId

Set user id.

UserId_Set_Property

  • Input type: text

AddUserTag

Set user tag. Provide comma separated values if you want to set multiple tags.

AddUserTag_Set_Property

  • Input type: text

RemoveUserTag

Remove a user tag.

RemoveUserTag_Set_Property

  • Input type: text

CustomParameter

Set custom parameter.

CustomParameter_Set_Property

  • Input type: text

UserLevel

By setting various user properties, such as level, you can automatically get powerful analytics insights from the Tapjoy dashboard. This will let you see charts in the Game Trend section of the Analytics dashboard.

UserLevel_Set_Property

  • Input type: number

MaxUserLevel

You can tell Tapjoy how many levels there are in your game. You can set this value before or after calling connect.

MaxUserLevel_Set_Property

  • Input type: number

UserSegment

You can identify users as part of a segment. This can be set before or after calling connect.

UserSegment_Set_Property

  • Input type: TapjoyUserSegment
  • Helper type: TapjoyUserSegment
  • Helper enums: NonPayer, Payer, Vip, Unknown

OptOutAdvertisingID

This flag can be set any time, before or after connect, and can be changed at any time during the session.

OptOutAdvertisingID_Set_Property

  • Input type: boolean

Getters:

TapjoyOfferWall has total 13 getter properties.

SdkVersion

Returns the SDK version.

SdkVersion_Get_Property

  • Return type: text

IsConnected

Returns true if the SDK is connected.

IsConnected_Get_Property

  • Return type: boolean

GetUserId

Returns the user id.

GetUserId_Get_Property

  • Return type: text

GetUserTags

Get user tags in comma separated values.

GetUserTags_Get_Property

  • Return type: text

GetCustomParameter

Return the custom parameter.

GetCustomParameter_Get_Property

  • Return type: text

GetUserLevel

Returns the user level.

GetUserLevel_Get_Property

  • Return type: number

GetUserMaxLevel

Returns the user max level.

GetUserMaxLevel_Get_Property

  • Return type: number

GetUserSegment

Returns the user segement.

GetUserSegment_Get_Property

  • Return type: text

GetOptOutAdvertisingID

Get OptOutAdvertisingID.

GetOptOutAdvertisingID_Get_Property

  • Return type: boolean

GetSubjectToGDPR

Get SubjectToGDPR.

GetSubjectToGDPR_Get_Property

  • Return type: text

GetUserConsent

Get UserConsent.

GetUserConsent_Get_Property

  • Return type: text

GetBelowConsentAge

Get BelowConsentAge.

GetBelowConsentAge_Get_Property

  • Return type: text

GetUsPrivacy

Get USPrivacy string.

GetUsPrivacy_Get_Property

  • Return type: text
2 Likes