Zum Inhalt springen

Campaigns

Werbekampagnen, mit KI erstellt und betrieben.

Campaigns öffnen
Am 18. November 2026 mit dem Dashboard abgeglichen

Sieben Methoden stehen einem API-Schlüssel des Kontos offen. Sie arbeiten an einer Kampagne, die schon existiert: Du erstellst und bezahlst eine Kampagne im Dashboard, wo die Karte und die AGB sind, und aus Code kannst du ihre Texte schreiben, sie an ihre Netzwerke senden, sie pausieren oder fortsetzen und lesen, wie sie läuft. Eine Kampagne zu erstellen und zu bezahlen, ist heute aus Code nicht möglich.

Jeder Aufruf ist ein POST an https://xuda.ai/cpi/<method> mit deinem Schlüssel und einem data-Objekt. Antworten kommen als { "code": 1, "data": ... } zurück; ein negativer code ist eine Ablehnung, mit dem Grund in data.

Von einem Briefing zu einer laufenden Kampagne

Deine Kampagnen finden

get_account_advertising listet die Kampagnen deines Kontos auf. Jede hat eine ID: Das ist die app_id, die die anderen Methoden nehmen.

Sehen, welche Netzwerke live sind

get_advertise_platforms gibt jedes Netzwerk und seinen Status zurück, pending, processing oder active. Zugangsdaten sind nie Teil der Antwort.

Die Texte schreiben oder neu schreiben

generate_ad_creative schreibt eine Überschrift, einen Haupttext, eine Beschreibung und eine Schaltfläche für eine Kampagne und ein Netzwerk, in einer Tonalität deiner Wahl: Professionell, Freundlich, Mutig, Verspielt, Dringlich oder Luxuriös (Freundlich, wenn du sie weglässt). Es läuft auf deinen KI-Credits. Wenn keine mehr da sind oder die Seite nicht gelesen werden kann, bekommst du stattdessen einen generischen Entwurf, und die Antwort sagt, welchen. Google Ads hat eine eigene Vorlage; die anderen Netzwerke teilen sich eine Feed-Vorlage.

An ein Netzwerk senden

launch_ad_campaign erstellt die Kampagne in einem Netzwerk, immer pausiert. slug ist google-ads oder meta; ohne Angabe ist es google-ads, und jeder andere Wert wird abgelehnt. Ein zweiter Aufruf für dasselbe Netzwerk aktualisiert die Kampagne, die da ist, er lässt sich also gefahrlos wiederholen. Bei Google bekommt ein Konto ohne Google-Ads-Kundenkonto beim ersten Mal eines, das unter dem Manager-Konto von Xuda erstellt wird.

Ein- oder ausschalten

set_ad_network_status pausiert oder setzt die laufenden Kampagnen in jedem Netzwerk fort, an das die Kampagne gesendet wurde. Es ist das, was der Schalter Aktiv im Dashboard für die Netzwerke tut. Übergib status als active oder paused.

Lesen, wie es läuft

get_ad_campaign_report ruft die Tageszahlen aus jedem Netzwerk ab, an das die Kampagne gesendet wurde, für die letzten 1 bis 30 Tage (14, wenn du es weglässt).

Nur Google Ads und Meta Ads sind angebunden

Eine Kampagne läuft auf Google Ads, Meta Ads oder beiden. Die anderen Netzwerke, die der Builder auflistet, sind als bald verfügbar markiert, und in sie lässt sich nicht starten.

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'}},
)

Die Kampagne ist jetzt im Netzwerk und pausiert. Rufe set_ad_network_status mit "status": "active" auf, um sie zu starten.

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}},
)

Das sind die Zahlen, die die Übersicht zeichnet, und sie gehören nur deiner eigenen Kampagne: Ein Aufruf für eine Kampagne, die nicht deine ist, wird abgelehnt.

Methoden

get_account_advertising, das die Kampagnen des Kontos auflistet, gehört zum Account-Microservice. Siehe Static Websites für die Account-Tabelle, neben der es steht.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026