1. Apa itu HilltopAds MCP dan apa yang bisa Anda lakukan dengannya

Apa itu HilltopAds MCP?

MCP Server (Model Context Protocol) adalah konektor resmi HilltopAds untuk klien AI. Setelah terhubung, AI dapat mengakses data akun Anda dan, dengan persetujuan Anda, melakukan perubahan seperti membuat atau memperbarui kampanye melalui saluran yang aman dan khusus, tanpa perlu menyalin dan menempel data secara manual.

Username dan password Anda tidak pernah dibagikan kepada klien AI. Proses otorisasi dilakukan menggunakan API Key yang Anda buat sendiri di akun HilltopAds Anda.

Konektor ini menyediakan akses ke akun HilltopAds Anda melalui serangkaian Tools (operasi). AI akan memilih tool yang sesuai dengan permintaan Anda, menjalankannya, lalu menyajikan hasilnya dalam format yang mudah dipahami, seperti tabel, ringkasan, atau bahkan grafik.

Apa yang bisa Anda lakukan dengannya?

Tools yang tersedia terbagi menjadi dua kategori:

Read Operations: Mengambil data seperti saldo akun, inventaris, statistik, detail kampanye tertentu, atau daftar sumber (source list) sebuah kampanye.

Action Operations: Melakukan perubahan pada akun Anda, seperti membuat atau memperbarui kampanye, menjalankan atau menghentikannya, mengubah bid dan URL tujuan, serta mengelola blacklist dan whitelist sumber trafik.

Tools yang tersedia bergantung pada jenis akun Anda – Advertiser, Publisher, atau keduanya. Saat ini, konektor menyediakan 27 operasi, terdiri dari 23 untuk Advertiser dan 4 untuk Publisher.

Action Operations hanya dijalankan setelah Anda memberikan persetujuan. Klien AI akan menandai tools sebagai read-only atau write/delete, lalu meminta konfirmasi Anda sebelum melakukan perubahan apa pun.

Tools Akun & Pelaporan

Tool	Fungsi
`advertiser_get_balance`	Menampilkan saldo terkini akun Advertiser.
`advertiser_list_inventory`	Menampilkan kampanye dan iklan Anda.
`advertiser_get_stats`	Menampilkan statistik yang dapat difilter atau dikelompokkan berdasarkan tanggal, zona, GEO, kampanye, sistem operasi, jam, atau sumber trafik.
`advertiser_get_campaign`	Menampilkan detail lengkap sebuah kampanye berdasarkan Campaign ID.

Tools Manajemen Kampanye

Catatan: Dalam contoh pada panduan ini, asisten membuat setiap kampanye dalam status Inactive agar Anda dapat meninjaunya sebelum mulai menghabiskan anggaran. Ini hanyalah pengaturan default yang dipilih oleh asisten, bukan aturan tetap. Jika Anda ingin kampanye dibuat dalam status Inactive atau langsung dijalankan, sebutkan hal tersebut secara jelas dalam permintaan Anda.

Tool	Fungsi
`advertiser_create_campaign`	Membuat kampanye baru.
`advertiser_update_campaign`	Memperbarui sebagian pengaturan kampanye.
`advertiser_start_campaign`	Mengaktifkan kampanye yang telah disetujui.
`advertiser_stop_campaign`	Menonaktifkan kampanye yang sedang berjalan.
`advertiser_archive_campaign`	Memindahkan kampanye ke arsip.
`advertiser_unarchive_campaign`	Mengembalikan kampanye dari arsip.
`advertiser_set_bid`	Mengubah bid untuk Wildcard GEO.
`advertiser_set_destination_url`	Mengubah URL tujuan pada kampanye Popunder.
`advertiser_replace_domain`	Mengganti domain di seluruh iklan dalam akun Advertiser.

Tools Source Blacklist

Tool	Fungsi
`advertiser_get_blacklist`	Menampilkan source blacklist sebuah kampanye.
`advertiser_add_to_blacklist`	Menambahkan sumber ke blacklist.
`advertiser_remove_from_blacklist`	Menghapus sumber dari blacklist.
`advertiser_clear_campaign_blacklist`	Mengosongkan blacklist sebuah kampanye.
`advertiser_set_blacklist`	Mengganti seluruh blacklist dan mengubah kampanye ke mode BLACKLIST.

Tools Source Whitelist

Tool	Fungsi
`advertiser_get_whitelist`	Menampilkan source whitelist sebuah kampanye.
`advertiser_add_to_whitelist`	Menambahkan sumber ke whitelist.
`advertiser_remove_from_whitelist`	Menghapus sumber dari whitelist.
`advertiser_clear_campaign_whitelist`	Mengosongkan whitelist sebuah kampanye.
`advertiser_set_whitelist`	Mengganti seluruh whitelist dan mengubah kampanye ke mode WHITELIST.