העברת סקריפטים של תוספים למודעות

חשוב: תוכלו להמשיך לעבוד עם התוספים הנוכחיים שמבוססים על פידים דרך הממשק הקודם של Google Ads Scripts. עם זאת, בקרוב התוספים שמבוססים על פידים לא יהיו זמינים, והתוספים שמבוססים על נכסים יהיו זמינים רק בממשק הסקריפטים החדש של Google Ads. מומלץ להעביר את הסקריפטים הקודמים של Google Ads לממשק הסקריפטים החדש של Google Ads בהקדם האפשרי.

במסמך הזה מתואר תהליך ההעברה של סקריפטים שמקבלים גישה לתוספים של מודעות או מנהלים אותם. החל מ-28 במרץ 2022, תתבצע העברה של תוספי המודעות המבוססים על פידים של לקוחות שיש להם סקריפטים לעדכון תוספי המודעות לתוספים חדשים המבוססים על נכסים דיגיטליים. החל מ-13 במאי 2022, התוספים שמבוססים על פידים יועברו לתוספים חדשים שמבוססים על נכסים דיגיטליים אצל לקוחות שיש להם סקריפטים שמאחזרים תוספים למודעות (בלי סקריפטים שמעדכנים את התוספים למודעות).

סקירה כללית

הערה: אם אין לכם סקריפטים שמקבלים גישה לתוספים למודעות או מעדכנים אותם, אין צורך לבצע שום פעולה. במקום זאת, תוכלו לעיין במדריך בנושא תוספים למודעות.

הפרדיגמה הקיימת של תוספים מבוססי-פידים הוצאה משימוש ומתאימה לתוספים המבוססים על נכסים. תוספים המבוססים על פידים נקראים בממשק המשתמש של Google Ads 'תוספים מדור קודם', ותוספים המבוססים על נכסים נקראים תוספים 'משודרגים' בממשק המשתמש של Google Ads.

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

פרטי ההעברה

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

אחזור תוספים למודעות

הקבוצה הקיימת של בוררי תוספי המודעות (לדוגמה, SitelinkSelector) יכולה לאחזר תוספים של מודעות שמבוססים על פידים או תוספים של מודעות שמבוססים על נכסים. כברירת מחדל, הבוררים האלה יחזירו את סוג התוסף למודעה שמוצג כרגע. בטבלה הבאה מפורט סוג התוסף של מודעות שמוצג כרגע (ולכן יוחזר כברירת מחדל):

סוג התוספים למודעות בחשבון
רק תוספי מודעות שמבוססים על פידים	תוספי מודעות שמבוססים על פידים יוחזרו כברירת מחדל
רק תוספי מודעות מבוססי-נכסים	תוספי מודעות מבוססי-נכסים יחזרו כברירת מחדל
גם תוספי מודעות שמבוססים על פידים וגם תוספי מודעות שמבוססים על נכסים	תוספים למודעות שמבוססים על נכסים יוחזרו כברירת מחדל

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

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

ברוב המקרים, לא נדרשים שינויים בקוד לפני או אחרי העברת התוספים המבוססים על פידים. עם זאת, יש כמה תרחישים שבהם יכול להיות שיהיה צורך לבצע שינויים בקוד.

סינון תוספים למודעות לפי מזהה

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

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

כדי לפתור את הבעיה, צריך לסנן לפי מאפיין אחר או לעדכן את הקוד כך שישתמש במקום זאת במזהים של התוספים למודעות שמבוססים על נכסים.

סינון תוספים למודעות לפי נתונים סטטיסטיים

כשמתבצעת העברה של תוסף מודעה שמבוסס על פיד, הנתונים הסטטיסטיים של תוסף המודעה התואם שמבוסס על נכס יאופסו. צריך להביא זאת בחשבון כשמסננים תוספים למודעות לפי נתונים סטטיסטיים. לדוגמה, אם מבקשים תוספי Sitelink עם Clicks > 100 ב-LAST_MONTH, יכול להיות שיוצגו פחות תוספי מודעות מהרגיל אם תוספי המודעות שמבוססים על פיד הועברו לאחרונה.

חשוב לזכור את זה גם כשיוצרים דוחות ביצועים של התוספים למודעות. יכול להיות שתבחינו בשינויים משמעותיים או בירידות חדות בדוחות אחרי ההעברה של תוספי המודעות שמבוססים על פידים.

שיטות שהוצאו משימוש

כחלק מההעברה, כמה שדות לא נתמכים יותר. לדוגמה, תאריך ההתחלה ותאריך הסיום הוצאו משימוש בתוספי נכסי מידע מובנה. שיחות למספר getStartDate() יחזירו את המספר null. בנוסף, תירשם ביומן הודעת אזהרה. בטבלה הבאה מפורטות השיטות שהוצאו משימוש:

מחלקה	שיטות שהוצאו משימוש
יתרונות מרכזיים	אין שיטות שהוצאו משימוש
MobileApp	getSchedules
מספר טלפון	getEndDate getStartDate
מחיר	getEndDate getSchedules getStartDate
Sitelink	אין שיטות שהוצאו משימוש
קטע טקסט	getEndDate getSchedules getStartDate

עדכון תוספים למודעות

כחלק מההעברה, אין יותר תמיכה בכמה שדות. לדוגמה, תאריך ההתחלה ותאריך הסיום הוצאו משימוש בתוספי נכסי מידע מובנה. לשיחות למספר setStartDate לא תהיה השפעה על תוסף המודעה. בנוסף, תתועד הודעת אזהרה. בטבלה הבאה מפורטות השיטות שהוצאו משימוש:

מחלקה	שיטות שהוצאו משימוש
יתרונות מרכזיים	אין שיטות שהוצאו משימוש
MobileApp	setSchedules
מספר טלפון	clearEndDate clearStartDatesetEndDate setStartDate
מחיר	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Sitelink	אין שיטות שהוצאו משימוש
קטע טקסט	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

יצירת תוספים למודעות

הקבוצה הקיימת של הכלים ליצירת תוספים למודעות (לדוגמה, SitelinkBuilder) מאפשרת ליצור תוספים למודעות שמבוססים על פידים או תוספים למודעות שמבוססים על נכסים. כברירת מחדל, ה-builders האלה ייצרו את סוג התוסף להצגת מודעות שמוצג כרגע. בטבלה הבאה מפורט סוג התוסף של המודעות שמוצג כרגע (ולכן הוא ייווצר כברירת מחדל):

סוג התוספים למודעות בחשבון
רק תוספי מודעות שמבוססים על פידים	תוספי מודעות שמבוססים על פידים ייווצרו כברירת מחדל
רק תוספי מודעות מבוססי-נכסים	תוספים למודעות שמבוססים על נכסים ייווצרו כברירת מחדל
גם תוספי מודעות שמבוססים על פידים וגם תוספי מודעות שמבוססים על נכסים	תוספים למודעות שמבוססים על נכסים דיגיטליים ייווצרו כברירת מחדל

אחרי שהתוספים של הלקוח יועברו, כל הכלי ליצירת תוספי מודעות ייצרו תוספי מודעות שמבוססים על נכסים כברירת מחדל. לא תהיה יותר תמיכה ביצירה של תוספי מודעות שמבוססים על פיד, כי לא תהיה יותר אפשרות להציג תוספי מודעות שמבוססים על פיד.

אם רוצים ליצור תוסף שמבוסס על פיד במקום להסתמך על התנהגות ברירת המחדל, אפשר לעשות זאת על ידי קריאה ל-build(true) במקום ל-build(), לדוגמה:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

אם ברצונך ליצור תוסף שמבוסס על נכס, ובחשבון שלך יש כרגע רק תוספי פידים, אפשר להמתין עד 28 במרץ או להתקשר למספר build(false).

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

שדות לא נתמכים

במסגרת ההעברה של תוספי המודעות, שדות מסוימים הוצאו משימוש. לדוגמה, תאריך ההתחלה ותאריך הסיום הוצאו משימוש מתוספי קטע טקסט. לשיחות ל-withEndDate או ל-withStartDate לא תהיה השפעה על התוסף, במקום זאת תירשם הודעת אזהרה. בטבלה הבאה מפורטות השיטות שבוטלו לכל כיתה:

מחלקה	שיטות שהוצאו משימוש
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate