Aller au contenu

Campaigns

Campagnes publicitaires, créées et gérées avec l'IA.

Ouvrir Campaigns
Vérifié par rapport au tableau de bord le 18 novembre 2026

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).

Seuls Google Ads et Meta Ads sont branchés

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.

curl -s https://xuda.ai/cpi/launch_ad_campaign \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","slug":"google-ads"}}'
const res = await fetch('https://xuda.ai/cpi/launch_ad_campaign', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    data: { app_id: 'YOUR_CAMPAIGN_APP_ID', slug: 'google-ads' },
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/launch_ad_campaign',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'slug': 'google-ads'}},
)

La campagne est maintenant sur le réseau et en pause. Appelez set_ad_network_status avec "status": "active" pour la démarrer.

curl -s https://xuda.ai/cpi/get_ad_campaign_report \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","days":7}}'
const res = await fetch('https://xuda.ai/cpi/get_ad_campaign_report', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', data: { app_id: 'YOUR_CAMPAIGN_APP_ID', days: 7 } }),
});
const { data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_ad_campaign_report',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'days': 7}},
)

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.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026