Przejdź do treści

Campaigns

Kampanie reklamowe tworzone i prowadzone z AI.

Otwórz Campaigns
Sprawdzono z pulpitem dnia 18 listopada 2026

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

Podłączone są tylko Google Ads i Meta Ads

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.

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

Kampania jest teraz w sieci i wstrzymana. Wywołaj set_ad_network_status z "status": "active", aby ją uruchomić.

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

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.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026