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

تتوافق نصوص "إعلانات 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);

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