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

تتيح النصوص البرمجية في "إعلانات 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);

في حال إزالة جميع تطبيقات الأجهزة الجوّالة من حملة معيّنة، لن تتضمّن الحملة إضافة تطبيق جوّال. لإزالة جميع تطبيقات الأجهزة الجوّالة من حملتك، عليك retrieving retrieve list of mobile apps for that campaign and remove them one at a time. وينطبق الإجراء نفسه على الإضافات الإعلانية الأخرى المتاحة.