Campaigns
Kampanie reklamowe tworzone i prowadzone z AI.
Siedem metod jest otwartych dla klucza API konta. Działają na kampanii, która już istnieje: kampanię tworzysz i opłacasz w dashboardzie, gdzie są karta i warunki, a z kodu możesz napisać jej teksty, wysłać ją do jej sieci, wstrzymać lub wznowić i odczytać, jak jej idzie. Tworzenie kampanii i płacenie za nią nie jest dziś dostępne z kodu.
Każde wywołanie to POST na https://xuda.ai/cpi/<method> z Twoim kluczem i obiektem data. Odpowiedzi wracają jako { "code": 1, "data": ... }; ujemny code oznacza odmowę, z powodem w data.
Od opisu do działającej kampanii
Znajdź swoje kampanie
get_account_advertising wyświetla kampanie Twojego konta. Każda ma identyfikator: to app_id, którego oczekują pozostałe metody.
Sprawdź, które sieci działają
get_advertise_platforms zwraca każdą sieć i jej status: oczekuje, w trakcie albo aktywna. Dane uwierzytelniające nigdy nie są częścią odpowiedzi.
Napisz lub przepisz tekst
generate_ad_creative pisze nagłówek, tekst główny, opis i przycisk dla kampanii i sieci, w tonie, który wybierzesz: Profesjonalny, Przyjazny, Odważny, Żartobliwy, Pilny lub Luksusowy (Przyjazny, jeśli go pominiesz). Działa na Twoich kredytach AI. Gdy ich nie ma albo strony nie da się odczytać, dostajesz zamiast tego ogólny szkic, a odpowiedź mówi, który. Google Ads ma własny szablon; pozostałe sieci używają wspólnego szablonu feedu.
Wyślij ją do sieci
launch_ad_campaign tworzy kampanię w sieci, zawsze jako wstrzymaną. slug to google-ads albo meta; bez niego jest to google-ads, a każda inna wartość jest odrzucana. Drugie wywołanie dla tej samej sieci aktualizuje istniejącą kampanię, więc bezpiecznie je powtarzać. W Google konto bez konta klienta Google Ads dostaje je utworzone pod kontem menedżerskim Xuda przy pierwszym razie.
Włącz ją lub wyłącz
set_ad_network_status wstrzymuje lub wznawia działające kampanie we wszystkich sieciach, do których kampania została wysłana. To samo robi dla sieci przełącznik Trwa w dashboardzie. Przekaż status jako active albo paused.
Odczytaj, jak jej idzie
get_ad_campaign_report pobiera dzienne liczby z każdej sieci, do której kampania została wysłana, za ostatnie 1 do 30 dni (14, jeśli pominiesz).
Kampania działa w Google Ads, Meta Ads albo w obu. Pozostałe sieci wymienione w kreatorze są oznaczone jako wkrótce i nie można do nich uruchamiać kampanii.
Kampania jest teraz w sieci i wstrzymana. Wywołaj set_ad_network_status z "status": "active", aby ją uruchomić.
To liczby, które rysuje Przegląd, i dotyczą wyłącznie Twojej własnej kampanii: wywołanie dla cudzej kampanii jest odrzucane.
Metody
get_account_advertising, która wyświetla kampanie konta, należy do mikrousługi Account. Tabelę Account, obok której leży, znajdziesz w Static Websites.