淘点金代码的使用说明文档HTML部署教程

       淘点金取“点石成金”之意，定位为网站类非广告位流量管理和变现工具。通过API+TAG+API.JS的方式，将各类网站媒体的“泛电商内容”和“碎片化流量”管理起来，为各类网站媒体提供情景化的购物内容，满足网站媒体自身用户的潜在购物需求，同时在不占用网站媒体的正常广告位的前提下为其提供额外的收益能力。

       淘点金是一个傻瓜式的淘宝客推广方式，站长只需要在网站上部署淘点金推广代码，就可以帮助站长将网站上的各种淘宝链接转换成可推广的淘宝客链接或淘宝客模块，简单方便的获得更多收益，而不需要费心在网站上部署淘宝客链接。

      可转换链接的范围：淘宝及天猫商品链接、淘宝及天猫的店铺链接、淘宝及天猫的店铺活动链接、淘宝及天猫的搜索链接、天猫及淘宝B2C平台（天猫、淘宝旅行、淘宝游戏、聚划算等）的活动链接等。随着未来淘点金推广产品的升级，未来将支持更多更丰富的推广形式。

       未来，淘点金将提供更多的标签类型，支持更多的碎片化流量场景。

　　淘宝联盟最初推出淘点金推广时，在后台联盟产品里可以直接看到“淘点金推广”，只要把淘点金代码部署到网页中，任何含有淘点金的代码的网页都可以自动的将淘宝、天猫的链接转化为淘宝客推广链接，而不需到后台一个一个的取推广链接。但是后来“淘点金推广”消失了。

　　2015年初，淘点金升级到2.0，很多淘宝客发现即使部署了淘点金代码，链接仍不会转化。

　　实际上，升级后的淘点金仍然支持链接转化的，只是比之前复杂了点，需要在链接前加一个点击组件的标签。即新的淘点金代码由两部分组成：组件JS+点击组件标签。

　　第一部分：组件JS，部署在网页</body>标签之前即可。相比之前的增加了一个type:click参数，如果没有这个则无法实现点击链接转化。升级到新代码会兼容点击组件和展示组件。

<script type="text/javascript">
    (function(win,doc){
        var s = doc.createElement("script"), h = doc.getElementsByTagName("head")[0];
        if (!win.alimamatk_show) {
            s.charset = "gbk";
            s.async = true;
            s.src = "http://a.alimama.cn/tkapi.js";
            h.insertBefore(s, h.firstChild);
        };
        var o = {
            pid: "mm_XXX_XXX_XXX",/*推广单元ID，用于区分不同的推广渠道*/
            appkey: "",/*通过TOP平台申请的appkey，设置后引导成交会关联appkey*/
            unid: "",/*自定义统计字段*/
            type: "click" /* click 组件的入口标志 （使用click组件必设）*/
        };
        win.alimamatk_onload = win.alimamatk_onload || [];
        win.alimamatk_onload.push(o);
    })(window,document);</script>

　　第二部分：点击组件标签。组件标签放到通用的<a></a>标签中执行，会识别以下属性类型，Isconvert=1是所有的必须属性参数，没有该属性不会进行链接转化。

　　1、普通链接直接转换为推广链接的，该链接指的是普通a标签href中的链接。必选参数：isconvert=1，是代表要将该链接转化为推广链接，没有该属性则不予转化。支持转化的链接类型有：单品、店铺、活动、爱淘宝链接（不包含二跳页面）

　　例举：

　　宝贝单品链接转化：

<a isconvert=1 href="http://detail.tmall.com/item.htm?id=39643552932" target=_blank>宝贝说明</a>

　　店铺链接转化：

<a isconvert=1 href="http://handuyishe.tmall.com/" target=_blank>店铺说明</a>

       活动链接转化（需要有对应页面的跨店结算权限才可以计入结算）：

<a isconvert=1 href="http://www.tmall.com/go/market/promotion-act/foodcny.php" target=_blank>活动说明</a>

　　爱淘宝链接转化：

<a isconvert=1 href="http://ai.taobao.com/style/index.htm" target=_blank>爱淘宝搭配</a>

　　其他类型链接：

<a isconvert=1 href="http://trip.taobao.com" target=_blank>淘宝旅行</a>

　　2、商品店铺ID转换为推广链接的。必选参数：isconvert=1，没有该属性不会进行链接转化。

　　举例：

　　宝贝单品ID转化为推广链接：

<a isconvert=1 data-itemid="22074980066" target=_blank>宝贝说明</a>

　　店铺ID转化为推广链接：

<a isconvert=1 data-sellerid="2229898" target=_blank>店铺说明</a>

        3、支持关键词转化为推广链接：

<a isconvert=1 data-keyword="南瓜泥" target=_blank>关键词说明</a>

　　 通俗说明

        升级后的淘点金如果想实现淘宝、天猫链接自动转化为淘宝客链接，部署JS代码后还必须在链接的<a>标签中加入参数“isconvert=1”。虽然操作比以前多了一步，繁琐了点，但无形中也给了文章发布者选择权，加入了isconvert=1的链接转化，没加入的就不转化。

        当然，新的代码给论坛站长就造成了困扰，尤其是发帖量比较大的论坛，不可能去一篇一篇帖子的手工去加，此时就只能借助模板或者插件来自动添加了。

      特别注意：淘点金代码在对应授权的域名下才能生效，本地或者不对应域名都不生效！