Campaigns
קמפיינים פרסומיים, שנוצרים ופועלים בעזרת AI.
שבע שיטות פתוחות למפתח API של חשבון. הן עובדות על קמפיין שכבר קיים: יוצרים ומשלמים על קמפיין בדשבורד, שבו נמצאים הכרטיס והתנאים, ומהקוד אפשר לכתוב את הנוסח שלו, לשלוח אותו לרשתות שלו, להשהות או לחדש אותו ולקרוא איך הוא מתקדם. יצירת קמפיין ותשלום עליו לא זמינים היום מהקוד.
כל קריאה היא POST אל https://xuda.ai/cpi/<method> עם המפתח שלכם ועם אובייקט data. התשובות חוזרות כ-{ "code": 1, "data": ... }; code שלילי הוא דחייה, עם הסיבה ב-data.
מתקציר לקמפיין רץ
מוצאים את הקמפיינים שלכם
get_account_advertising מפרטת את הקמפיינים של החשבון שלכם. לכל אחד יש מזהה: זה ה-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 או בשתיהן. הרשתות האחרות שהבונה מפרט מסומנות כבקרוב ואי אפשר להשיק אליהן.
הקמפיין נמצא עכשיו ברשת ומושהה. קוראים ל-set_ad_network_status עם "status": "active" כדי להתחיל אותו.
אלה המספרים שהסקירה מציירת, והם של הקמפיין שלכם בלבד: קריאה לקמפיין שאינו שלכם נדחית.
שיטות
get_account_advertising, שמפרטת את הקמפיינים של החשבון, שייכת למיקרו-שירות Account. ראו אתרים סטטיים לטבלת Account שהיא יושבת לידה.