# WebSDK

## **开始使用**

要开始使用 Offer18 的 Web SDK 进行追踪，需要在网站中添加一个 script 标签。

<mark style="color:紫色;">放置位置：页眉（所有页面）</mark>

{% code fullWidth="false" %}

```html
<script src="https://web-resources.offer18.net/sdk/web/WebSDK.js"></script>
```

{% endcode %}

***

用户必须将以下代码片段添加到除订单确认/订单成功（感谢页）之外的所有落地页中。

<mark style="color:紫色;">放置位置：页眉（所有页面）</mark>

```html
<script>
    window.Offer18WebSDK.initializeConversion('<YOUR-CLICK-ID-PARAMETER>');
</script>
```

添加脚本后，需要在感谢页/订单确认页中添加以下脚本

<mark style="color:紫色;">放置位置：感谢页/订单成功页（单页）</mark>

```html
<script>
    window.Offer18WebSDK.trackConversion({
        domain: '',
        accountId: '',
        offerId: '',
        coupon:'',
        postbackType: '', // 'iframe' or 'pixel'
        isGlobalPixel: false, // true or false
        iGamingCampaign: true, // true 或 false
        allowMultiConversion: false, // true or false
        conversionData: {
            event: '', // Event Name (Please specify the event)
            payout: '', // Payout Amount (Please specify the payout amount)
            sale: '', // Sale Amount (Please specify the sale amount)
            currency: '',
            adv_sub1: '',
            adv_sub2: '',
            adv_sub3: '',
            adv_sub4: '',
            adv_sub5: '',
        },
        userActivityData: {
            'ig-user-id': '',
            'ig-deposit-amount': '',
            'ig-bet-amount': '',
            'ig-win-amount': '',
            'ig-withdrawal-amount': '',
            'ig-bonus-amount': '',
            'ig-product-id': '', 
      }
    })
</script>
```

{% tabs %}
{% tab title="对象配置 - window\.Offer18WebSDK.trackConversion()" %}

1. **domain** （必填）：用户的回传域名。
2. **accountId** （必填）：用户的 Offer18 帐号 ID。
3. **offerId** （必填）：活动的 ID。
4. **coupon ：** 此处可使用优惠券代码
5. **postbackType** : 它可以是 `'iframe'` 或 `'pixel'`，默认值为 `'iframe'`.&#x20;
6. **isGlobalPixel** ：用户可以通过设置此项来配置全局像素 `true` ，默认值为 `false`.
7. **iGamingCampaign :** 用户可以通过设置此项来配置 iGaming 回传 `true` ，默认值为 `false`.&#x20;
8. **allowMultiConversion** ：用户可以通过设置此项来允许多次转化 `true` ，默认值为 `false`.&#x20;
9. **conversionData** ：该对象包含可用于从网络获取值的参数。
10. **userActivityData** : 此对象包含可用于跟踪 iGaming 用户活动数据的参数
    {% endtab %}
    {% endtabs %}

{% hint style="info" %}
**用户 ID** (ig-user-id) 在 iGaming 回传中必须传递
{% endhint %}

#### **示例代码**

```html
<script>
    window.Offer18WebSDK.trackConversion({
        domain: 'example.o18.link',
        accountId: '0000',
        offerId: '00000000',
        iGamingCampaign: true,
        userActivityData: {
            'ig-user-id': 'Customer12',
            'ig-deposit-amount': '12',
            'ig-bet-amount': '5',
            'ig-win-amount': '5',
            'ig-withdrawal-amount': '10',
            'ig-bonus-amount': '5'
            'ig-product-id': 'ludo12', 
      }
    });
</script>
```

***

## 调试模式

要在 SDK 中启用调试模式，可以在脚本内添加以下代码：

```html
<script>
    window.Offer18WebSDK.activateDebugMode();
</script>
```

启用调试模式可让用户获得有关 SDK 工作的更详细信息，包括任何错误或调试消息。