İçeriğe geç

Campaigns

AI ile hazırlanan ve yürütülen reklam kampanyaları.

Campaigns aç
18 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

Yedi yöntem bir hesap API anahtarına açıktır. Bunlar zaten var olan bir kampanya üzerinde çalışır: kartın ve koşulların bulunduğu kontrol panelinde bir kampanya oluşturur ve ödersiniz; koddan ise metnini yazabilir, ağlarına gönderebilir, duraklatabilir veya sürdürebilir ve nasıl gittiğini okuyabilirsiniz. Bir kampanya oluşturmak ve ödemesini yapmak bugün koddan mümkün değildir.

Her çağrı, anahtarınız ve bir data nesnesiyle https://xuda.ai/cpi/<method> adresine bir POST isteğidir. Yanıtlar { "code": 1, "data": ... } olarak gelir; negatif bir code bir reddir ve nedeni data içindedir.

Bir özetten yayındaki bir kampanyaya

Kampanyalarınızı bulun

get_account_advertising hesabınızın kampanyalarını listeler. Her birinin bir kimliği vardır: diğer yöntemlerin aldığı app_id budur.

Hangi ağların canlı olduğunu görün

get_advertise_platforms her ağı ve durumunu döndürür: pending, processing veya active. Kimlik bilgileri asla yanıtın parçası olmaz.

Metni yazın veya yeniden yazın

generate_ad_creative, bir kampanya ve bir ağ için bir başlık, ana metin, açıklama ve düğme yazar; tonu siz seçersiniz: Professional, Friendly, Bold, Playful, Urgent veya Luxury (belirtmezseniz Friendly). AI kredilerinizle çalışır. Hiç kredi kalmadığında ya da sayfa okunamadığında bunun yerine genel bir taslak alırsınız ve yanıt hangisi olduğunu söyler. Google Ads'in kendi şablonu vardır; diğer ağlar bir akış şablonunu paylaşır.

Bir ağa gönderin

launch_ad_campaign kampanyayı bir ağda oluşturur, her zaman duraklatılmış olarak. slug değeri google-ads veya meta olur; hiçbiri verilmezse google-ads olur ve başka her değer reddedilir. Aynı ağ için ikinci bir çağrı oradaki kampanyayı günceller, bu yüzden tekrarlamak güvenlidir. Google'da, Google Ads müşteri hesabı olmayan bir hesap için ilk seferde Xuda'nın yönetici hesabı altında bir tane oluşturulur.

Açın veya kapatın

set_ad_network_status, kampanyanın gönderildiği her ağdaki canlı kampanyaları duraklatır veya sürdürür. Kontrol panelindeki Aktif anahtarının ağlar için yaptığı budur. status değerini active veya paused olarak verin.

Nasıl gittiğini okuyun

get_ad_campaign_report, kampanyanın gönderildiği her ağdan günlük sayıları son 1 ila 30 gün için çeker (belirtmezseniz 14).

Yalnızca Google Ads ve Meta Ads bağlı

Bir kampanya Google Ads'te, Meta Ads'te ya da her ikisinde çalışır. Oluşturucunun listelediği diğer ağlar yakında olarak işaretlidir ve onlara başlatılamaz.

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

Kampanya artık ağda ve duraklatılmış durumda. Başlatmak için set_ad_network_status yöntemini "status": "active" ile çağırın.

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

Bunlar Genel bakışın çizdiği rakamlardır ve yalnızca kendi kampanyanıza aittir: size ait olmayan bir kampanya için yapılan çağrı reddedilir.

Yöntemler

Hesabın kampanyalarını listeleyen get_account_advertising, Account mikro hizmetine aittir. Yanında durduğu Account tablosu için bkz. Statik web siteleri.

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026