Studio 宏退出

目标

将 Studio 信息/宏插入退出网址中。

解决方案

您可通过以下两种方法将 Studio 信息（例如广告 ID）添加到广告中：

• 通过 Studio 网页版界面在目标网址中使用 Studio 宏

• 使用 Studio API 获取 Studio 信息，同时在广告素材代码中构建查询字符串或完整网址。然后，使用 Enabler.exitQueryString(id, queryString)。

如果您使用的是动态退出网址，那么着陆页可能会重定向到其他网址。这是由着陆页服务器（而非 Studio）控制的。

设置

在将 Studio 宏添加到退出网址之前，请先参阅下图，了解有关可用的宏及其等效的 Studio API 调用的信息。如果您想直接在广告素材代码中向退出网址添加 Studio 参数，请确保有相应的 Studio API 方法能够做到这一点。否则，您就无法将 Studio 信息提取到退出网址中。

Studio 支持的宏

宏	Studio API 方法	Studio 广告服务器参数
%eadv!	Enabler.getParameter("adv");	广告客户 ID
%eaid!	Enabler.getDartAdId();	广告 ID
%ebuy!	Enabler.getParameter(“buy”);	广告系列 ID
%ecid!	Enabler.getDartCreativeId();	广告素材 ID
%epid!	Enabler.getDartPageId();	展示位置 ID
%erid!	Enabler.getDartRenderingId();	呈现 ID
%esid!	Enabler.getDartSiteId();	网站 ID
%n	无可用 API	或随机数
%p	无可用 API	模式匹配
%s	Enabler.getDartSiteName();	网站名称

 

只有通过实时代码投放广告素材时，才可以获取 Studio 信息。在 Studio 中预览时，Studio 宏会返回 0 或未解析的宏值。在 Studio 中预览或在本地测试时，等效的 Studio API 方法会返回 0、null 或 ""。

如果广告素材从外部来源（XML、JSON）提取退出网址，并且网址中包含 Studio 宏值，那么您必须在广告素材代码中使用字符串替换逻辑将广告的宏值替换为相应的 Studio API 方法。您可使用上表找出各个宏对应的 Studio API 方法。切勿在广告素材中对 Studio 宏值进行硬编码。

如果您在广告素材中对 Studio 宏值进行硬编码，那么您将无法在实时代码中将这些宏值替换成相应的 Studio 广告服务器参数。此外，如果您对 Studio 宏值进行硬编码，那么当用户点击广告素材进入目标网址时，该网址可能会在 Internet Explorer 浏览器中触发弹出式窗口拦截器。您无法在 Studio 网络界面或 DCM 中覆盖在广告素材中经过硬编码的退出网址。

示例

通过 Studio 在目标网址中使用 Studio 宏

将包含 Studio 宏数据的着陆页网址粘贴到 Studio 中的事件 > 退出标签内的目标网址字段中。

第三方重定向网址示例
在本示例中，宏用红色突出显示。

http://yourdomain.com/clk?aAgencyId=01&aSource=adsrv&aTrackDataExt=
123456;%epid!;%eaid!;%ecid!&migRandom=%n&aTrackFmtExt=client;io;ad;crtv&
aUnencodedDest=http://yourdomain.com

在广告素材代码中使用 Studio 参数，然后在 Studio 中输入基准网址

1. 请将您想向其添加参数的退出网址替换为 Enabler.exitQueryString()，而不要在广告素材代码中使用 Enabler.exit() 方法。通过这种方法，您可以在 Studio 中设置一个基准网址，并将参数附加到广告素材代码中的相应基准网址中。
2. 在 exitQueryString 方法的第二个参数中附加与每个 Studio 参数对应的 Studio API 方法。Studio HTML5 SDK 中列出了可用的方法（在页面中搜索“getDart”即可直接转到该列表）。下面是适用于 HTML5 广告素材的 JavaScript 代码示例：

   
   var adIdVar = Enabler.getDartAdId();
   var siteIdVar = Enabler.getDartSiteId();
   
   function exitHandler() {
     Enabler.exitQueryString("my exit", "adid=" + adIdVar + "&siteid=" + siteIdVar);
   }
   
   exitBtn.addEventListener('click', exitHandler, false);

3. 在事件 >“退出”事件标签内的“目标网址”字段中添加基准网址。

   例如，如果您将 http://yourdomain.com/ 用作基准网址，那么当您通过实际代码投放广告时，此广告的点击后到达网址可能会如下所示：
   
   http://yourdomain.com/?adid=123456789&siteid=12345