AdSense游戏广告快速启动指南 实施代码 你的播放器需要

1、AdSense游戏广告快速启动指南实施代码你的播放器需要能正确请求和返回一个AdSense游戏广告。为了完成这个步骤，你需要一个熟悉flash和actionscript脚本语言的开发人员。请确保您的播放器遵守AdSense游戏广告政策，尤其是要确保：· 广告播放没有受到阻碍或者过早地被停止· 游戏暂停和继续的功能被很好的整合；· 控制栏和进度栏不会妨碍广告的播放；· 广告在多个浏览器内都能正常显示开发者指南AdSense游戏代码分成三个主要部分：· 广告请求前设置: AdSense游戏广告的SWF库提供了一个机制来取回和播放广告在flash流里

2、面，为了取得AdSense游戏广告，你必须加载一个AS3版本的SWF库到你的flash播放器（AS2已经不被美国总部提供技术支持）.· 发起广告请求: 在发起广告请求前，你需要设置一个包含几个必要参数的广告请求对象（object），参数包括你的发布商id，描述url，还有你请求的广告类型。· 呈现广告: 一旦你实施了广告请求，系统会返回一个反馈对象（callback object）。如果广告请求成功，你将能够从反馈对象里提取出一个叫Movieclip的广告.广告前设置第一部分的代码含有两个函数。“Go”函数链接着广告请求和反馈类函数，使其能够初始化整个广告请求过程。他将加载

3、Google SWF，在加载完成的时候，自动调用sendAdRequest函数。“delegate”函数是一个辅助函数，使你能够链接播放器的类函数（例如暂停和继续）到函数onAdsRequestResult，当然它只是在AS2语言里才是必须的。以下的代码范例正确地加载了库，如果你需要将加载器移到广告请求以外，你需要在广告请求间调用Loader.unload()函数。AS3代码范例public function doGoogleVideoAd(target:MovieClip):void Security.allowDomain(""); / Prepare to load

4、Google SWF var request:URLRequest = new URLRequest("" + "pagead/scache/googlevideoadslibraryas3.swf"); var loader:Loader = new Loader(); loader.contentLoaderInfo.addEventListener(Event.COMPLETE, sendVideoAdRequest); / load Google SWF loader.load(request); addChild(loader);发起广告请求为

5、了实施AdSense游戏广告请求，你必须传入包含广告请求必要参数的对象，同时还需要指定一个广告请求结束时的反馈类函数(onAdsRequestResult).只有两个请求参数是技术上可以忽略而不会影响广告返回的。描述URL（descriptionUrl）提供了关于你游戏内容的文本或者meta数据，它将用于上下文匹配。你分配的渠道（channel）信息将允许广告商对你的网站进行定点投放。AS3广告请求范例private function sendVideoAdRequest(event:Event) _googleAds = event.target.content; / Create requ

6、est params object var request:Object = new Object(); / REQUIRED A unique, alphanumeric identifier for each game. request.contentId = "FighterGame2" / REQUIRED Your Publisher ID request.publisherId = "ca-games-test" / REQUIRED The width of the area the advert will be displayed in.

7、 request.pubWidth = "320" / REQUIRED The height of the area the advert will be displayed in. request.pubHeight = "240" / REQUIRED The type of ad to fetch. / Values are "fullscreen" or "video". request.adType = "video" / The URL of an HTML description

8、 of the game. request.descriptionUrl = "" / An array of channel strings to facilitate reporting and advertiser targeting. / These must be set up by your account manager. An array is required, but / elements are not. I.E. request.channels = ; is also valid. request.channels = "12345678

9、90", "ActionRPG" / REQUIRED Fetch an ad, specify callback method / Call this last. USE DELEGATE OR FAIL. _googleAds.requestAds(request, onVideoAdsRequestResult);参数必须参数加粗.   publisherIdStringAdSense 游戏广告ID.channelsString渠道id是一个数组，可以在帐户管理界面的渠道项目下设置。 adTypeString请求的广告类型:·

10、"video" - (视频广告)· "fullscreen" - (文字或图形全屏广告)· "text_fullscreen" - (文字全屏广告)· "graphical_fullscreen" - (图形全屏广告)  pubWidthInt定义flash播放器里广告播放的宽度.pubHeightInt定义flash播放器里广告播放的高度.contentIdString一个独立排他的字母-数字串来与单个游戏一一对应。此数值必须在各游戏间不重复，但可以在不同用户组（

11、user sessions）间重复。descriptionUrlString这个参数用来设定一个描述游戏内容的HTML页面的URL地址.他只需要包含最基本的HTML格式，我们的上下文匹配爬虫会来爬取这个页面以获得匹配的广告。maxTotalAdDurationInt指定返回视频广告的最大长度，以毫秒为单位,默认值是30000毫秒（30秒）.adTestString指定是否测试广告请求还是正式广告请求。它可以在测试期间使用以避免无效展示或点击，可能的值有: · "on" 忽略广告请求，点击和展示.· "off" - (默认)所

12、有的活动都被记录.cust_ageInt指定用户的年龄群，如果知道的话。可能的值有:· 1000 17岁及以下.· 1001 18-25.· 1002 25-35.· 1003 35-45.· 1004 45-55.· 1005 55-65.· 1006 65及以上.cust_genderInt指定用户的性别，如果知道。可能的值有:· 1 男性.· 2 女性.uniqueAdsBool如果激活，在特定flash流里面出现的广告将不会重复。uniqueAdsSlotLengthInt这个值控制一组互不重复的

13、广告的数量（假设uniqueAds为激活状态）。例如, 值为3将会返回由3个互不相同广告组成的广告组(A, B, C, A, B, C).广告请求反馈对象在flash设备（flash IDE）进行测试的时候，你可能会在输出控制台看到一个“安全沙盒违规”错误（"security sandbox violation"）.这个错误是可以预见的，因为flash影片不允许访问存于SWF起始处的特定web域以外的数据（如，AdSense游戏广告服务器） 在绝大多数情况下，这个错误并不会妨碍你在Flash IDE里面测试你的实施。然而，如果你无法显示广告，请尝试使用flash设备里的“发

14、布到HTML”（"Publish to HTML"）选项。如果你选择了发布到HTML选项，请注意你可能需要修改allowScriptAccess设置到"always" (默认值是“sameDomain”-“同一个域”，它可能会弹出一个安全提示).   AS3 请求反馈对象范例private function onVideoAdsRequestResult(callbackObj:Object):void / If an ad request is successful, display it. if (callbackObj.succ

15、ess) / REQUIRED Extract the ad movie clip. var player:MovieClip = callbackObj.ads0.getAdPlayerMovieClip(); / REQUIRED Set the size of the movie clip. player.setSize(320, 240); / REQUIRED Set the X position of the upper left corner of the ad. player.setX(0); / REQUIRED Set the Y position of the upper

16、 left corner of the ad. player.setY(0); / REQUIRED Load the ad. player.load(); / Attach method hooks as needed. player.onAdEvent = doOnAdEvent; player.disableContentControls = toggleControls; player.enableContentControls = toggleControls; / REQUIRED Play the ad. Do this last. prerollPlayer.playAds()

17、; / REQUIRED Play the ad. Do this last. player.playAds(); else / Trace an error in case parameters are missing or malformed. trace("Error: " + callbackObj.errorMsg); private function doOnAdEvent(e:String) trace("EVENT: " + e);参数successBoolean显示广告请求是否成功返回的字串.errorMsgString显示广告请求是否

18、存在错误的字串.事件引发控制disableContentControlsVoid当播放器应取消其控制时调用，应在广告回放前.enableContentControlsVoid当播放器应激活其控制时调用（在广告回放结束和进行后续活动清理时）onDestroyVoid当destroy() 类函数(如果使用)结束实施时调用.onAdEventVoid能在广告对象上建立反馈，以引发特定的播放器事件，可能的事件包括:· "click" 广告被点击时发生.· "firstQuartile" 视频广告播放了25%时发生.· "m

19、idpoint" 视频广告播放50%时发生.· "thirdQuartile" -视频广告播放75%时发生.· "completed" -视频广告播放100%时发生.· "paused" 视频广告暂停时发生.· "started" 当广告开始回放的时候发生.· "contentPauseRequested" 当游戏应该被暂停时发生 (通常针对视频广告).  · "contentResumeRequ

20、ested" 当游戏应该被继续时发生(通常在一个视频广告结束时).方式加粗表示必须的方式（methods）. getAdPlayerMovieClip()MovieClip建立一个视频播放器MovieClip来播放视频流内的广告.setX(int XPosition)Void指定flash播放器里广告的X坐标.setY(int YPosition)Void指定flash播放器里广告的Y坐标.load()Void加载广告MovieClip, 开始缓存，并使其处在暂停的状态.只有当playAds() 类函数被调用的时候才会开始回放.playAds()Void开始回放广告Movi

21、eClip.getType()String返回广告的类型，可能的值有:· "video_fullscreen" - (视频广告)· "fullscreen" - (文字或图形全屏广告)· "text_fullscreen" - (仅文字广告)· "graphical_fullscreen" - (仅图形广告)· "graphical_fullscreen_ctp" - (点击以后才播放的视频广告)destroy()Void撤销广告Moviecli

22、p，如果表示成功的参数为真，在卸载SWF库之前，必须撤销广告Movieclip.pause()Void暂停视频广告播放，继续的话用playAds().嵌入和问题解答为了使游戏中展示AdSense游戏广告，allowScriptAccess参数一定要设为“always.” 这使得系统能够探测到请求广告的页面URL，如果我们不能探测到URL，广告则不会被展示出来.我们必须能够探测页面URL来向广告商汇报他们的广告到底在哪里被展示了。页面URL也用于政策检查和改进广告的上下文匹配。如果你使用标准的html标签嵌入你的游戏播放器，你必须包含<object>和<embed>标签来

23、成功设置allowScriptAccess于IE (用<object> 标签)和Firefox (用<embed>标签).包含下划线的值是可以自定义修改的。.HTML嵌入代码范例 1 <object width="320" height="240" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" 2 id="NeedThisParam"> 3 <param name="movie" value=&

24、quot;" 4 type="application/x-shockwave-flash"></param> 5 <param name="allowScriptAccess" value="always"></param> 6 <param name="wmode" value="transparent"></param> 7 <embed src="" 8 type="applic

25、ation/x-shockwave-flash" 9 allowScriptAccess="always" 10 width="320" 11 height="240">12 </embed>13 </object>14 广告仅针对 "ca-games-test"测试帐户返回，广告并不会在所有格式都显示."ca-games-test"测试id仅对所有合法的AdSense游戏广告请求返回广告。如果你的视频播放器在测试id下工作正常，但针对自己的id却没法显示

26、，只是因为你自己的id当前没有任何匹配的广告。.广告不在所有浏览器显示广告请求对象返回一个URL为空 （NULL URL）的错误。这通常是由于嵌入不正确造成的。广告根本就不显示· 检查广告请求是不是发起了。只有当广告请求成功实施的时候，AdSense游戏广告才能被显示。检查HTTP头，确保广告请求被发起了。· 检查匹配信号。AdSense游戏广告系统应尽可能多的接受匹配信号（描述URL，页面内容和渠道描述）以投放精准匹配的广告。有时信号缺乏会导致没有广告显示.o 检查广告请求确保描述url(descriptionUrl)和网页url (page URL)参数不为空.o 如果

27、Description URL是空的，检查你的ActionScript代码确保descriptionUrl 参数被成功传递.注意所有的广告请求参数都是大小写敏感的。o 如果页面URL为空，请检查你的HTML嵌入代码以确保allowScriptAccess设为“always”，并且其能够在Firefox和IE等多个浏览器下工作· 检查是否缺损广告请求参数。AdSense游戏广告系统必须获得所有必要参数以显示广告.· 检查是否有缺损的调用在load()和playAds(). 为了显示AdSense游戏广告，你在广告MovieClip中必须调用load()和playAd

28、s().· 检查allowScriptAccess设定为“always”.· 检查是否有缺损调用在setSize() 类函数，如果setSize()类函数没有被调用，广告是不能显示的。检查你的Actionscript代码确保setSize()正确调用了你播放器的维度。· 如果你在Flash IDE里做测试，记得使用测试发布商帐户 ("ca-games-test")和广告测试参数（adtest）。他们会跳过URL探测，使你在开发阶段获得广告。我能在多少个域名上显示广告？在公开传播的游戏里放广告是允许的吗？你能够在授权用户和合作者传播的游戏内嵌入广告。然而，我们的政策