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

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

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

يتعذّر تنفيذ البرنامج النصي بسبب الخطأ "Cannot find function: FUNCTION_NAME" (لم يتم العثور على الدالة: FUNCTION_NAME)

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

  1. تأكَّد من كتابة اسم الدالة بشكل صحيح ومن أنّ حالة الأحرف صحيحة، مثلاً: سيؤدي استخدام AdsApp.keywordz() إلى ظهور هذا الخطأ، لأنّ keywordz ليست دالة صالحة في فئة AdsApp. سيتعذّر أيضًا تنفيذ AdsApp.Keywords() بسبب حالة الأحرف غير الصحيحة للدالة keywords().

  2. تأكَّد من توفّر الدالة، مثلاً: سيتعذّر تنفيذ AdsApp.keywords().next() لأنّ AdsApp.keywords() تعرض KeywordSelector، بينما next() هي طريقة لكائن KeywordIterator. سيكون الرمز الصحيح هو AdsApp.keywords().get().next().

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

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

أسلوب الترميز مقتطف الرمز
الإصدار 1 (لا يعمل)
function main() {
  // Call to getCampaigns is missing, so this script does nothing.
}

function getCampaigns() {
  // AdsApp.campaigns() will return all Search and Display 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 getCampaigns is missing, so this script does nothing.

  function getCampaigns() {
    // AdsApp.campaigns() will return all Search and Display 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() {
  getCampaigns();
}

function getCampaigns() {
  // AdsApp.campaigns() will return all Search and Display 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());
  }
}

تظهر لي رسالة الخطأ "Cannot find function 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

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

  1. تحقَّق من النطاق الزمني الذي تستردّ الإحصاءات أو تُنشئ التقارير له.

  2. إذا استرجعت إحصاءات على مستوى الحساب لبرنامج نصي في "مدير إعلانات Google" يدير حسابات بعملات مختلفة، سيتم عرض التكلفة بعملة الحساب الإداري.

  3. قد لا تتوفّر البيانات التي تبحث عنها في "إعلانات Google" بعد. يمكنك الاطّلاع على دليل حداثة البيانات للاطّلاع على التفاصيل.

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

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

هل ما زلت بحاجة إلى الدعم؟

إذا كنت بحاجة إلى مساعدة في مجال يمكننا تقديمها، يُرجى الانتقال إلى صفحة الحصول على المساعدة.