פרק 17: אינטגרציות¶
קהל יעד: DevOps, מהנדסי פלטפורמה
חשבונות שירות GCP¶
Cat-Scan זקוקה להרשאות חשבון שירות GCP לצורך אינטראקציה עם ממשקי API של Google.
הקמה:
1. צרו חשבון שירות בפרויקט ה-GCP שלכם עם גישה ל-Authorized Buyers API.
2. הורידו את קובץ מפתח ה-JSON.
3. העלו אותו ב-/settings/accounts > לשונית API Connection.
4. אמתו את החיבור: Cat-Scan בודקת נגישות והרשאות.
מה זה מאפשר:
- גילוי מושבים (discoverSeats)
- סנכרון תצורת Pretargeting (syncPretargetingConfigs)
- סנכרון נקודות קצה RTB (syncRTBEndpoints)
- איסוף קריאייטיבים (collectCreatives)
סטטוס פרויקט:
בדקו את תקינות פרויקט ה-GCP ב-/settings/accounts או דרך
GET /integrations/gcp/project-status. בדיקה זו מאמתת שחשבון השירות תקף, הפרויקט נגיש, וממשקי ה-API הנדרשים מופעלים.
Google Authorized Buyers API¶
Cat-Scan מסנכרנת נתונים מ-Authorized Buyers API:
| פעולה | מה היא שולפת | מתי להריץ |
|---|---|---|
| גילוי מושבים | חשבונות קונים המקושרים לחשבון השירות | הקמה ראשונית, כאשר מושבים חדשים נוספים |
| סנכרון Pretargeting | מצב תצורת Pretargeting נוכחי מ-Google | לאחר שינויים חיצוניים בממשק AB |
| סנכרון נקודות קצה RTB | כתובות URL וסטטוס של נקודות קצה של מגיש הצעות | הקמה ראשונית, לאחר שינויים בנקודות קצה |
| סנכרון קריאייטיבים | מטאדאטה של קריאייטיבים (פורמטים, גדלים, יעדים) | מעת לעת, דרך "Sync All" בסרגל הצד |
אינטגרציית Gmail¶
Google Authorized Buyers שולחת דוחות CSV יומיים בדואר אלקטרוני. Cat-Scan יכולה לקלוט אותם באופן אוטומטי.
הקמה:
1. עברו ל-/settings/accounts > לשונית Gmail Reports.
2. הרשו ל-Cat-Scan לגשת לחשבון Gmail שמקבל דוחות AB.
3. Cat-Scan תסרוק הודעות דוח חדשות ותייבא קבצי CSV מצורפים.
ניטור:
- GET /gmail/status: מצב נוכחי, מספר הודעות שלא נקראו, סיבה אחרונה
- POST /gmail/import/start: הפעלה ידנית של מחזור ייבוא
- POST /gmail/import/stop: עצירת ייבוא פעיל
- GET /gmail/import/history: רשומות ייבוא קודמות
פתרון תקלות:
- מספר הודעות שלא נקראו גבוה (30+): צבר ייבוא, ייתכן שנדרשת התערבות ידנית
- last_reason: error: בדקו לוגים, ייתכן שנדרשת הרשאה מחדש
- ראו פתרון תקלות לצעדים מפורטים.
ספקי AI לשפה¶
Cat-Scan משתמשת ב-AI לזיהוי שפת קריאייטיבים ולסימון אי-התאמות גיאו-לשוניות (למשל, מודעה בספרדית בשוק ערבי).
ספקים נתמכים:
| ספק | הגדרה |
|---|---|
| Gemini | מפתח API ב-/settings/accounts |
| Claude | מפתח API ב-/settings/accounts |
| Grok | מפתח API ב-/settings/accounts |
הגדרה דרך GET/PUT /integrations/language-ai/config. רק ספק אחד צריך להיות פעיל.
Webhooks להמרות¶
מערכות חיצוניות שולחות אירועי המרה ל-Cat-Scan דרך webhooks.
שכבות אבטחה:
| שכבה | ייעוד | הגדרה |
|---|---|---|
| אימות HMAC | מבטיח שהבקשות אותנטיות (חתומות עם סוד משותף) | סוד משותף מוגדר בהגדרות webhook |
| הגבלת קצב | מונע שימוש לרעה | אוטומטי, ספי הגבלה ניתנים להגדרה |
| ניטור רעננות | מתריע כאשר אירועים מפסיקים להגיע | חלון יושנוּת ניתן להגדרה |
ניטור:
- GET /conversions/security/status: סטטוס HMAC, סטטוס הגבלת קצב, סטטוס רעננות
- GET /conversions/health: תקינות קליטה וצבירה כוללת
- GET /conversions/readiness: האם נתוני ההמרות עדכניים מספיק כדי לסמוך עליהם
קישורים¶
- סקירת ארכיטקטורה: היכן האינטגרציות משתלבות
- ניהול משתמשים: ניהול חשבונות שירות
- לקוני מדיה: המרות ושיוך מכסה את הגדרת ההמרות מצד הקונה.