Modul Meta Ads

Edisi Terkini 2026

Panduan Meta Ads & API Automation Dari Sifar

"Dari Butang Klik Hingga Token Kekal & Integrasi AI Agent Melalui MCP: Panduan Praktikal Untuk Orang Bukan Teknikal"

Prakata & Cara Guna Ebook Ini

Modul ini ditulis khas untuk usahawan, pelajar, dan sesiapa sahaja yang tiada latar belakang pengaturcaraan (non-technical).

Banyak tutorial di internet terlalu teknikal dan mengelirukan — menggunakan istilah seperti endpoint, OAuth, payload, webhook tanpa menerangkan di mana letaknya butang sebenar di skrin.

Dalam modul ini, anda akan dipimpin langkah demi langkah (click-by-click):

Di mana nak klik tetikus anda di portal Meta.
Warna dan nama butang yang perlu ditekan.
Apa maksud setiap kod/ID yang anda jumpa.
Macam mana nak dapatkan "Kunci Digital" (Token) yang tidak luput.
Bagaimana AI Agent di Antigravity menggunakan MCP untuk membaca ads dan membina kempen secara autonomi.
Macam mana nak hubungkan semuanya tanpa risiko akaun disekat atau bajet terbakar.

1 Kamus Istilah "Orang Awam"

Sebelum kita tekan mana-mana butang, fahami istilah penting ini dengan Analogi Pejabat Korporat:

Istilah Teknikal	Maksud Sebenar	Analogi Mudah	Di Mana Anda Jumpa?
Facebook Page	Halaman perniagaan rasmi anda di Facebook.	Papan Tanda Kedai anda di tepi jalan.	facebook.com/{nama-page}
Meta Business Portfolio	Pusat kawalan bisnes yang memegang Page, akaun iklan, dan staf.	Ibu Pejabat yang memegang semua cawangan.	business.facebook.com
Meta Developer App	Aplikasi digital untuk benarkan sistem komputer bercakap dengan Facebook.	Laluan Staf Belakang untuk lori kargo keluar masuk.	developers.facebook.com
App ID & App Secret	Nombor pengenalan unik dan kata laluan rahsia bagi aplikasi developer anda.	No. IC & PIN Keselamatan aplikasi anda.	Dalam App Settings Meta Developer.
System User	Akaun pengguna digital (bukan manusia) khas untuk robot/automasi.	Pekerja Robotik yang dijaga khas 24 jam.	Meta Business Settings -> System Users.
Access Token	Kod teks panjang (mula dengan EAA...). Bertindak sebagai kunci digital.	Kunci Akses VIP pejabat.	Dijana daripada System User / Graph Explorer.
Page ID	Nombor siri unik 15-16 digit mewakili Facebook Page.	Nombor Geran Kedai anda.	Bahagian About Page anda.
Ad Account ID	Nombor akaun iklan (format: act_123...).	Nombor Akaun Bank iklan.	Meta Ads Manager / Business Settings.
MCP	Model Context Protocol. Protokol penyambung universal.	Soket Palam USB-C untuk otak AI.	Konfigurasi Antigravity (mcp_config.json).
Antigravity IDE	Pusat arahan dan persekitaran kerja ejen AI.	Bilik Kawalan Utama.	Antigravity Desktop / CLI.

2 Membina Facebook Page & Mencari "Page ID"

Langkah 2.1: Bina Facebook Page (Jika Belum Ada)

Buka pelayar web dan layari https://www.facebook.com/pages/create.
Pada panel sebelah kiri:
- Page Name: Masukkan nama syarikat (Contoh: Demo SME Sdn Bhd).
- Category: Pilih kategori yang sesuai.
- Bio: Tulis 1-2 ayat ringkas mengenai bisnes anda.
Tekan butang biru Create Page di bahagian bawah kiri.
Muat naik gambar profil (Logo) dan gambar cover (Banner).
Tekan butang "Save" / "Done".

Langkah 2.2: Kat Mana Nak Cari "Page ID"? Paling Penting!

Ramai orang tersilap masukkan nama Page, sedangkan sistem automasi hanya kenal Nombor ID.

Masuk ke Facebook Page anda sebagai profil Page tersebut.
Di menu sebelah kiri, klik tab "About" (Tentang).
Skrol ke bawah dan klik tab "Page Transparency" (Ketelusan Halaman).
Anda akan melihat satu kotak maklumat bertulis:
Page ID: 1389752850879310

Tindakan Anda:

Salin nombor ini dan simpan dalam Notepad anda. Labelkan sebagai META_PAGE_ID.

3 Menyediakan Meta Business Suite & Akaun Iklan

3.1: Buka Meta Business Suite

Buka business.facebook.com.
Di penjuru atas kiri, pastikan nama Business Portfolio / Perniagaan anda dipilih.
Di menu bar sisi sebelah kiri paling bawah, cari dan klik ikon gear bertulis "Settings" atau terus ke business.facebook.com/settings.

3.2: Dapatkan / Cipta "Ad Account ID"

Sistem AI memerlukan Ad Account ID untuk merangka kempen iklan.

Di Business Settings, lihat menu kiri bawah "Accounts".
Klik "Ad Accounts" (Akaun Iklan).
Jika sudah ada: Lihat ID di sebelah nama. Format: act_123456789...
Jika belum ada: Klik butang Add -> Create a new ad account.
- Timezone: GMT+08:00 Asia/Kuala_Lumpur
- Currency: MYR

Simpan nombor ini sebagai META_AD_ACCOUNT_ID. (Mesti ada awalan act_).

4 Daftar Meta Developer App (Laluan Rasmi API)

Untuk membolehkan kod bercakap dengan Meta, kita perlu daftarkan satu "Aplikasi Penghubung".

4.1: Portal Meta for Developers

Layari: developers.facebook.com
Log masuk akaun Facebook anda.
Klik "Get Started" jika pertama kali.
Pergi ke menu "My Apps".

4.2: Cipta Aplikasi Baharu

Klik butang Create App.
Use Case: Pilih Other -> Next.
App Type: Pilih Business -> Next.
App Name: Demo_SME_Automation (Jangan letak perkataan Meta/FB).
Pilih Business Account anda -> Create App.

Langkah 4.3: Di Mana Nak Ambil App ID & Secret?

Di menu kiri (Dashboard App), klik App settings -> Basic.
Salin App ID Simpan sebagai META_APP_ID
Klik butang 'Show' pada kotak bertutup untuk paparkan App Secret.
Salin kod tersebut Simpan sebagai META_APP_SECRET

AMARAN KESELAMATAN

App Secret ibarat nombor PIN kad ATM anda. Jangan sesekali kongsi kod ini di Facebook, WhatsApp awam, atau GitHub!

5 System User & Token Akses Kekal

THE HOLY GRAIL: Kenapa guna System User? Token biasa luput 1 jam/60 hari (automasi akan mati malam-malam!). Token System User adalah KEKAL (Never-Expiring).

5.1: Cipta System User

Buka Business Settings.
Menu Kiri: Users -> System Users.
Klik butang Add.
Nama: Jebat_Bot
Role: Pilih Admin (Wajib).
Klik Create.

5.2: Assign Assets PENTING

Klik nama Bot tadi, tekan Assign Assets.
Pages: Tanda Page anda -> Buka suis Full Control.
Ad Accounts: Tanda Akaun anda -> Buka suis Manage Campaigns.
Klik Save Changes.

5.3: Generate Token

Klik Generate New Token.
Select App: Pilih App Bab 4.
Expiration: Never.
Tick Permissions (Sangat Penting):

pages_show_list pages_read_engagement pages_manage_posts pages_manage_engagement ads_management ads_read leads_retrieval pages_manage_ads

SIMPAN token panjang (EAA...) sebagai META_SYSTEM_USER_TOKEN. Meta tak tunjuk lagi lepas ni!

6 Uji Token (Graph API)

Uji sama ada kunci sah dan berfungsi.

Buka Graph API Explorer.
Padam Access Token lama, tampal (paste) Token System User (EAA...) anda.
Di bar URL (Kaedah GET), taip:
me?fields=name,id
Klik Submit.

Hasil (Status: 200 OK)

{
  "name": "Demo_App",
  "id": "112233445566"
}

7 Dapatkan Instant Form ID

Untuk kempen Lead Generation.

Di Business Suite, cari All Tools -> Instant Forms.
Klik Create Form -> New Form.
Isi nama (Borang_Pertanyaan).
Tambah soalan: Contact Fields -> Phone Number.
Letak URL Privacy Policy.
Klik Create Form.

Salin Form ID dari senarai dan labelkan sebagai META_LEAD_FORM_ID.

8 Susun Semua ID & Token Ke Dalam Fail .env

Semua maklumat dari Bab 2-7 kini sedia dipasang ke dalam fail tetapan rahsia (Environment Variables). Ia berfungsi seperti kabinet simpanan kunci.

.env

# ==============================================================================
# TETAPAN KREDENSIAL AUTOMATION SISTEM OPERASI AI (AI-MOS)
# PROJEK: DEMO SME SDN BHD
# ==============================================================================

# 1. DARI BAB 4 (META DEVELOPER APP)
META_APP_ID=1122334455667788
META_APP_SECRET=a1b2c3d4e5f67890abcdef1234567890
META_GRAPH_VERSION=v21.0

# 2. DARI BAB 5 (SYSTEM USER NEVER-EXPIRING TOKEN)
META_SYSTEM_USER_TOKEN=EAABcdefgh1234567890long_token_here_never_expire

# 3. DARI BAB 2 (FACEBOOK PAGE ID)
META_PAGE_ID=1389752850879310

# 4. DARI BAB 3 (AD ACCOUNT ID)
META_AD_ACCOUNT_ID=act_123456789012345

# 5. DARI BAB 7 (INSTANT LEAD FORM ID)
META_LEAD_FORM_ID=1456204426381022

# 6. KAWALAN KESELAMATAN SILING BAJET (HARD-LOCK SAFETY)
MAX_DAILY_AD_BUDGET_MYR=15.00
DEFAULT_AD_STATUS=PAUSED

Integrasi Antigravity & MCP (AI Agent)

(Ini bahagian paling moden dan berkuasa dalam buku ini! Bukan lagi bercakap pasal kod skrip manual, tapi bagaimana AI Agent berfikir dan bertindak sendiri).

9.1 Kenapa Guna MCP & AI Agent?

Cara Lama (Manual)

Kena upah programmer tulis Python ratusan baris.
Bila API berubah, skrip rosak, koding balik.
Manusia masih kena buka Ads Manager setiap hari.

Cara Baru (MCP + AI)

LLM (Otak): Menganalisis metrik & copywriting.
MCP (Tangan & Mata): Sambung terus ke Meta API.
Arahan dlm bahasa biasa: "Tolong baca kempen hari ni, kalau CTR teruk, tukar copywriting."

9.2 Empat Objektif & Jangkaan Hasil

🎯 1. Audit Masa Nyata (Real-Time)

AI panggil meta_get_insights. Jika CTR < 1%, AI amaran di WhatsApp & sedia ayat baru sbb audiens dah jemu (fatigue).

🎯 2. Draf Kempen Pintar

Anda suruh: "Buat kempen lead restoran". AI guna meta_create_campaign_draft, set bajet selamat, status PAUSED. Tiada sen terbakar.

🎯 3. Kawalan Bajet (Hard-Lock)

AI semak baki dengan meta_get_ad_account_details. Halang bajet lebih RM15 tanpa pengesahan manusia.

🎯 4. Diagnosis Ralat (Self-Healing)

Jika iklan ditolak (Ad Rejected), AI faham kod ralat, terjemah ke BM, dan baiki ayat janji berlebihan secara automatik.

9.3 Kitaran Autonomi Latar Belakang

┌────────────────────────────────────────────────────────────────────────┐
│ 1. PENGGUNA MEMBERI ARAHAN DALAM BAHASA MELAYU                         │
│    "Juru Audit, semak akaun iklan aku hari ni. Ada jalan ke tak?"      │
└───────────────────────────────────┬────────────────────────────────────┘
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 2. ANTIGRAVITY ORCHESTRATION (OTAK AI MENILAI ARAHAN)                  │
│    - Ejen memilih Tool MCP: meta_get_ad_account_details & insights.    │
└───────────────────────────────────┬────────────────────────────────────┘
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 3. META ADS MCP SERVER (JAMBATAN PROTOKOL)                            │
│    - Mengambil Token System User daripada fail .env.                  │
│    - Menghantar panggilan rasmi ke Meta Graph API (v21.0).             │
└───────────────────────────────────┬────────────────────────────────────┘
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 4. PELAYAN META ADS (FACEBOOK SERVER)                                  │
│    - Memulangkan data: Spend: RM0.00, Status: PAUSED, Leads: 0.        │
└───────────────────────────────────┬────────────────────────────────────┘
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 5. EJEN AI MEMBUAT KESIMPULAN & LAPORAN BAHASA MANUSIA                 │
│    "Boss, akaun iklan selamat. Kempen PAUSED. Belanja RM0.00."         │
└────────────────────────────────────────────────────────────────────────┘

9.5 Senario Sebenar: Dialog Anda Bersama Ejen AI

"Juru Audit, tolong buat audit akaun iklan aku. Kenapa rasa macam lead masuk sikit sangat minggu ni?"

Ejen memanggil tool: meta_list_campaigns & meta_get_insights

"Boss, saya dah selesai audit. Ini dapatan saya:"

Kempen 'SME Leads' aktif bajet RM15/hari.
Frekuensi cecah 3.4 (orang sama nampak >3 kali).
CTR jatuh ke 0.65%. Ini tanda Ad Fatigue (audiens jemu).

Cadangan: Ejen Seniman dah siapkan 2 visual baharu. Adakah bos setuju untuk saya tukar visual dlm draf iklan?

10 Cara Selesaikan Masalah (Error)

Kod Ralat	Mesej Lazim	Sebab Utama	Cara Selesai Segera
Error 190	Invalid OAuth access token	Token salah salin, atau guna token sementara yg dah luput.	Jana token baharu (System User). Pilih tempoh Never.
Error 200 / 100	Permissions error / Missing scope	System User takde kebenaran utk fungsi tu.	Semak Bab 5.3. Tick kebenaran `ads_management` dll.
Error 273	Cannot create ad for this page	System User belum diberi aset Page/Ad Account.	Masuk Business Settings -> System Users -> Assign Assets.
Error 1487843	Dev mode app restriction	Meta App masih status In Development (tak boleh post awam).	Guna muat naik `published: false` sebelum dipaut ke iklan.
Timeout	Tool call failed / Server unavailable	Pelayan MCP lokal belum hidup / port salah.	Pastikan .env ada port yg betul & jalankan health-check MCP.

Senarai Semak Akhir (Checklist)

Sebelum Present atau Terbit Ebook. Klik untuk tandakan.

Saya faham beza Page ID, Ad Account ID, App ID, App Secret, dan Access Token.

Saya ada System User berstatus Admin dengan aset Page dan Ad Account disambungkan.

Saya ada Token Akses Kekal (Never-Expiring) yang bermula dengan EAA....

Saya faham bagaimana Antigravity + MCP membolehkan Ejen AI membaca metrik ads dan membuat draf secara automatik.

Semua kempen iklan dikunci kepada status PAUSED untuk keselamatan kewangan mutlak (RM 0.00 spend).

Saya tahu cara menjawab soalan pensyarah sekiranya ditanya mengenai etika kawalan bajet AI.

Modul Ebook ini disediakan oleh Pasukan Orkestrasi Ejen AI DFK INC / syahmiaof.

Modul Meta Ads & AI