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

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

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

يتعذّر النص البرمجي مع "لا يمكن العثور على الدالة: 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 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

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

  1. تحقّق من النطاق الزمني الذي تسترجع فيه الإحصاءات أو تشغِّل التقارير.

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

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

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

هل الميزة X متاحة؟

اطلع على المرجع ذات الصلة.

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

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

  1. أولاً، تحقَّق من أنّ الميزة غير متاحة في نصوص "إعلانات Google" البرمجية عن طريق التحقق من المرجع ذات الصلة.

  2. وإذا لم تكن متاحة، ابحث عن نصوص "إعلانات Google" البرمجية المنتدى لمعرفة ما إذا كانت سأل عنها بالفعل. إذا كانت الإجابة "نعم"، يُرجى التصويت المؤيّد على سلسلة المحادثات هذه أو ترك إذا كنت تريد مشاركة تفاصيل إضافية مثل حالة استخدام،

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

  4. وضع علامة "طلب ميزة" على المشاركة لتسهيل الأمر بالنسبة لنا (بالإضافة إلى المستخدمين) للتحقق بسرعة من طلبات الميزات.

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

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