檢視 TAmedia Tracking Guide ZHTW 的原始碼

= TAmedia Tracking 嵌入說明文件 =

本文說明如何在網站中整合 TAmedia 提供的追蹤碼，包括基底追蹤碼、頁面瀏覽事件、自訂事件，以及注意事項。

----

== 一、基底追蹤碼嵌入 ==

=== 插入位置 ===

請將以下程式碼放置於 <code>&lt;head&gt;</code> 標籤內，並'''緊貼 <code>&lt;/head&gt;</code> 標籤上方'''。  
若頁面內已經有相同的程式碼，'''不需要重複插入'''。

此段為 TAmedia 的追蹤主程式，會自動載入所需的追蹤工具（pixel.js）。

<source lang="html">
<script type="text/javascript">
(function(a,e,f,g,b,c,d){a.taq||(a[b]=a[b]||function(){a[b].q.push(arguments);a[b].tamTrackSendStatus&&a[b].tamTrackSendStatus()},a[b].q=a[b].q||[],c=e.createElement(f),d=e.getElementsByTagName(f)[0],c.async=1,c.src="https://adc.tamedia.com.tw/tr/"+g,d.parentNode.insertBefore(c,d))})(window,document,"script","pixel.js","taq");
</script>
</source>

----

== 二、頁面瀏覽事件 ==

=== 觸發時機 ===

當使用者瀏覽頁面時，請執行以下程式碼以送出對應事件。

此段會記錄使用者造訪特定頁面的行為，送出 <code>ViewContent</code> 事件。

<source lang="html">
<script type="text/javascript">
  taq('track', '{your-campaign-id-goes-here}', 'ViewContent');
</script>
</source>

----

== 三、自訂事件追蹤 ==

=== 自訂事件用途 ===

當網站上發生特定操作（如：完成註冊、按下特定按鈕、成功送出表單）時，可執行下列程式碼以記錄該事件。

<code>{your-event-name-goes-here}</code> 是自訂事件名稱（如 <code>Customer00001</code>）依每個專案不同，需由 TAmedia 預先設定。

這段程式碼可記錄自訂的行為事件，事件名稱須與 TAmedia 系統中的設定一致。

<source lang="html">
<script type="text/javascript">
  taq('trackCustom', '{your-campaign-id-goes-here}', '{your-event-name-goes-here}');
</script>
</source>

----

== 附註 ==

* 所有事件的識別碼 <code>'{your-campaign-id-goes-here}'</code> 請依專案來設定。
* <code>taq</code> 物件必須在基底追蹤碼執行後才可呼叫，否則可能會發生錯誤。
* 若需追蹤多個不同事件，可重複使用 <code>taq('trackCustom', ...)</code> 並更換事件名稱。
* 若需確認追蹤是否成功，請聯繫 TAMedia 技術團隊協助提供報表或進行驗證。

----

'''聯絡方式'''  
如需進一步整合支援，請聯絡 TAmedia 技術支援團隊。