Siirry sisältöön

Campaigns

Mainoskampanjat, tehty ja ajettu tekoälyllä.

Avaa Campaigns
Tarkistettu koontinäyttöä vasten 18. marraskuuta 2026

Seitsemän metodia on avoinna tilin API-avaimelle. Ne toimivat kampanjalla, joka on jo olemassa: teet ja maksat kampanjan hallintapaneelissa, jossa kortti ja ehdot ovat, ja koodista voit kirjoittaa sen tekstin, lähettää sen verkostoihinsa, keskeyttää tai jatkaa sitä ja lukea, miten sillä menee. Kampanjan luominen ja sen maksaminen ei ole nykyään mahdollista koodista.

Jokainen kutsu on POST osoitteeseen https://xuda.ai/cpi/<method>, jossa on avaimesi ja data-objekti. Vastaukset tulevat muodossa { "code": 1, "data": ... }. Negatiivinen code on hylkäys, jonka syy on kentässä data.

Kuvauksesta käynnissä olevaan kampanjaan

Etsi kampanjasi

get_account_advertising luettelee tilisi kampanjat. Jokaisella on id: se on app_id, jonka muut metodit ottavat.

Katso, mitkä verkostot ovat käytössä

get_advertise_platforms palauttaa jokaisen verkoston ja sen tilan: pending, processing tai active. Tunnistetietoja ei koskaan sisällytetä vastaukseen.

Kirjoita tai kirjoita teksti uudelleen

generate_ad_creative kirjoittaa otsikon, päätekstin, kuvauksen ja painikkeen kampanjalle ja verkostolle valitsemallasi sävyllä: Professional, Friendly, Bold, Playful, Urgent tai Luxury (Friendly, jos jätät sen pois). Se kuluttaa AI-krediittejäsi. Kun niitä ei ole jäljellä tai sivua ei voi lukea, saat tilalle yleisen luonnoksen, ja vastaus kertoo kumpi tapahtui. Google Adsilla on oma mallinsa, ja muut verkostot käyttävät yhteistä syötemallia.

Lähetä se verkostoon

launch_ad_campaign luo kampanjan verkostoon, aina keskeytettynä. slug on google-ads tai meta. Jos sitä ei anneta, se on google-ads, ja mikä tahansa muu arvo hylätään. Toinen kutsu samalle verkostolle päivittää siellä olevan kampanjan, joten sen voi toistaa turvallisesti. Googlessa tili, jolla ei ole Google Ads -asiakastiliä, saa sellaisen luotuna Xudan hallintatilin alle ensimmäisellä kerralla.

Kytke se päälle tai pois

set_ad_network_status keskeyttää tai jatkaa käynnissä olevia kampanjoita jokaisessa verkostossa, johon kampanja lähetettiin. Se on se, mitä hallintapaneelin Käytössä-kytkin tekee verkostoille. Anna status arvona active tai paused.

Lue, miten sillä menee

get_ad_campaign_report hakee päivittäiset luvut jokaisesta verkostosta, johon kampanja lähetettiin, viimeiseltä 1-30 päivältä (14, jos jätät sen pois).

Vain Google Ads ja Meta Ads on kytketty

Kampanja pyörii Google Adsissa, Meta Adsissa tai molemmissa. Muut rakentimen luettelemat verkostot on merkitty tulossa oleviksi, eikä niihin voi käynnistää.

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

Kampanja on nyt verkostossa ja keskeytettynä. Käynnistä se kutsumalla set_ad_network_status arvolla "status": "active".

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

Nämä ovat luvut, jotka Yleiskatsaus piirtää, ja ne ovat vain oman kampanjasi lukuja: kutsu kampanjalle, joka ei ole sinun, hylätään.

Metodit

get_account_advertising, joka luettelee tilin kampanjat, kuuluu Account-mikropalveluun. Katso Static Websites, jonka vieressä Account-taulukko on.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026