Passer au contenu principal

1. Qu'est-ce que HilltopAds MCP et que pouvez-vous faire avec ?

Ce guide vous explique, étape par étape, comment connecter le connecteur HilltopAds MCP dans quatre outils différents.

Écrit par HilltopAds

Qu'est-ce que HilltopAds MCP ?

Le serveur MCP (Model Context Protocol) est un connecteur officiel de HilltopAds pour les clients IA. Une fois connecté, l'IA peut accéder aux données de votre compte et, avec votre autorisation, effectuer des modifications, comme créer ou mettre à jour des campagnes, via un canal sécurisé et dédié, sans que vous ayez à copier-coller des données.

Votre identifiant et votre mot de passe ne sont jamais partagés avec le client IA. L'autorisation s'effectue à l'aide d'une clé API que vous générez depuis votre compte.

Le connecteur expose votre compte HilltopAds au moyen d'un ensemble d'opérations (Tools). L'IA sélectionne automatiquement l'outil adapté à votre demande, l'exécute, puis transforme le résultat en une réponse facile à lire : un tableau, un résumé ou même un graphique.

Que pouvez-vous faire avec ?

Les outils se répartissent en deux catégories :

Opérations de lecture (Read Operations) : elles récupèrent des données telles que votre solde, votre inventaire publicitaire, vos statistiques, les détails d'une campagne ou les listes de sources associées à une campagne.

Opérations d'action (Action Operations) : elles modifient votre compte, par exemple en créant ou en mettant à jour des campagnes, en les démarrant ou en les arrêtant, en ajustant les enchères (Bids), les URL de destination, ainsi qu'en gérant les listes noire et blanche des sources.

Les outils disponibles dépendent du type de votre compte : annonceur (Advertiser), Publisher ou les deux. À ce jour, le connecteur prend en charge 27 opérations : 23 pour les annonceurs et 4 pour les éditeurs.

Les opérations d'action ne sont exécutées qu'après votre validation. Les clients IA indiquent clairement si un outil est en lecture seule ou permet une écriture/suppression, puis demandent votre confirmation avant toute modification.

Outils de compte et de reporting

Outil

Description

advertiser_get_balance

Affiche le solde actuel du compte annonceur.

advertiser_list_inventory

Affiche vos campagnes et leurs créations publicitaires.

advertiser_get_stats

Affiche les statistiques avec filtrage ou regroupement par date, zone, GEO, campagne, système d'exploitation, heure ou source.

advertiser_get_campaign

Affiche les informations détaillées d'une campagne à partir de son identifiant (ID).

Outils de gestion des campagnes

Remarque : Dans les exemples présentés plus loin dans ce guide, l'assistant crée les campagnes à l'état inactive, afin que vous puissiez les vérifier avant qu'elles ne commencent à diffuser. Il s'agit d'un choix par défaut de l'assistant, et non d'une règle imposée. Si vous souhaitez qu'une campagne soit créée inactive (ou lancée immédiatement), précisez-le explicitement dans votre demande.

Outil

Description

advertiser_create_campaign

Crée une nouvelle campagne.

advertiser_update_campaign

Met à jour partiellement les paramètres d'une campagne.

advertiser_start_campaign

Active une campagne approuvée.

advertiser_stop_campaign

Désactive une campagne en cours de diffusion.

advertiser_archive_campaign

Archive une campagne.

advertiser_unarchive_campaign

Restaure une campagne archivée.

advertiser_set_bid

Modifie l'enchère (Bid) appliquée au GEO générique (Wildcard GEO).

advertiser_set_destination_url

Modifie l'URL de destination d'une campagne Popunder.

advertiser_replace_domain

Remplace un domaine dans toutes les annonces du compte annonceur.

Outils de gestion de la liste noire des sources (Source Blacklist)

Outil

Description

advertiser_get_blacklist

Affiche la liste noire des sources d'une campagne.

advertiser_add_to_blacklist

Ajoute des sources à la liste noire.

advertiser_remove_from_blacklist

Supprime des sources de la liste noire.

advertiser_clear_campaign_blacklist

Vide la liste noire d'une campagne.

advertiser_set_blacklist

Remplace entièrement la liste noire et bascule la campagne en mode BLACKLIST.

Outils de gestion de la liste blanche des sources (Source Whitelist)

Outil

Description

advertiser_get_whitelist

Affiche la liste blanche des sources d'une campagne.

advertiser_add_to_whitelist

Ajoute des sources à la liste blanche.

advertiser_remove_from_whitelist

Supprime des sources de la liste blanche.

advertiser_clear_campaign_whitelist

Vide la liste blanche d'une campagne.

advertiser_set_whitelist

Remplace entièrement la liste blanche et bascule la campagne en mode WHITELIST.

Avez-vous trouvé la réponse à votre question ?