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

הסקריפטים של Google Ads תומכים בתוספים הבאים למודעות:

• אפליקציות לנייד
• מספרי טלפון
• נכסי יתרונות מרכזיים
• מחירים
• קטעי טקסט
• קישורי Sitelink

מידע נוסף על תוספים למודעות זמין במרכז העזרה.

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

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

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

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

יצירה

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

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

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

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

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

הנתונים הסטטיסטיים מתקבלים

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

לדוגמה, כדי לקבל נתונים סטטיסטיים לגבי קישורי Sitelink:

// Account-level stats
// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
const sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
console.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
const campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
console.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.log(adGroupSitelinkStats.getClicks());

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

שינוי תוספים למודעות

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

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as above.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
console.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as above.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns
// and ad groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

הערה: שינוי של Sitelink ישפיע על הצגת המודעות בכל הקמפיינים והקבוצות של מודעות שאליהם ה-Sitelink משויך. כלל זה חל במקרה שאחזרת את ה-Sitelink ישירות מהחשבון, מ-CampaignSitelink של קמפיין משויך או מ-AdGroupSitelink של קבוצת מודעות משויכת. הדוגמה הקודמת ממחישה את ההתנהגות הזו.

אותו עיקרון חל על תוספים נתמכים אחרים למודעות.

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

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

// This will return phone numbers that have been explicitly added to this
// ad group.
const adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

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

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

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

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.currentAccount().extensions().callouts().get();

ניתן לגשת לאפליקציות לנייד ולביקורות ברמת החשבון באופן דומה.

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

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.currentAccount().addCallout(newCallout);

ניתן להוסיף ביקורות ואפליקציות לנייד ברמת החשבון באופן דומה.

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

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

// Get a mobile app from a campaign.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the
// following iterator.
const mobileAppIterator = AdsApp.extensions().mobileApps().get();

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

// Get a mobile app from an ad group.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it will
// not serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

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