แก้ไขปัญหาเกี่ยวกับฟีดข้อมูล

ใช้วิธีแก้ไขปัญหาและแนวทางต่อไปนี้กับปัญหาเกี่ยวกับฟีดข้อมูลที่อาจพบ

ดูกฎที่แนะนำ

หากต้องการสร้างรายการกฎทั้งหมดที่เกี่ยวข้องกับฟีดข้อมูล ให้เรียก HTTP GET ไปที่:

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

โปรดดูรายละเอียดในAPI กฎของฟีดข้อมูลสินค้า, ข้อมูลอ้างอิง

คุณสามารถดึงข้อมูลกฎที่แนะนำจาก Meta เพื่อใช้แก้ไขข้อผิดพลาดในฟีดข้อมูลของคุณได้ ให้ทำตามขั้นตอนต่อไปนี้เพื่อดูกฎที่แนะนำสำหรับเซสชั่นการอัพโหลด

ขั้นตอนที่ 1: เรียกดูเซสชั่นการอัพโหลด:

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

ขั้นตอนที่ 2: เรียกดูข้อผิดพลาดของเซสชั่นการอัพโหลด:

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

ขั้นตอนที่ 3: เรียกดูกฎที่แนะนำสำหรับข้อผิดพลาดในการอัพโหลด:

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
แก้ไข Enum 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 ที่อยู่ในพิกเซลหรือเหตุการณ์ในแอพไม่ตรงกับ ID ในฟีดข้อมูลของแค็ตตาล็อก
พิกเซลหรือแอพไม่เชื่อมโยงกับแค็ตตาล็อก
ไม่มีสินค้านั้นอยู่ในแค็ตตาล็อก

เรียนรู้เพิ่มเติมที่นี่

เรียนรู้เพิ่มเติมเกี่ยวกับการแก้ไขปัญหาในฟีดของคุณด้วย Blueprint

ส่งคำขอรายงานข้อผิดพลาดในการอัพโหลดฟีดข้อมูล

โฆษณาแค็ตตาล็อก Advantage+

คุณสามารถใช้ API รายงานข้อผิดพลาดในการอัพโหลดฟีดข้อมูลเพื่อส่งคำขอรายงานข้อผิดพลาดทั้งหมดของเซสชั่นการอัพโหลดฟีดที่ต้องการ เมื่อเราได้รับคำขอแล้ว เราจะเริ่มทำงานในพื้นหลังเพื่อจัดทำข้อมูลข้อผิดพลาดดังกล่าว แล้วจัดเก็บไว้ในไฟล์ CSV

หากต้องการส่งคำขอรายงานข้อผิดพลาดทั้งหมด ให้ใช้ POST /{upload_session_id}/error_report

ในรายงานประกอบด้วยข้อมูลต่อไปนี้

ID ผู้ค้าปลีกสินค้าที่มีข้อผิดพลาด
ข้อความแสดงข้อผิดพลาด
ความรุนแรงของข้อผิดพลาด (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,
}

การค้า

การดึงข้อมูลสุ่มตัวอย่างข้อผิดพลาดและคำเตือนมักเป็นวิธีที่ดีพอที่จะแก้ไขปัญหาการอัพโหลดฟีดสินค้าส่วนใหญ่ได้ อย่างไรก็ตาม คุณอาจต้องใช้รายการข้อผิดพลาดทั้งหมดในการวิเคราะห์แบบเจาะลึก หากจะดาวน์โหลดรายการข้อผิดพลาดและคำเตือนทั้งหมด คุณต้องสืบค้นเซสชั่นที่อัพโหลดล่าสุดก่อน

คุณสามารถส่งคำขอให้สร้างรายงานข้อผิดพลาดทั้งหมดตาม ID เซสชั่นการอัพโหลดที่กำหนด

คำขอ

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 ที่คุณสามารถดาวน์โหลดได้ (เช่น URL ที่มี Wget, cURL และอื่นๆ) ไฟล์ที่ดาวน์โหลดมาจะประกอบด้วยรายงานข้อผิดพลาดทั้งหมด

หากคุณได้รับข้อผิดพลาดต่อไปนี้ที่ระบุว่า “ไม่สามารถเข้าถึงอ็อบเจ็กต์ที่ไม่ได้จัดการโดยธุรกิจที่เป็นเจ้าของแอพนี้” โปรดตรวจสอบให้แน่ใจว่าแอพที่คุณใช้อยู่เป็นของธุรกิจจริงๆ (การตั้งค่าธุรกิจ > บัญชี > แอพ)

ในกรณีที่รายงานยังไม่พร้อม ให้ดำเนินการเรียกเหมือนครั้งล่าสุดอีกครั้งหลังผ่านไป 2 - 3 วินาที จากนั้นคุณก็จะดาวน์โหลดรายงานนั้นได้

ดึงข้อมูลสถานะของรายงานข้อผิดพลาด

เมื่อส่งคำขอรายงานแล้ว ให้ใช้ 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`	เกิดข้อผิดพลาดในฝั่งเราขณะกำลังจัดทำรายงานข้อผิดพลาดนี้ คุณสามารถส่งคำขอรายงานข้อผิดพลาดเพื่อลองใหม่อีกครั้ง

หมายเหตุ: สามารถดาวน์โหลด CDN URL ที่ใช้รายงานข้อผิดพลาดนี้ได้ และระบบจะส่งคืนค่า “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"
          }
        ]
      }
    }
  ]
}