Campaigns
Werbekampagnen, mit KI erstellt und betrieben.
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).
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.
Die Kampagne ist jetzt im Netzwerk und pausiert. Rufe set_ad_network_status mit "status": "active" auf, um sie zu starten.
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.