استكشاف أخطاء قائمة البيانات وإصلاحها

استخدم هذه الحلول والإرشادات لأي مشكلات في قائمة البيانات قد تواجهك.

عرض القواعد المقترحة

لإدراج جميع القواعد المرتبطة بقائمة البيانات، قم بإجراء استدعاء HTTP GET إلى:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/rules

للحصول على التفاصيل، راجع API قواعد قائمة بيانات المنتج، المرجع.

يمكنك الحصول على القواعد المقترحة من Meta لإصلاح الأخطاء في قائمة البيانات. لعرض القواعد المقترحة لجلسة التحميل، اتبع الخطوات التالية:

الخطوة الأولى: استرداد جلسات التحميل:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/uploads

الخطوة الثانية: استرداد أخطاء جلسة التحميل:

https://graph.facebook.com/<API_VERSION>/<UPLOAD_SESSION_ID>/errors

الخطوة الثالثة: استرداد القواعد المقترحة لخطأ التحميل:

curl -i -X GET 
 "https://graph.facebook.com/<API_VERSION>/<UPLOAD_ERROR_ID>/suggested_rules?access_token={ACCESS_TOKEN}

عينة من الاستجابة

"data": [
  
    "attribute": "description",
    "type": "letter_case_rule",
    "params": [
      
        "key": "type",
        "value": "capitalize_first"
      
    ]
  
]

للاطلاع على التفاصيل، راجع API القواعد المقترحة، المرجع.

تطبيق القواعد على قوائم البيانات

لتطبيق القواعد على قائمة البيانات، يجب ربط القاعدة بقائمة البيانات.

قم بإجراء استدعاء HTTP POST إلى:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/rules?attribute={ATTRIBUTE}&amp;rule_type={RULE_TYPE}&amp;params={PARAMS}

المثال

curl -i -X POST 
  -d "attribute=google_product_category" 
  -d "rule_type=mapping_rule" 
  -d "params=%7B'map_from'%3A%20'gcategory'%7D" 
  -d "access_token={ACCESS_TOKEN}" 
  "https://graph.facebook.com/<API_VERSION>/{PRODUCT_FEED_ID}/rules"

عينة من الاستجابة

"id": "{RULE_ID}"

قم بتنسيق params كما يلي:

نوع القاعدة	التنسيق	المثال	ملاحظات
قاعدة التعيين	"map_from": <string>	"map_from": "gavailability"
قاعدة تعيين القيمة	<string> : <string>	"InStock": "in stock"	الحد الأقصى لعدد التعيينات يقتصر على 10 تعيينات وطول السلاسل يصل إلى 20 حرفًا.
قاعدة حالة الحروف	"type": one of : "capitalize_first", "capitalize_all", "to_upper", "to_lower"	"type": "capitalize_first"

للحصول على التفاصيل، راجع API قواعد قائمة بيانات المنتج، المرجع.

إصلاح أخطاء تحميل قائمة البيانات من خلال القواعد

يمكنك إصلاح أخطاء تحميل قائمة البيانات المستمرة ومنعها من خلال القواعد. يمكنك توفير القواعد التي تطبقها Meta على كل تحميل لقائمة البيانات. حدد القواعد حسب السمة (العمود) التي يجب تطبيقها عليها، وحسب نوع القاعدة، وحسب المعلمات. لا يمكنك حاليًا استخدام القواعد مع API التجميع. يمكنك توفير هذه الأنواع من القواعد:

قاعدة التعيين - يتم تعيين السمات (أسماء الأعمدة) في ملف قائمة البيانات إلى السمات التي يمكننا التعرف عليها.
قاعدة تخطيط القيمة - يتم تعيين الحقول (قيم الأعمدة) في ملف قائمة البيانات إلى الحقول التي يمكننا التعرف عليها.
قاعدة الحالة الحروف - يتم تغيير حالة الكلمات في الحقل. على سبيل المثال، تغيير كافة الأوصاف بالأحرف الكبيرة إلى أحرف صغيرة.

على سبيل المثال، يمكنك حل هذه المشكلات باستخدام التعيين وقاعدة تعيين القيمة:

الأخطاء مطبعية في السمات من gavailability إلى availability
إصلاح التعدادات غير المعروفة InStock إلى in stock
تنسيق السعر من 45$ إلى 45.00 USD
حالة الترجمة: Neu ضمن الحالة: New

يمكنك استخدام قاعدة حالة الحروف لمعالجة هذه الأنواع من المشكلات:

تغيير الأوصاف بالأحرف الكبيرة BRAND NEW WITH LEATHER DETAIL... إلى Brand new with leather detail...
إصلاح العناوين بالأحرف الكبيرة FACEBOOK T-SHIRT إلى Facebook T-shirt

تحديث القواعد وحذفها

لتغيير قاعدة مقترنة بقائمة بيانات، قم بإجراء استدعاء HTTP POST لتحديث أي معلمات واستدعاء HTTP DELETE لحذفها. يمكنك تحديث المعلمات فقط. إذا كنت تريد تغيير attribute أو rule_type، فيجب حذف القاعدة وإعادة إنشاءها.

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_RULE_ID>?params={PARAMS}

للحصول على التفاصيل، راجع API قاعدة قائمة بيانات المنتج.

إصلاح العناصر المفقودة في كتالوج

في حالة إبلاغ مدير المعاملات التجارية أن بعض العناصر الموجودة في الكتالوج لديك مفقودة أو لا يمكن العثور عليها، فقد تحتاج إلى التحقق من إعداد التطبيق أو بيكسل Meta بصورة صحيحة. قد تصادف هذا الخطأ في الحالات التالية:

عندما لا يتطابق content_id المضمن في البيكسل أو حدث التطبيق مع المعرف الموجود في قائمة بيانات الكتالوج.
عندما يكون البيكسل أو التطبيق غير مرتبط بالكتالوج.
عندما يكون العنصر غير موجود في الكتالوج.

تعرف على المزيد هنا.

تعرف على المزيد حول استكشاف مشكلات قائمة البيانات وإصلاحها من خلال Blueprint.

طلب تقرير الخطأ في تحميل قائمة البيانات

إعلانات كتالوج Advantage+

يمكنك استخدام API تقرير خطأ تحميل قائمة البيانات لطلب تقرير خطأ كامل لأي جلسة تحميل قائمة بيانات. بمجرد استلام الطلب، نقوم بتشغيل مهمة في الخلفية لإعداد هذه الأخطاء وتخزينها في ملف CSV.

لطلب تقرير كامل عن الخطأ، استخدم POST /{upload_session_id}/error_report.

يحتوي التقرير على معلومات حول:

معرف بائع التجزئة للعنصر الذي يحتوي على خطأ
رسالة خطأ
مستوى خطورة الخطأ (FATAL إذا تسبب الخطأ في رفض العنصر، وWARNING إذا تم تحميل العنصر ولكن مع وجود خطأ)
أسماء الحقول التي ظهر هذا الخطأ فيها
الإمكانات التي تتأثر بهذا الخطأ؛ على سبيل المثال، الأخطاء التي تؤثر على إعلانات كتالوج Advantage+ التي تحتوي على 'da' داخل هذا العمود
إذا كان الخطأ يحجب إمكانية ما (true/false)؛ على سبيل المثال، إذا كان الخطأ يمنع ظهور العنصر على هذه الواجهة

الطلب

curl -i -X POST \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.intern.facebook.com/<API_VERSION>/<upload session ID>/error_report

الاستجابة تشير الاستجابة إلى ما إذا كان الطلب ناجحًا أم لا:

{
  "success": bool,
}

المعاملات التجارية

غالبًا ما يكون الحصول على عينة من الأخطاء والتحذيرات كافيًا لإصلاح معظم مشكلات تحميل قائمة بيانات المنتج. ومع ذلك، قد تحتاج إلى قائمة كاملة بالأخطاء لإجراء تحليل أعمق. لتنزيل قائمة كاملة بالأخطاء والتحذيرات، يجب أولاً الاستعلام عن أحدث جلسة تحميل (راجع القسم أعلاه).

يمكنك طلب إنشاء تقرير خطأ كامل لمعرف جلسة تحميل محدد.

الطلب

GET https://graph.facebook.com/vX.X/{upload-session-id}/?fields=error_report

الاستجابة

{
  "error_report": {
    "report_status": "WRITE_FINISHED",
    "file_handle": "{link-to-the-file-location}"
  },
  "id": "493476498092860"
}

يجب العثور على عنوان URL الذي يمكنك تنزيله (على سبيل المثال، باستخدام wget وcurl وما إلى ذلك). سيتضمن الملف الذي تم تنزيله تقريرًا كاملاً حول الخطأ.

إذا حصلت على هذا الخطأ: "لا يمكن الوصول إلى كائن لا يديره النشاط التجاري المالك لهذا التطبيق"، فيرجى التأكد من أن التطبيق الذي تستخدمه ينتمي إلى النشاط التجاري ( إعدادات مدير الأعمال > الحسابالتطبيقات).

في حالة أن التقرير غير جاهز، يمكنك تكرار الاستدعاء الأخير بعد بضع ثوان. يمكنك بعد ذلك تنزيل التقرير نفسه.

الحصول على حالة تقرير الخطأ

بمجرد طلب تقرير، استخدم GET /{upload_session_id}?fields=error_report للحصول على حالة تقرير الخطأ.

المثال

curl -i -X GET \
 https://graph.intern.facebook.com/<API_VERSION>/<upload session ID>?fields=error_report&access_token=ACCESS_TOKEN

الاستجابة

{
  "error_report": {
    "report_status": string,
    "file_handle": string, // if available
  }
  "id": "332552650711532 (https://developers.intern.facebook.com/tools/explorer/690422434302374?method=GET&path=332552650711532%3Ffields%3Derror_report&version=v3.2#)"
}

القيم المحتملة - الحالة التي يتم إرجاعها

القيمة	الوصف
`NOT_REQUESTED`	لم يتم طلب تقرير الخطأ الخاص بتحميل قائمة البيانات هذه.
`REQUESTED`	تم استلام الطلب وتجري معالجته.
`CREATED`	تم إنشاء التقرير بنجاح وفي انتظار كتابته في ملف CSV.
`WRITE_FINISHED`	تم إعداد ملف التقرير وهو جاهز للتحميل.
`SESSION_DATA_NOT_FOUND`	لم يتم العثور على أي بيانات لجلسة تحميل قائمة البيانات هذه، من المحتمل أنه لم تتم معالجة أي عناصر لتحميل قائمة البيانات هذه.
`ERROR_REPORT_OUTDATED`	تقرير الخطأ مضى عليه أكثر من 30 يومًا ولم يعد متوفرًا.
`FATAL_ERROR`	حدث خطأ ما من جانبنا أثناء محاولة إعداد تقرير الخطأ هذا. يمكنك طلب تقرير خطأ لإعادة المحاولة.

ملاحظة: يمكن تنزيل عنوان URL لـ CDN باستخدام تقرير الخطأ هذا وسيتم إرجاعه كـ "file_handle" عندما تكون حالة error_report بالقيمة WRITE_FINISHED.

إدارة أخطاء تحميل قائمة بيانات المنتجات

إعلانات كتالوج Advantage+

اقرأ وثائق أخطاء تحميل قائمة بيانات المنتجات. راجع أيضًا معالجة أخطاء تحميل قائمة بيانات المنتجات، منصة المعاملات التجارية.

الطلب

للحصول على أخطاء وتحذيرات من تحميل قائمة البيانات، يجب أولاً الاستعلام عن جلسات التحميل الأخيرة.

GET https://graph.facebook.com/vX.X/{product-feed-id}/uploads
Token: PAGE_ACCESS_TOKEN

بعد ذلك، استخدم upload_session_id لاسترداد الأخطاء والتحذيرات.

GET https://graph.facebook.com/vX.X/{upload-session-id}/errors
Token: PAGE_ACCESS_TOKEN

عينة من الاستجابة

يعني مستوى الخطورة fatal هنا أن العنصر لا يمكن استيعابه بواسطة Meta؛ في حين يعني مستوى الخطورة warning أن بعض السمات الموصى بها مفقودة أو تالفة.

{
  "data": [
    {
      "id": 1510567479166488,
      "summary": "A required field is missing: price.",
      "description": "Products need to have prices to run in ads. Include a price for each product in your data feed file and upload it again. Prices must include cost and an ISO currency code (for example: 10 USD instead of $10 for American dollars).",
      "severity": "fatal",
      "samples": {
        "data": [
          {
            "row_number": 2,
            "retailer_id": "yj9bpbpub5t8t22kgbq6",
            "id": "1677559492523068"
          },
          {
            "row_number": 5,
            "retailer_id": "ujn33tvbyv2vmdpo7ecb",
            "id": "1529743440653137"
          }
        ]
      }
    },
    {
      "id": 275241589314958,
      "summary": "GTIN is incorrectly formatted",
      "description": "Check that the GTIN (Global Trade Identification Number) for each of your products is in the correct format. Accepted types include UPC, EAN, JAN, and ISBN.",
      "severity": "warning",
      "samples": {
        "data": [
          {
            "row_number": 4,
            "retailer_id": "bxwb1pho9o43uxjxikcg",
            "id": "538700559625644"
          }
        ]
      }
    }
  ]
}

المعاملات التجارية

اقرأ وثائق أخطاء تحميل قائمة بيانات المنتجات. راجع أيضًا كيفية إدارة أخطاء تحميل قائمة بيانات المنتجات، إعلانات كتالوج Advantage+.

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

تعرف على المزيد حول إصلاح التحذيرات التشخيصية والأخطاء في مدير المعاملات التجارية من خلال Blueprint.

الطلب

GET https://graph.facebook.com/vX.X/{product-feed-id}/uploads

عينة من الاستجابة

{
  "data": [
    {
      "id": "493476498092860",
      "start_time": "2019-07-15T12:38:36+0000",
      "end_time": "2019-07-15T12:38:47+0000"
    }
  ]
}

بعد ذلك، استخدم القيمة التي تم إرجاعها في حقل id لاسترداد عينة من الأخطاء والتحذيرات.

الطلب

GET https://graph.facebook.com/vX.X/{upload-session-id}/errors

عينة من الاستجابة

{
  "data": [
    {
      "id": 1510567479166488,
      "summary": "A required field is missing: price.",
      "description": "Products need to have prices to run in ads. Include a price for each product in your data feed file and upload it again. Prices must include cost and an ISO currency code (for example: 10 USD instead of $10 for American dollars).",
      "severity": "fatal",
      "samples": {
        "data": [
          {
            "row_number": 2,
            "retailer_id": "yj9bpbpub5t8t22kgbq6",
            "id": "1677559492523068"
          },
          {
            "row_number": 5,
            "retailer_id": "ujn33tvbyv2vmdpo7ecb",
            "id": "1529743440653137"
          }
        ]
      }
    },
    {
      "id": 275241589314958,
      "summary": "GTIN is incorrectly formatted",
      "description": "Check that the GTIN (Global Trade Identification Number) for each of your products is in the correct format. Accepted types include UPC, EAN, JAN, and ISBN.",
      "severity": "warning",
      "samples": {
        "data": [
          {
            "row_number": 4,
            "retailer_id": "bxwb1pho9o43uxjxikcg",
            "id": "538700559625644"
          }
        ]
      }
    }
  ]
}

استكشاف أخطاء قائمة البيانات وإصلاحها

عرض القواعد المقترحة

تطبيق القواعد على قوائم البيانات

إصلاح أخطاء تحميل قائمة البيانات من خلال القواعد

تحديث القواعد وحذفها

إصلاح العناصر المفقودة في كتالوج

طلب تقرير الخطأ في تحميل قائمة البيانات

إعلانات كتالوج Advantage+

المعاملات التجارية

الحصول على حالة تقرير الخطأ

القيم المحتملة - الحالة التي يتم إرجاعها

إدارة أخطاء تحميل قائمة بيانات المنتجات

إعلانات كتالوج Advantage+

الطلب

عينة من الاستجابة

المعاملات التجارية

الطلب

عينة من الاستجابة

الطلب

عينة من الاستجابة

معرفة المزيد