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

تتيح لك نصوص "إعلانات 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"

ملاحظة: إذا عدّلت 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 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);

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