معلومات الإعلان الإضافية

تتيح النصوص البرمجية في "إعلانات Google" الإضافات الإعلانية التالية:

• التطبيقات المتوافقة مع الأجهزة الجوّالة
• أرقام الهواتف
• وسائل الشرح
• الأسعار
• المقتطفات
• روابط أقسام المواقع

للاطّلاع على مزيد من المعلومات عن معلومات الإعلان الإضافية، يُرجى الانتقال إلى مركز المساعدة .

ملاحظة: ستحلّ الإضافات المستندة إلى مواد العرض قريبًا محلّ الإضافات المستندة إلى الخلاصات. اطّلِع على دليل نقل البيانات للحصول على مزيد من المعلومات.

تتيح لك نصوص "إعلانات Google" البرمجية الوصول إلى معلومات الإعلانات الإضافية المتوافقة في حسابك. على سبيل المثال، يصل مقتطف الرمز التالي إلى روابط أقسام الموقع:

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

يمكنك استرداد معلومات الإعلان الإضافية المتوافقة الأخرى بالطريقة نفسها باستخدام المتحقّقين المعنيّين.

الإنشاء

تتيح لك نصوص "إعلانات Google" البرمجية إنشاء إضافات إعلانات متوافقة. على سبيل المثال، يستخدم مقتطف الرمز التالي أداة إنشاء أرقام الهاتف لإنشاء رقم هاتف في حسابك:

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" الوصول إلى الإحصاءات المتعلّقة بإضافات الإعلانات المتوافقة على مستوى الحساب أو الحملة أو المجموعة الإعلانية.

على سبيل المثال، للحصول على إحصاءات روابط أقسام الموقع:

// 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" البرمجية. على سبيل المثال، سيُعدّل مقتطف الرمز التالي رابط قسم موقع حاليًا:

// 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، سيؤثر ذلك في عرض الإعلانات في جميع الحملات والمجموعات الإعلانية التي يرتبط بها رابط أقسام الموقع. تنطبق هذه القاعدة سواء استرجعت رابط أقسام الموقع مباشرةً من الحساب أو من CampaignSitelink لحملة مرتبطة أو من AdGroupSitelink لمجموعة إعلانية مرتبطة. ويوضّح مثال الرمز السابق هذا السلوك.

تنطبق المفاهيم نفسها على إضافات الإعلانات الأخرى المتوافقة.

الوصول إلى إضافات الإعلانات على مستوى المجموعة الإعلانية

تتيح لك نصوص "إعلانات Google" البرمجية الوصول إلى إضافات الإعلانات على مستوى المجموعة الإعلانية. سيعرض طلب الأسلوب التالي أرقام الهواتف التي تمت إضافتها صراحةً إلى مجموعة إعلانية. تجدر الإشارة إلى أنّه إذا تمت إضافة أرقام هاتف إلى الحملة التي تنتمي إليها المجموعة الإعلانية، لن تعرض الطريقة التالية للاتصال بها حتى عندما تكون أرقام الهاتف مؤهَّلة للظهور في الإعلانات المعروضة من تلك المجموعة الإعلانية.

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

يمكن الوصول إلى معلومات الإعلان الإضافية الأخرى المتاحة على مستوى المجموعة الإعلانية بطريقة مشابهة.

الوصول إلى معلومات الإعلان الإضافية على مستوى الحساب

تتيح لك نصوص "إعلانات Google" البرمجية الوصول إلى معلومات الإعلانات الإضافية على مستوى الحساب. يمكن إدراج وسائل الشرح وتطبيقات الجوّال والمراجعات كمعلومات إعلان إضافية على مستوى الحساب، لكن روابط أقسام الموقع وأرقام الهواتف على مستوى الحساب غير متاحة. ستؤدي طريقة الطلب التالية إلى عرض وسائل الشرح التي تمت إضافتها صراحةً إلى حسابك.

// 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" البرمجية إزالة إضافات الإعلانات من حساب في آنٍ واحد.

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

في حال إزالة جميع تطبيقات الأجهزة الجوّالة من حملة معيّنة، لن تتضمّن الحملة إضافة تطبيق جوّال. لإزالة جميع تطبيقات الأجهزة الجوّالة من حملتك، عليك استرداد قائمة تطبيقات الأجهزة الجوّالة لهذه الحملة وإزالتها واحدًا تلو الآخر. ينطبق الإجراء نفسه على معلومات الإعلان الإضافية الأخرى المتوافقة.