Campaigns
Campagnes publicitaires, créées et gérées avec l'IA.
Sept méthodes sont ouvertes à une clé d'API de compte. Elles agissent sur une campagne qui existe déjà : vous créez et payez une campagne dans le tableau de bord, où se trouvent la carte et les conditions, et depuis du code vous pouvez écrire ses textes, l'envoyer à ses réseaux, la mettre en pause ou la reprendre et lire où elle en est. Créer une campagne et la payer n'est pas possible depuis du code aujourd'hui.
Chaque appel est un POST vers https://xuda.ai/cpi/<method> avec votre clé et un objet data. Les réponses reviennent sous la forme { "code": 1, "data": ... } ; un code négatif est un refus, avec la raison dans data.
D'un brief à une campagne en cours
Trouvez vos campagnes
get_account_advertising liste les campagnes de votre compte. Chacune a un id : c'est l'app_id que prennent les autres méthodes.
Voyez quels réseaux sont actifs
get_advertise_platforms renvoie chaque réseau et son statut, pending, processing ou active. Les identifiants ne font jamais partie de la réponse.
Écrivez ou réécrivez les textes
generate_ad_creative écrit un titre, un texte principal, une description et un bouton pour une campagne et un réseau, sur un ton que vous choisissez : Professional, Friendly, Bold, Playful, Urgent ou Luxury (Friendly si vous l'omettez). Il utilise vos crédits IA. Quand il n'y en a plus, ou que la page ne peut pas être lue, vous recevez à la place un brouillon générique et la réponse le précise. Google Ads a son propre modèle ; les autres réseaux partagent un modèle de flux.
Envoyez-la à un réseau
launch_ad_campaign crée la campagne sur un réseau, toujours en pause. slug vaut google-ads ou meta ; sans valeur, c'est google-ads, et toute autre valeur est refusée. Un second appel pour le même réseau met à jour la campagne qui existe, il est donc sûr de le répéter. Sur Google, un compte sans compte client Google Ads en reçoit un créé sous le compte gestionnaire de Xuda la première fois.
Activez-la ou mettez-la en pause
set_ad_network_status met en pause ou reprend les campagnes en ligne sur chaque réseau auquel la campagne a été envoyée. C'est ce que fait l'interrupteur Active du tableau de bord pour les réseaux. Passez status à active ou paused.
Lisez où elle en est
get_ad_campaign_report récupère les chiffres quotidiens de chaque réseau auquel la campagne a été envoyée, pour les 1 à 30 derniers jours (14 si vous l'omettez).
Une campagne tourne sur Google Ads, sur Meta Ads ou sur les deux. Les autres réseaux que liste le générateur sont marqués comme bientôt disponibles et ne peuvent pas recevoir de lancement.
La campagne est maintenant sur le réseau et en pause. Appelez set_ad_network_status avec "status": "active" pour la démarrer.
Ce sont les chiffres que dessine la Vue d'ensemble, et ils ne concernent que votre propre campagne : un appel pour une campagne qui n'est pas la vôtre est refusé.
Méthodes
get_account_advertising, qui liste les campagnes du compte, appartient au microservice Account. Voir Sites web statiques pour le tableau Account à côté duquel elle se trouve.