تتيح نصوص "إعلانات 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 before.
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 before.
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"
تنطبق المفاهيم نفسها على معلومات الإعلان الإضافية الأخرى المتوافقة.
الوصول إلى إضافات الإعلانات على مستوى المجموعة الإعلانية
تتيح لك نصوص "إعلانات 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 won't
// 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);
إذا تمت إزالة جميع التطبيقات للأجهزة الجوّالة من حملة، لن تتضمّن الحملة بعد ذلك إضافة تطبيق للأجهزة الجوّالة. لإزالة جميع التطبيقات للأجهزة الجوّالة من حملتك، عليك استرداد قائمة التطبيقات للأجهزة الجوّالة لهذه الحملة وإزالتها واحدًا تلو الآخر. وينطبق الإجراء نفسه على معلومات الإعلان الإضافية الأخرى المتوافقة.