Μετάβαση στο περιεχόμενο

Campaigns

Διαφημιστικές καμπάνιες, φτιαγμένες και εκτελούμενες με AI.

Άνοιγμα του Campaigns
Ελέγχθηκε με τον πίνακα ελέγχου στις 18 Νοεμβρίου 2026

Επτά μέθοδοι είναι ανοιχτές σε ένα κλειδί API λογαριασμού. Λειτουργούν σε μια καμπάνια που υπάρχει ήδη: δημιουργείτε και πληρώνετε μια καμπάνια στον πίνακα ελέγχου, όπου βρίσκονται η κάρτα και οι όροι, και από κώδικα μπορείτε να γράψετε το κείμενό της, να τη στείλετε στα δίκτυά της, να τη θέσετε σε παύση ή να τη συνεχίσετε και να διαβάσετε πώς τα πάει. Η δημιουργία μιας καμπάνιας και η πληρωμή της δεν είναι διαθέσιμες από κώδικα σήμερα.

Κάθε κλήση είναι ένα POST στο https://xuda.ai/cpi/<method> με το κλειδί σας και ένα αντικείμενο data. Οι απαντήσεις επιστρέφουν ως { "code": 1, "data": ... }· ένας αρνητικός code είναι άρνηση, με τον λόγο στο data.

Από μια περιγραφή σε μια καμπάνια που τρέχει

Βρείτε τις καμπάνιες σας

Το get_account_advertising απαριθμεί τις καμπάνιες του λογαριασμού σας. Κάθε μία έχει ένα id: αυτό είναι το app_id που δέχονται οι άλλες μέθοδοι.

Δείτε ποια δίκτυα είναι ενεργά

Το get_advertise_platforms επιστρέφει κάθε δίκτυο και την κατάστασή του: σε αναμονή, σε επεξεργασία ή ενεργό. Τα διαπιστευτήρια δεν είναι ποτέ μέρος της απάντησης.

Γράψτε ή ξαναγράψτε το κείμενο

Το generate_ad_creative γράφει έναν τίτλο, κύριο κείμενο, περιγραφή και κουμπί για μια καμπάνια και ένα δίκτυο, με τόνο της επιλογής σας: Professional, Friendly, Bold, Playful, Urgent ή Luxury (Friendly αν το παραλείψετε). Τρέχει με τις πιστώσεις AI σας. Όταν δεν έχουν μείνει καθόλου, ή η σελίδα δεν μπορεί να διαβαστεί, παίρνετε αντί γι' αυτό ένα γενικό προσχέδιο και η απάντηση λέει ποιο συνέβη. Το Google Ads έχει δικό του πρότυπο· τα άλλα δίκτυα μοιράζονται ένα πρότυπο ροής.

Στείλτε την σε ένα δίκτυο

Το launch_ad_campaign δημιουργεί την καμπάνια σε ένα δίκτυο, πάντα σε παύση. Το slug είναι google-ads ή meta· χωρίς τιμή είναι google-ads, και κάθε άλλη τιμή απορρίπτεται. Μια δεύτερη κλήση για το ίδιο δίκτυο ενημερώνει την καμπάνια που υπάρχει, οπότε είναι ασφαλές να επαναλαμβάνεται. Στο Google, ένας λογαριασμός χωρίς λογαριασμό πελάτη Google Ads παίρνει έναν, που δημιουργείται κάτω από τον λογαριασμό διαχειριστή του Xuda την πρώτη φορά.

Ενεργοποιήστε την ή απενεργοποιήστε την

Το set_ad_network_status θέτει σε παύση ή συνεχίζει τις ενεργές καμπάνιες σε κάθε δίκτυο στο οποίο στάλθηκε η καμπάνια. Είναι ό,τι κάνει ο διακόπτης Ενεργό στον πίνακα ελέγχου για τα δίκτυα. Περάστε το status ως active ή paused.

Διαβάστε πώς τα πάει

Το get_ad_campaign_report τραβά τους ημερήσιους αριθμούς από κάθε δίκτυο στο οποίο στάλθηκε η καμπάνια, για τις τελευταίες 1 έως 30 ημέρες (14 αν το παραλείψετε).

Μόνο το Google Ads και το Meta Ads είναι συνδεδεμένα

Μια καμπάνια τρέχει σε Google Ads, Meta Ads ή και στα δύο. Τα άλλα δίκτυα που απαριθμεί ο δημιουργός σημειώνονται ως προσεχώς και δεν μπορούν να λάβουν εκκίνηση.

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

Η καμπάνια βρίσκεται τώρα στο δίκτυο και είναι σε παύση. Καλέστε το set_ad_network_status με "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}},
)

Αυτά είναι τα στοιχεία που σχεδιάζει η Επισκόπηση, και είναι μόνο της δικής σας καμπάνιας: μια κλήση για καμπάνια που δεν είναι δική σας απορρίπτεται.

Μέθοδοι

Το get_account_advertising, που απαριθμεί τις καμπάνιες του λογαριασμού, ανήκει στο microservice Account. Δείτε τους Στατικούς ιστότοπους για τον πίνακα Account δίπλα στον οποίο βρίσκεται.

Πώς σας φαίνεται αυτός ο οδηγός;

Τελευταία ενημέρωση: 20 Νοεμβρίου 2026