> For the complete documentation index, see [llms.txt](https://docs.shoppego.my/tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoppego.my/tutorials/ms/integration/tracking-and-analytics/facebook/facebook-pixel/conversion-api.md).

# Conversion API

Tutorial konfigurasi Conversion API

Didalam Shoppego anda boleh membuat penetapan **Conversion API** pada **FB Pixel** anda. Dengan Conversion API ini, data yang anda akan terima melalui **FB Pixel** anda akan <mark style="color:blue;">**lebih tepat**</mark>.

{% hint style="info" %}
\*\*<mark style="color:red;">**Perhatian**</mark> : Untuk menggunakan **fungsi Conversion API** ini, ianya hanya terdapat pada **plan&#x20;**<mark style="color:red;">**Ultimate**</mark> sahaja.
{% endhint %}

## **Dapatkan Access Token**

Untuk penetapan Facebook Conversion API, anda hanya perlu masukkan sahaja **token Conversion API** pada platform Shoppego. Sangat mudah!

1. Pada bahagian pixels anda, pilih pixels yang anda ingin gunakan klik pada tab **Open in Events Manager**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-39fd5c11de92ed9cc537f1b8df753fd089ec7714%2FFSiHXv4nvG5lncAv6Hvp.png?alt=media)

2\. Seterusnya , anda akan di bawa kepada satu laman baru. Pada laman ini klik pada tab **Settings**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-0dc1c839ad0d8e006595fa796090e173c633de9c%2FivucXpjKSWqlbRZ90J3p.png?alt=media)

3\. Pada tab settings , tekan **Get Started** pada ruangan **Set up Manually.**

{% hint style="info" %}
**\*\***<mark style="color:red;">**Perhatian**</mark>**:** Jika button tidak boleh ditekan pastikan email anda telah diset pada Ads Manager.\*
{% endhint %}

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-b1d01739faebc1eef709e270556ac1f2748d8da6%2F4xpNvfEB57R50vfJVEFR.png?alt=media)

4\. Klik **Continue**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-0638c4e49c5c4b55dbd235c2f68ac12297a0e43a%2FIJAzmm5MQRmDIgucPpuk.png?alt=media)

5\. Tick pada event **Purchase** dan **Initiate checkout or Leads**. Setelah anda tick kedua-dua events tersebut anda boleh klik **Continue**

{% hint style="info" %}
Untuk laman web yang menggunakan fungsi pembelian, adalah disyorkan agar anda menggunakan event "Purchase" dan "Initiate checkout". Untuk laman web yang hanya menggunakan fungsi "Borang/Forms", adalah disyorkan agar anda menggunakan event "Leads".
{% endhint %}

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-5297d501ebcef616bc1bef14937ad7317c3b08e3%2FZrcIahwPbnHNOIVUStWl.png?alt=media)

6\. Pastikan **penetapan event details untuk event Initiate Checkout anda adalah sama seperti gambar dibawah**. Setelah anda pastikan ianya sama, anda boleh klik pada butang **Continue**

{% hint style="info" %}
Untuk event "Leads", anda masih boleh mengikuti semua parameter.
{% endhint %}

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-6fb246542716a66b0c283a6e9466c3d8c0d96c6b%2FpU0rWUpX4K7jS5oXCswQ.jpg?alt=media)

7\. Seterusnya, untuk **penetapan event details bagi event Purchase pula adalah seperti gambar dibawah**. Setelah anda pastikan ianya sama, anda boleh klik **Continue**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-649b7b9815480b4946db793bd5b8335b153aa147%2FxpFlA5F84j1RYKmbfvxp.jpg?alt=media)

8\. Pada halaman ini, anda boleh pastikan ianya sama terpapar seperti pada paparan penetapan anda. Setelah anda pastikan ianya sama anda boleh klik **Continue**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-1349ac7bb63926e0c73ff0eeaa634affc00ff359%2F4loA0sQeqIbxXPpcEawf.jpg?alt=media)

9\. Tekan **Finish** dan maka dengan itu penetapan anda telah selesai.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-7e11976c3e383bd896ba685a80b345c3cb8c7741%2FKVU2ciTEpaRxQ4sxm09Z.png?alt=media)

10\. Seterusnya, anda boleh klik semula pada tab **Settings**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-0dc1c839ad0d8e006595fa796090e173c633de9c%2FivucXpjKSWqlbRZ90J3p.png?alt=media)

11\. Dapatkan token untuk conversion API anda dengan menekan **Generate access token. Anda perlu simpan access token ini untuk penetapan didalam Shoppego.**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-67100839987eb49aa717bbac97307e8e9d18a0c4%2Fvl1PzDKHyLE2JCoX8yGA.png?alt=media)

## **Penetapan di Shoppego**

Setelah anda mendapatkan access token Conversion API. Anda dikehendaki untuk memasukkan access token tersebut ke dalam akaun Shoppego anda.

1. Log masuk pada akaun Shoppego. Klik pada **Settings** -> **General**. **Masukkan access token** anda pada **ruangan Facebook Pixel Access Token** dan klik butang **Save**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-b65b133a25a0628dc184a0e237869c5b761eef47%2Fbtd9gZu6SW0PSXTjCt4C.jpg?alt=media)

## Lakukan Test event pada penetapan

1\. Pada bahagian pixels anda, pilih pixels yang anda ingin gunakan klik pada tab **Open in** **Events Manager**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-39fd5c11de92ed9cc537f1b8df753fd089ec7714%2FFSiHXv4nvG5lncAv6Hvp.png?alt=media)

2\. Seterusnya , anda akan di bawa kepada satu laman baru. Pada laman ini klik pada tab **Test events**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-e45602e43ea3004d444aedd4ecff3e5d4f74ed95%2FZ5hGY7uYJKKkn8HvLgf2.png?alt=media)

3\. Pada ruangan tab **Test server event** anda boleh **simpan Test event code anda dengan klik pada kotak test code anda**.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-dd3ec09570e37f89bb484c527389a789f623de98%2FcEAeSdvw3gffJFfeLDen.png?alt=media)

4\. Seterusnya, anda perlu masukkan **code ini** pada penetapan didalam **Shoppego**. Anda perlu Log masuk semula kedalam akaun Shoppego anda.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-b853fc0189b34fb1d3990f5b1f53fa71deb9d384%2FlCN7aw3FznaFFoOAyya2.jpg?alt=media)

5\. Klik pada **Online store** -> **Preferences**. Letakkan **Test event code** anda pada **ruangan Facebook test\_event\_code** dan klik butang **Save**

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-ae277ac789c3858f8147d65e05f77ad43ab5b663%2FLIGt5QICVDtt1z6hg2H5.jpg?alt=media)

6\. Seterusnya , anda perlu kembali kepada **Test Events** dan masukkan domain store anda pada **Test browser events**. Setelah selesai klik pada butang **Open Website**.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-f907a3564e2632ce7e69746edfb76ee61affff5d%2FpF07CTTqfRXeGRLcHIBa.png?alt=media)

Setelah anda klik **butang tersebut** , anda akan dibawa ke **halaman website anda**. Anda boleh **refresh terlebih** dahulu untuk memastikan **event page view dapat di-trigger** pada penetapan test event anda. Jika **ianya dapat ditrigger** anda boleh meneruskan untuk **proses trigger event yang lain.**

Jika penetapan anda berjaya , pada test event anda akan menerima **events** **Initiate checkout** dan **Purchase** beserta maklumat **deduplication yang datang dari Server**.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-2966f294e1ade7852c6e7a6d3ac25513193e0f99%2FvGpe8jLJQjSP4AVM7djC.jpg?alt=media)

{% hint style="info" %}
**\*\*Setelah anda selesai membuat penetapan test event ini. Anda perlu&#x20;**<mark style="color:red;">**delete facebook test event code**</mark>**&#x20;pada penetapan Shoppego anda.\*\***
{% endhint %}
