Testing an Ad on a Device

Explains how to install iAd Tester to test ads on iOS devices.

Installing iAd Tester

Before you can do any testing on a device, you must install iAd Tester on it.

To obtain the iAd Tester app:

Download and install iAd Producer from the iOS Dev Center at https://developer.apple.com/iad/iadproducer/ .

Locate iAd Producer.app in /Applications/ .

Control-click (right-click) on iAd Producer.app and select Show Package Contents.

Locate iAdTester.app in iAd Producer.app/Contents/SharedSupport/iAdTester/Device .

To install iAd Tester on a device

After you have installed the latest iAd Producer, locate the iAd Tester app on your computer.

Make sure you have the latest version of iTunes installed on your computer by performing a Software Update check from the Apple menu.

Drag iAdTester.app to either the iTunes Dock icon or to the Library panel in an open iTunes window.

Note: If you have already installed a version of iAd Tester, there will be a warning dialog asking whether you would like to replace it. If so, click Replace.

With your device connected to the computer, make sure the iAd Tester app is checked in the Apps pane for the device.

Click Apply to sync apps.

After you’ve installed iAd Tester on your device, you can test ads that you've uploaded to the iAd Creative Management Sandbox. You can also use iTunes File Sharing to test an exported ad on your device.

Testing an Ad in the iAd Creative Management Sandbox

Testing an ad that you’ve uploaded to the iAd Creative Management Sandbox simulates the real-world environment, giving you the best approximation of the user’s actual experience.

After you upload a rich media ad bundle to the iAd Creative Management Sandbox and receive staging ad URLs from Apple, you can test the ad on your device.

Important: You must be a registered iAd developer—and your iAd account must be enabled for testing—before you can upload a rich media ad bundle to the iAd Creative Management Sandbox. To determine whether your account is enabled for testing, contact your iAd Account Manager.

To test an ad in the iAd Creative Management Sandbox

To launch the app, tap the iAd Tester app icon on the Home screen.

Note: If this is the first time you’ve opened iAd Tester on your device, you will see a dialog asking you to confirm your intention. Tap Continue. iAd Tester opens the iAd Library page.

In the confirmation email you received from the iAd Creative Management portal, tap on one of the links.

iAd Tester displays the ad’s banner in the placeholder app UI.

Testing an Exported Ad

You can use iTunes File Sharing to transfer an ad from your Mac to a device for testing.

Important: Testing your ad on a local device will not expose any common performance issues associated with the over-the-air environment. All quality assurance efforts should be done with the ad uploaded to the iAd Creative Management Sandbox prior to certification submission.

To test an exported ad on your device

In the Finder, locate your ad bundle compressed zip file.

Connect your device to the computer.

In iTunes, select the device and click the Apps tab.

In the File Sharing area at the bottom of the iTunes window, select iAd Tester in the Apps pane.

Drag the compressed ad project to the iAd Tester Documents pane and sync your device.

Another way to add the file to the pane is to click the Add button at the bottom of the iAd Tester Documents pane, navigate to the compressed ad project, and click Choose.

On your device, tap the iAd Tester app icon on the Home screen.

Note: If this is the first time you’ve opened iAd Tester on your device, you will see a dialog asking you to confirm your intention. Tap Continue. iAd Tester opens the iAd Library page.

In the iAd Library page, tap On My Device to see a list of exported ads that you’ve synced to your device.

To open an ad, tap the name of the exported ad project in the list.