תשתית הסקריפטים החדשה של Google Ads מבוססת על Google Ads API. בגלל הארכיטקטורה השונות של אותו API, יכול להיות שתצטרכו לעדכן את הסקריפטים הקיימים. עשינו כל מאמץ כדי להבטיח תאימות לאחור רבה ככל האפשר, כך שהשינויים האלה אמורים להיות קלים.
דוחות
דוחות AWQL רבים ימשיכו לפעול. מאחורי הקלעים, כשמשתמשים בתשתית החדשה, הסקריפטים ממירים את שאילתת ה-AWQL ל-GAQL (שפת השאילתות החדשה של Google Ads API), מריצים אותה מול הקצה העורפי החדש ואז מומרים את התוצאות חזרה לפורמט שהיה בשימוש בדוחות AWQL. שאילתות עם GAQL יועברו כפי שהן.
עקב התקורה הזו, מומלץ לעבור על הסקריפטים ולעדכן שאילתות AWQL ל-GAQL ככל האפשר. אפשר להשתמש בכלי להעברת שאילתות, שמשתמש באותה לוגיקה כמו סקריפטים כדי לקבוע את שאילתת ה-GAQL של שאילתת AWQL נתונה, או להשתמש בכלי ליצירת שאילתות אינטראקטיבי כדי ליצור שאילתות.
הנה כמה מגבלות על התרגום האוטומטי של AWQL-to-GAQL:
- לא כל שאילתות ה-AWQL מתורגמות בצורה ברורה לשאילתות GAQL. במקרים כאלה, תתועד הודעת שגיאה עם כמה פרטים על הבעיה, כדי לעזור לכם לתקן אותם ידנית.
- לא כל סוגי הדוחות מ-AWQL נתמכים ב-GAQL.
- ב-GAQL אין תמיכה ב "אפס שורות של חשיפות". ציון שהדוח צריך לכלול אפס חשיפות יגרום לשגיאה.
- בחלק מהשדות לא ברורים אי אפשר להשתמש במסננים. לדוגמה, הכותרת "Headline" יכולה להפנות לכל מספר של שדות מודעה שונים.
- חלק מהשדות עשויים להחזיר תוצאות בפורמט אחר, לדוגמה, פיצול של תוצאה אחת לעמודות רבות.
ארגון הבוררים
כשמאחזרים משאבים באמצעות סקריפטים, מקובל להשתמש בקריאות withCondition ו-orderBy כדי להגביל או לסדר את התוצאות באיטרטור. השדות בקריאות האלה משתמשים עכשיו בשמות החדשים של Google Ads API. לדוגמה, כדי לסנן לפי שם קמפיין, בעבר השתמשת ב:
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
עכשיו צריך להשתמש בשמות השדות החדשים לתנאים האלה ככל האפשר:
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
עם זאת, עשינו מאמץ לכלול מיפוי של שמות ישנים לשמות חדשים, כך שאם הסקריפט עדיין משתמש ב-CampaignName, הוא יוחלף אוטומטית ב-campaign.name בזמן הריצה כדי להבטיח שהסקריפט עדיין יפעל. במקרה שנתקלת בבעיות עם שמות הסגנונות הישנים, כדאי לעדכן את הסקריפטים כדי להשתמש בשמות הסגנונות החדשים כשלב הראשון לפתרון בעיות.
מגבלות
מגבלות רבות זהות לאלו שהיו בתשתית הישנה, והשינויים שיבוצעו כאן יעזרו בדרך כלל בשיפור הביצועים.
- מגבלות הזמן זהות. סקריפט עשוי לפעול במשך 30 דקות.
- איטרטור יחיד מחזיר 50,000 ישויות כברירת מחדל, אבל אפשר לשנות את זה. בעבר, לא הייתה אפשרות להתאים אישית את המגבלה של 50,000 יחידות.
- בורר יחיד יכול לטפל ב-10,000 מזהים לכל היותר (ללא שינוי).
- בתשתית החדשה אין הגבלה על מספר הישויות שאפשר לעבד בסקריפט יחיד. בעבר המגבלה הייתה 250,000.
- בתשתית החדשה אין הגבלה על מספר מילות המפתח והמודעות שאפשר ליצור בכל הפעלה. בעבר המגבלה הייתה 250,000.
- פלט הרישום ביומן נחתך ב-100kb (ללא שינוי).
- המכסות של שירותי Apps Script (גיליון אלקטרוני, MailApp וכו') לא ישתנו.
- המכסות של Google Ads ייאכפו כאילו השתמשת ב-API. כלומר, הסקריפט יהיה כפוף למגבלות קצב של יצירת בקשות ב-API, אבל כך יש יותר גמישות ואפשרות לגשת ליותר דוחות או לבצע שינויים נוספים בכל הפעלה.
שינויים נוספים
התג ExecutionInfo לא חושף יותר את getRemainingCreateQuota() או את getRemainingGetQuota(), כי המכסות האלה לא חלות יותר בממשק החדש.