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

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

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

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

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

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

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

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

יצירה

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

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);

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

הצגת נתונים סטטיסטיים

סקריפטים של 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 ישירות מהחשבון, גם אם אחזרתם אותו מ-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 ברמת החשבון לא זמינים. כשמפעילים את השיטה הבאה, המערכת מחזירה נכסי יתרונות מרכזיים שנוספו במפורש לחשבון.

// 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);

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