TJPlacement Class Reference

Inherits from NSObject
Declared in TJPlacement.h

Overview

The Tapjoy placement-Based Framework allows one to identify key placements within their application during development, and then reconfigure them on the dashboard as desired to help maximize monetization and engagement, without the need to update or resubmit the application.

Use the TJPlacement class to define placement points in your application where ads and other content can be served. placements could include launching the application, completing an achievement, finishing a level, or any other moment conducive to communicating with your users.

During your application development process, the key steps are to:

  1. Create and configure each placement as a TJPlacement

    TJPlacement *placement = [TJPlacement placementWithName: @"level_complete" delegate: self];
    
  2. Request content

    [placement requestContent];
    
  3. Present any content that is returned by the placement callbacks defined in TJPlacementDelegate

  delegate

The TJPlacementDelegate used to handle responses that are received upon sending this placement

@property (nonatomic, weak) id<TJPlacementDelegate> delegate

Discussion

The TJPlacementDelegate used to handle responses that are received upon sending this placement

Declared In

TJPlacement.h

  videoDelegate

The delegate that implements the TJPlacementVideoDelegate protocol

@property (nonatomic, weak) id<TJPlacementVideoDelegate> videoDelegate

Discussion

The delegate that implements the TJPlacementVideoDelegate protocol

Declared In

TJPlacement.h

  placementName

The name of the placement

@property (nonatomic, copy) NSString *placementName

Discussion

The name of the placement

Declared In

TJPlacement.h

  contentReady

Whether content has been loaded and is ready to be presented

@property (nonatomic, assign, readonly, getter=isContentReady) BOOL contentReady

Discussion

Whether content has been loaded and is ready to be presented

Declared In

TJPlacement.h

  contentAvailable

Whether content is available for this placement

@property (nonatomic, assign, readonly, getter=isContentAvailable) BOOL contentAvailable

Discussion

Whether content is available for this placement

Declared In

TJPlacement.h

  presentationViewController

The UIViewController to show the content in

@property (nonatomic, retain) UIViewController *presentationViewController

Discussion

The UIViewController to show the content in

Declared In

TJPlacement.h

  topViewControllerClassName

Allows plugins to specify a topViewController class (currently only used by Unity)

@property (nonatomic, copy) NSString *topViewControllerClassName

Discussion

Allows plugins to specify a topViewController class (currently only used by Unity)

Declared In

TJPlacement.h

+ placementWithName:delegate:

Creates a new instance of TJPlacement

+ (id)placementWithName:(NSString *)placementName delegate:(id<TJPlacementDelegate>)delegate

Parameters

placementName

The name of the placement

delegate

The class that implements the TJPlacementDelegate protocol

Discussion

Creates a new instance of TJPlacement

Declared In

TJPlacement.h

– requestContent

Sends the placement request to the server

- (void)requestContent

Return Value

n/a

Discussion

Sends the placement request to the server

Declared In

TJPlacement.h

– showContentWithViewController:

Shows the content that was received from the server after sending this placement

- (void)showContentWithViewController:(UIViewController *)viewController

Return Value

n/a

Discussion

Shows the content that was received from the server after sending this placement

Declared In

TJPlacement.h

+ dismissContent

Dismiss the content

+ (void)dismissContent

Return Value

n/a

Discussion

Dismiss the content

Declared In

TJPlacement.h

  mediationAgent

Mediation params(used by mediation adapters only)

@property (nonatomic, copy) NSString *mediationAgent

Discussion

Mediation params(used by mediation adapters only)

Declared In

TJPlacement.h

  auctionData

Programmatic mediation

@property (nonatomic, copy) NSDictionary *auctionData

Discussion

Programmatic mediation

Declared In

TJPlacement.h

  isLimited

Used by limited SDK request Only *

@property (nonatomic, assign) BOOL isLimited

Discussion

Used by limited SDK request Only *

Declared In

TJPlacement.h