تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

المشاكل الشائعة

هذه الرسالة عبارة عن مجموعة من المشاكل الأكثر شيوعًا التي تم طرحها في منتدى نصوص "إعلانات Google" البرمجية.

أخطاء JavaScript الشائعة

فشل النص البرمجي مع "لا يمكن العثور على الدالة: FUNCTION_NAME"

ويكون هذا عادةً نتيجة لحدوث خطأ إملائي في اسم الدالة في النص البرمجي.

تحقق من كتابة اسم الدالة بشكل صحيح ومن احتوائها على حالة إملائية صحيحة؛ على سبيل المثال، سيؤدي استخدام AdsApp.keywordz() إلى هذا الخطأ، لأنّ keywordz ليست دالة صالحة في فئة AdsApp. سيتعذّر تنفيذ AdsApp.Keywords() أيضًا بسبب وجود حالة إملائية غير صحيحة للدالة keywords().
تحقق من وجود الدالة؛ على سبيل المثال، لن ينجح AdsApp.keywords().next() لأنّ AdsApp.keywords() يعرض KeywordSelector بينما next() هي طريقة لكائن KeywordIterator. سيكون الرمز الصحيح هو AdsApp.keywords().get().next().

يتم تشغيل النص البرمجي الخاص بي، ولكن لا يفعل أي شيء

السبب الأكثر شيوعًا لهذه المشكلة هو أنّ لديك دالة تؤدي عملية لكنك لا تستدعيها من خلال طريقة main(). ويحدث هذا عادةً عند نسخ مقتطفات الرمز ولصقها من وثائقنا.

أسلوب الترميز	مقتطف الرمز
الإصدار 1 (لا يعمل)	function main() { // Call to getAllCampaigns is missing, so this script does nothing. } function getAllCampaigns() { // AdsApp.campaigns() will return all campaigns that are not // removed by default. let campaignIterator = AdsApp.campaigns().get(); console.log('Total campaigns found : ' + campaignIterator.totalNumEntities()); while (campaignIterator.hasNext()) { let campaign = campaignIterator.next(); console.log(campaign.getName()); } }
الإصدار 2 (لا يعمل)	function main() { // Call to getAllCampaigns is missing, so this script does nothing. function getAllCampaigns() { // AdsApp.campaigns() will return all campaigns that are not // removed by default. let campaignIterator = AdsApp.campaigns().get(); console.log('Total campaigns found : ' + campaignIterator.totalNumEntities()); while (campaignIterator.hasNext()) { let campaign = campaignIterator.next(); console.log(campaign.getName()); } } }
الإصدار 3 (يعمل)	function main() { getAllCampaigns(); } function getAllCampaigns() { // AdsApp.campaigns() will return all campaigns that are not removed // by default. let campaignIterator = AdsApp.campaigns().get(); console.log('Total campaigns found : ' + campaignIterator.totalNumEntities()); while (campaignIterator.hasNext()) { let campaign = campaignIterator.next(); Logger.log(campaign.getName()); } }

أسلوب الترميز

مقتطف الرمز

الإصدار 1 (لا يعمل)

function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not
  // removed by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    console.log(campaign.getName());
  }
}

الإصدار 2 (لا يعمل)

function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.

  function getAllCampaigns() {
    // AdsApp.campaigns() will return all campaigns that are not
    // removed by default.
    let campaignIterator = AdsApp.campaigns().get();
    console.log('Total campaigns found : ' +
        campaignIterator.totalNumEntities());
    while (campaignIterator.hasNext()) {
      let campaign = campaignIterator.next();
      console.log(campaign.getName());
    }
  }
}

الإصدار 3 (يعمل)

function main() {
  getAllCampaigns();
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not removed
  // by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    Logger.log(campaign.getName());
  }
}

يظهر لي الخطأ "لا يمكن العثور على الدالة getFinalUrl" عند ترقية نصوصي البرمجية

قد يحدث هذا الخطأ عند تغيير النص البرمجي للعمل مع عناوين URL التي تمت ترقيتها. يحدث ذلك عند استبدال المكالمات إلى ad.getDestinationUrl() باستخدام ad.getFinalUrl(). getFinalUrl() هي جزء من فئة AdUrls، لذلك يجب تغيير الرمز إلى ad.urls().getFinalUrl():

function main() {
  // Incorrect snippet. getFinalUrl is not a member of the Ad class.
  let ad = AdsApp.ads().get().next();
  let url = ad.getFinalUrl();

  // Correct snippet.
  let ad = AdsApp.ads().get().next();
  let url = ad.urls().getFinalUrl();
}

لا تصلني أي إحصاءات عن X

إنّ عدم توفّر البيانات لعنصر أو نطاق زمني معيّن هو خطأ شائع قد تواجهه عند إعداد التقارير أو إجراء طلبات بحث عن الإحصاءات. هناك العديد من الأشياء التي يمكنك تجربتها:

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

طلبات الميزات

هل تتوفّر الميزة س؟

يمكنك الاطّلاع على المستندات المرجعية.

متى ستتوفر الميزة X؟

نحن نحاول العمل على الميزات الأكثر طلبًا أولاً. إذا كانت هناك ميزة ترغب في مشاهدتها، فاتبع الخطوات التالية:

أولاً، تأكّد من أن الميزة غير معتمدة في نصوص "إعلانات Google" البرمجية من خلال مراجعة المستندات المرجعية.
في حال عدم توفّره، ابحث في منتدى نصوص "إعلانات Google" البرمجية لمعرفة ما إذا كان قد سبق طرحه هذا السؤال من قبل. إذا كانت الإجابة بنعم، فادعم سلسلة المحادثات هذه، أو اترك تعليقًا إذا كنت تريد مشاركة تفاصيل إضافية مثل حالة الاستخدام.
إذا لم يتم طلب الميزة بعد، يمكنك تقديم طلب ميزة من خلال فتح سلسلة محادثات جديدة في منتدى نصوص "إعلانات Google" البرمجية. تأكد من تقديم حالة استخدام تحلها هذه الميزة. إذا أمكن، أدرِج رابطًا يؤدي إلى دليل مركز المساعدة أو مشاركة أو دليل في AdWords API يصف هذه الميزة. سيساعد ذلك المطورين الآخرين عند التصويت لصالح طلب ميزة. نعطي الأولوية لطلبات الميزات حسب مدى رواجها.
ضع علامة على المشاركة كـ "طلب ميزة" لنسهّل علينا (وكذلك على المستخدمين) التحقق السريع من طلبات الميزات.

كيف يمكنني استخدام الميزة "س"؟

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