廣告主統計SDK(TTag)

llisonly

TTag是一項統計服務，可以統計通過廣告帶來的Mini App調起量。（需要在Mini App環境中使用）。

1.接入方式

將以下代碼添加到HTML文檔的<head>中，將XXX替換為您的media_id（可以聯繫商務從平台獲取），加載完成後會自動發送調起事件完成調起量統計。

<head>
  ...
  <script src="https://tma.tonjoy.ai/sdk/ttag.browser.js?media_id=XXX">
  </script>
</head>

2.設置自定義事件（可選）

您可以使用ttag.js API來設置自定義事件。該API有一個名為ttag()的函數，語法如下：

ttag('event', '<event_name>', {
  <event_parameters>
});

其中<event_name>是事件名稱，<event_parameters>是事件參數，以鍵值對的形式編寫。

a.向JavaScript添加事件

ttag()是一個JavaScript函數，因此您需要將該函數添加到您網頁上的 JavaScript 中。例如，您可以將該函數添加到<script>標記內或您導入 HTML 網頁的單獨 JavaScript 文件中。示例如下：

<head>
    ...
    <!-- ttag.js -->
    <script
      src="https://tma.tonjoy.ai/sdk/ttag.browser.js?media_id=XXX"
    ></script>
    <script>
      ttag('set', {
        'page_title': 'Travel Destinations',
        'currency': 'USD'
      });
    </script>
</head>
<body>
    ...
    <script>
      ttag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>

b.設置事件參數

請參考以下示例：

ttag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

在此示例中：

app_name 和 screen_name 是事件參數名稱
myAppName和Home是事件參數值

c.為每個事件設置參數

上一部分中的示例使用ttag()函數中的event命令來發送一個事件參數。您還可以使用set命令，為每個事件設置參數。請將set命令置於event命令上方。

ttag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});

d.查詢事件參數

ttag.js會自動為事件參數添加campaign前綴（以campaign開頭的參數除外），示例如下：

ttag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

{
  type: 'screen_view',
  campaign_app_name: 'myAppName',
  campaign_screen_name: 'Home',
}

English：https://telegra.ph/Guide-for-Using-Advertising-Statistics-SDK-TTag-10-08