העברה

התשתית החדשה של הסקריפטים של Google Ads מבוססת על Google Ads API. בגלל הארכיטקטורה השונה של ה-API, יכול להיות שתצטרכו לעדכן את הסקריפטים הקיימים. עשינו כל מאמץ כדי להבטיח תאימות לאחור ככל האפשר, כך שהשינויים אמורים להיות קטנים.

דוחות

דוחות AWQL רבים ימשיכו לפעול. מאחורי הקלעים, כשמשתמשים בתשתית החדשה, הסקריפטים ממירים את השאילתה של AWQL ל-GAQL (שפת השאילתות החדשה של Google Ads API), מריצים אותה מול הקצה העורפי החדש ולאחר מכן ממירים את התוצאות בחזרה לפורמט שבו נעשה שימוש במקור בדוחות AWQL. שאילתות עם GAQL יועברו כפי שהן.

בגלל התקורה הזו, מומלץ לעבור על הסקריפטים ולעדכן את שאילתות AWQL ל-GAQL ככל האפשר. אפשר להשתמש בכלי להעברת שאילתות, שמשתמש באותו לוגיקה כמו סקריפטים כדי לקבוע את שאילתת ה-GAQL לשאילתת AWQL נתונה. לחלופין, אפשר להשתמש בכלי האינטראקטיבי ליצירת שאילתות כדי לעזור ביצירת שאילתות.

יש כמה מגבלות על התרגום האוטומטי מ-AWQL ל-GAQL:

• לא כל השאילתות של AWQL מתורגמות בצורה נקייה לשאילתות של GAQL. במקרים כאלה, תופיע הודעת שגיאה עם פרטים על מה שהשתבש, כדי שתוכלו לתקן את השגיאות באופן ידני.
• לא כל סוגי הדוחות מ-AWQL נתמכים ב-GAQL.
• ב-GAQL אין תמיכה ב'שורות אפס חשיפות'. אם מציינים שדוח צריך לכלול אפס חשיפות, תופיע שגיאה.
• אי אפשר להשתמש בחלק מהשדות המעורפלים במסננים. לדוגמה, השדה 'כותרת' יכול להפנות למספר שדות שונים במודעה.
• יכול להיות שבשדות מסוימים יופיעו תוצאות בפורמט אחר, למשל, פיצול של תוצאה אחת לעמודות רבות.

ארגון הבוררים

כשאחזרים משאבים באמצעות סקריפטים, מקובל להשתמש בקריאות 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 (SpreadsheetApp,‏ MailApp וכו') לא השתנו.
• המכסות של Google Ads ייאכפו כאילו אתם משתמשים ב-API. כלומר, הסקריפט יהיה כפוף למגבלות הקצב של ה-API, אבל כך תוכלו לגשת לדוחות נוספים או לבצע יותר שינויים בכל הפעלה.

שינויים נוספים

ExecutionInfo לא חושף יותר את getRemainingCreateQuota() או את getRemainingGetQuota(), כי המכסות האלה לא רלוונטיות יותר בממשק החדש.