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

חשוב: תוכלו להמשיך לעבוד עם התוספים מבוססי-הפידים הנוכחיים שלכם, דרך ממשק הסקריפטים של Google Ads מדור קודם. עם זאת, בקרוב לא תהיה יותר גישה לתוספים שמבוססים על פידים, ותוספים שמבוססים על נכסים יהיו זמינים רק בממשק החדש של הסקריפטים של 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
PhoneNumber	getEndDate getStartDate
מחיר	getEndDate getSchedules getStartDate
Sitelink	אין שיטות שהוצאו משימוש
קטע קוד	getEndDate getSchedules getStartDate

המערכת מעדכנת את התוספים למודעות

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

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

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

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

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

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

אם רוצים ליצור תוסף מבוסס-פיד במקום להסתמך על התנהגות ברירת המחדל, אפשר לקרוא ל-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