apps with adscdn.touchdevelop.com/c03/aezp-appswithads.pdf · 2012-06-05 · apps with ads overview...

Last changed: 6/2/2012 1 http://www.touchdevelop.com

apps with ads

overview

introduction When you turn your TouchDevelop scripts into apps that can be found in and installed from the

Windows Phone Marketplace, one way to make more money is by integrating ads into your Windows

Phone applications. Microsoft Advertising pubCenter is the only supported ad provider.

requirements To must follow all the regular steps to generate an app from a script when you want to integrate

advertisements. Your application needs to pass the Windows Phone 7 certification process before it can

be published to the Windows Phone 7 Marketplace. In addition to the regular requirements, you need

the following to integrate ads:

A Microsoft Advertising pubCenter account.

workflow

The following is a typical workflow to publish an application built with touchdevelop. The additional

steps necessary to integrate ads are highlighted in bold.

1. Install the touchdevelop app on your phone.

2. Log in to the touchdevelop app on your phone.

3. Write a script in the touchdevelop app. Make sure to check show advertisement in the script

properties.

4. Publish the script from the touchdevelop app.

5. Post at least one screenshot of your touchdevelop app.

6. Wait until at least three touchdevelop users give your script a ♥.

Feel free to ask your friends to review your script.

7. Sign up with Microsoft Advertising pubCenter.

8. Register your upcoming application to obtain a pubCenter application id and an ad unit id.

9. Log in to the touchdevelop website.

10. Provide additional information about your script on the touchdevelop website, including the

pubCenter application id and ad unit id.

11. From the touchdevelop website, download the app binary and at least one screenshot of your

script.

12. Register as a Windows Phone 7 app developer on App Hub.

(You may have to pay a fee. If you are a student, the fee might be waived. Read more below.)

13. (Optional) If you have developer-unlocked your phone, you can side-load the app on your

phone. Your app works even if you don’t have touchdevelop installed on your phone. Try your

turning scripts into apps


app to see if it’s ready for submission. (You can also install the generated app on the Windows

Phone emulator that comes with the Windows Phone SDK. However, advertisements may not

work in the emulator, but only when the app is deployed on an actual Windows Phone device. )

14. Submit the downloaded app binary on App Hub to the Windows Phone 7 Marketplace.

You will be asked to provide more information about your app, including its price.

15. If your app passes the standard app certification process, you can publish your app on the

Windows Phone 7 Marketplace.

script to app with ads

preparing your script Showing ads in your app will take up some space on the screen. In order to reserve this space, and to

enable you to make sure that your graphics work well with ads, you have to enable ads in the script

properties.

Open the script properties by tapping on the script title information in the TouchDevelop app.

In the script properties, check show advertisement.



When you run your script now in TouchDevelop, you will see the reserved space:



You must follow the above steps before you publish the final version of your script.

sign up for pubCenter and register your application If you have not yet signed up for pubCenter, you will have to do so. Go to

http://pubcenter.microsoft.com to get started.

http://pubcenter.microsoft.com/



As part of the sign up process, or as a separate step later if you already have signed up, you register your application, create an add unit, and choose ad categories.

About ad units: An ad unit is a space set aside in an application or web page where ads will appear. Ad units can contain one or more ads, and are available in many different formats. Ad units can be constrained to their borders or can expand to display more content to the user.

You can choose any name you like for “Ad unit name”. As the “Ad unit size”, choose “480x80 XX-Large banner”.



After you save all information, you will be shown a generated application id, and a generated ad unit id, similar to the following. Take note of your values.

your script on the web

When you publish your script, it gets a unique identifier and a corresponding page on the

touchdevelop website. Go to your script’s page. If it has three or more ♥, and you are logged in

Application ID:

01234567-1234-abcd-abcd-0123456780ab

Ad Unit ID:

12356789

To enable this ad unit in your application, insert this ad unit ID and application ID into your

code as explained in the Microsoft Advertising SDK.

http://go.microsoft.com/fwlink/?LinkId=217018&clcid=0x409



on the website, get the option to create an app:

Click the get started with your app… button.

step 1: app settings – enter additional information to customize your app

Now you have to fill in additional information about your app. All items marked by * are

required for all Windows Phone 7 apps.

If you checked show advertisement earlier in the script properties, then you will see the

following paragraph added to the privacy notice of your app:



You will need to fill in the following two “api keys”:

Fill in the ids you obtained earlier from the pubCenter.

Please read the License Terms of the Advertising SDK, and check the box if you agree.



In order to finish the process of creating an app, follow the general instructions of how to turn

your script into an app on https://www.touchdevelop.com/help/wp7app.

frequently asked questions

can I try my generated app in the emulator?

You can install the generated app binary (.xap) on the Windows Phone emulator that comes with the

Windows Phone SDK. However, advertisements may not work in the emulator, but only when the app is

deployed on an actual Windows Phone device.

where can I ask more questions?

We monitor the following channels:

Post a question in the forum in the touchdevelop app on your phone

Ask a question on the touchdevelop page on Facebook at facebook.com/touchdevelop

Send an email to the touchdevelop Team at [email protected]

Disclaimer: This document is provided “as-is”. Information and views expressed in this document, including URL and other Internet

Web site references, may change without notice. You bear the risk of using it.

This document does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and

use this document for your internal, reference purposes.

© 2012 Microsoft Corporation. All rights reserved. Microsoft, Windows, and Windows Live are trademarks of the Microsoft group of

companies. All other trademarks are property of their respective owners.

https://www.touchdevelop.com/help/wp7app

http://facebook.com/TouchDevelop

http://www.facebook.com/TouchDevelop

mailto:[email protected]

apps with adscdn.touchdevelop.com/c03/aezp-appswithads.pdf · 2012-06-05 · apps with ads overview...

Documents

Transcript of apps with adscdn.touchdevelop.com/c03/aezp-appswithads.pdf · 2012-06-05 · apps with ads overview...