Memecahkan Masalah Feed Data Anda

Gunakan solusi dan panduan ini untuk masalah feed data yang mungkin Anda temui.

Lihat Aturan yang Disarankan

Untuk membuat daftar semua aturan yang terkait dengan feed data, buat panggilan HTTP GET ke:

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

Untuk detailnya, lihat Aturan Feed Data Produk API, Referensi.

Anda bisa mendapatkan aturan yang disarankan dari Meta untuk memperbaiki kesalahan di feed data Anda. Untuk melihat aturan yang disarankan untuk sesi unggahan Anda, ikuti langkah-langkah berikut:

Langkah 1: Ambil sesi unggahan:

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

Langkah 2: Ambil kesalahan untuk sesi unggahan:

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

Langkah 3: Ambil aturan yang disarankan untuk kesalahan unggahan:

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

Contoh Tanggapan

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

Untuk detailnya, lihat Aturan yang Disarankan API, Referensi.

Terapkan Aturan ke Feed Data

Untuk menerapkan aturan ke feed data, Anda perlu mengaitkan aturan ke feed data.

Buat panggilan HTTP POST ke:

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

Contoh

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"

Contoh Tanggapan

"id": "{RULE_ID}"

Format params sebagai berikut:

Jenis Aturan	Format	Contoh	Catatan
Aturan Pemetaan	"map_from": <string>	"map_from": "gavailability"
Aturan Pemetaan Nilai	<string> : <string>	"InStock": "in stock"	Jumlah maksimum pemetaan dibatasi hingga 10 dan panjang string hingga 20.
Aturan Kapitalisasi Huruf	"type": one of : "capitalize_first", "capitalize_all", "to_upper", "to_lower"	"type": "capitalize_first"

Untuk detailnya, lihat Aturan Feed Data Produk API, Referensi.

Memperbaiki Kesalahan Unggahan Feed dengan Aturan

Perbaiki dan cegah adanya kesalahan unggahan feed data yang sedang berlangsung dengan aturan. Anda dapat memberikan aturan yang diterapkan oleh Meta untuk setiap unggahan feed data. Tentukan aturan Anda berdasarkan atribut (kolom) yang harus diterapkan, berdasarkan jenis aturan, dan berdasarkan parameter. Anda saat ini tidak dapat menggunakan aturan dengan Batch API. Anda dapat menyediakan jenis aturan ini:

Aturan Pemetaan - Memetakan atribut (nama kolom) dalam file feed data ke atribut yang bisa kita kenali.
Aturan Pemetaan Nilai - Memetakan kolom (nilai kolom) dalam file feed data ke kolom yang bisa kita kenali.
Aturan Kapitalisasi Huruf - Mengubah kapitalisasi huruf pada kata-kata dalam sebuah kolom. Misalnya, mengubah semua deskripsi dari huruf kapital menjadi huruf kecil.

Misalnya, Anda dapat memperbaiki masalah ini dengan Aturan Pemetaan dan Pemetaan Nilai:

Kesalahan tulisan atribut dari gavailability menjadi availability
Memperbaiki enum yang tidak dikenali InStock menjadi in stock
Format harga dari 45$ menjadi 45.00 USD
Menerjemahkan Kondisi: Neu menjadi Kondisi: New

Anda dapat menggunakan Aturan Kapitalisasi Huruf untuk menangani jenis isu ini:

Mengubah deskripsi yang menggunakan huruf kapital BRAND NEW WITH LEATHER DETAIL... menjadi Brand new with leather detail...
Memperbaiki judul yang menggunakan huruf kapital FACEBOOK T-SHIRT menjadi Facebook T-shirt

Memperbarui dan Menghapus Aturan

Untuk mengubah aturan yang terkait dengan feed data, buat panggilan HTTP POST untuk memperbarui setiap parameter dan HTTP DELETE untuk menghapusnya. Anda hanya dapat memperbarui parameter. Jika Anda ingin mengubah attribute atau rule_type, Anda harus menghapus dan membuat ulang aturan.

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

Untuk detailnya, lihat Aturan Feed Data Produk API, Referensi.

Memperbaiki Item yang Hilang di Katalog

Jika Commerce Manager melaporkan adanya beberapa item dalam katalog Anda yang hilang atau tidak dapat ditemukan, Anda mungkin harus memeriksa apakah Meta Pixel atau aplikasi Anda telah diatur dengan benar. Anda mungkin akan menemukan kesalahan ini saat:

content_id yang disertakan dalam pixel atau peristiwa aplikasi Anda tidak cocok dengan ID di feed data katalog.
Pixel atau aplikasi tidak terkait ke katalog.
Item tidak ada dalam katalog.

Pelajari selengkapnya di sini.

Pelajari selengkapnya tentang pemecahan masalah kabar Anda dengan Blueprint.

Meminta Laporan Kesalahan Unggahan Kabar Data

Iklan Katalog Advantage+

Anda dapat menggunakan Laporan Kesalahan Pengunggahan Feed Data API untuk meminta laporan kesalahan lengkap untuk setiap sesi pengunggahan feed. Setelah menerima permintaan, kami menjalankan pekerjaan latar belakang untuk menyiapkan kesalahan ini dan menyimpannya dalam file CSV.

Untuk meminta laporan kesalahan penuh, gunakan POST /{upload_session_id}/error_report.

Laporan ini berisi informasi tentang:

ID peritel dari item yang mengalami kesalahan
Pesan kesalahan
Severitas kesalahan (FATAL jika kesalahan menyebabkan item ditolak, WARNING jika produk diunggah, tetapi dengan kesalahan)
Nama kolom tempat kesalahan ditampilkan
Kemampuan yang sedang dipengaruhi oleh kesalahan ini; misalnya, kesalahan yang mempengaruhi iklan katalog Advantage+ yang berisi 'da' dalam kolom ini
Jika kesalahan memblokir kemampuan (true/false); contoh, jika kesalahan mencegah item ditampilkan pada platform ini

Permintaan

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

Tanggapan Tanggapan menunjukkan apakah permintaan berhasil atau tidak:

{
  "success": bool,
}

Perdagangan

Mendapatkan contoh kesalahan dan peringatan sering kali cukup untuk memperbaiki sebagian besar masalah unggahan feed produk. Namun, Anda mungkin perlu daftar lengkap kesalahan untuk melakukan analisis secara lebih mendalam. Untuk mengunduh daftar lengkap kesalahan dan peringatan, Anda harus terlebih dahulu meminta sesi unggahan terbaru (lihat bagian di atas).

Anda dapat meminta laporan kesalahan lengkap yang akan dibuat untuk ID sesi unggahan tertentu.

Permintaan

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

Tanggapan

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

Anda harus menemukan URL yang bisa Anda unduh (misalnya dengan wget, curl, dan sebagainya). File yang telah diunduh akan berisi laporan kesalahan lengkap.

Jika Anda mendapatkan kesalahan ini: "Tidak dapat mengakses objek yang tidak dikelola oleh bisnis yang memiliki aplikasi ini", pastikan bahwa aplikasi yang Anda gunakan merupakan milik bisnis ( Pengaturan Bisnis > Akun > Aplikasi).

Jika laporan tidak siap, ulangi panggilan terakhir setelah beberapa detik. Anda kemudian dapat mengunduh laporan itu sendiri.

Dapatkan Status Laporan Kesalahan

Setelah laporan diminta, gunakan GET /{upload_session_id}?fields=error_report untuk mendapatkan status laporan kesalahan.

Contoh

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

Tanggapan

{
  "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#)"
}

Kemungkinan Nilai - Status yang Dikembalikan

Nilai	Deskripsi
`NOT_REQUESTED`	Laporan kesalahan untuk unggahan feed data ini belum diminta.
`REQUESTED`	Permintaan diterima dan sedang diproses.
`CREATED`	Pembuatan laporan berhasil dan sedang menunggu untuk ditulis ke file CSV.
`WRITE_FINISHED`	File laporan sudah disiapkan dan siap untuk diunduh.
`SESSION_DATA_NOT_FOUND`	Tidak ada data yang ditemukan untuk sesi unggahan feed data ini, kemungkinan tidak ada item yang diproses untuk unggahan feed ini.
`ERROR_REPORT_OUTDATED`	Laporan kesalahan sudah lebih dari 30 hari dan tidak lagi tersedia.
`FATAL_ERROR`	Terjadi kesalahan di sistem kami saat mencoba menyiapkan laporan kesalahan ini. Anda dapat meminta laporan kesalahan untuk mencoba lagi.

Catatan: URL CDN yang menggunakan laporan kesalahan ini dapat diunduh dan akan dikembalikan sebagai "file_handle" saat status error_report adalah WRITE_FINISHED.

Mengelola Kesalahan Unggahan Feed Produk

Iklan Katalog Advantage+

Baca dokumentasi Kesalahan Unggahan Feed Produk. Lihat juga Menangani Kesalahan Unggahan Feed Produk, Platform Perdagangan.

Permintaan

Untuk mendapatkan kesalahan dan peringatan dari unggahan feed, Anda harus terlebih dahulu meminta sesi unggahan terbaru.

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

Selanjutnya, gunakan upload_session_id untuk mengambil kesalahan dan peringatan.

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

Contoh Tanggapan

Severitas fatal di sini berarti item tidak dapat diserap oleh Meta; severitas warning berarti beberapa atribut yang direkomendasikan hilang atau salah format.

{
  "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"
          }
        ]
      }
    }
  ]
}

Perdagangan

Baca dokumentasi Kesalahan Unggahan Feed Produk. Lihat juga cara mengelola Kesalahan Unggahan feed produk, Iklan Katalog Advantage+.

Sebaiknya Anda memeriksa kesalahan unggahan katalog dan peringatan setelah setiap sesi unggahan. Anda dapat mencapainya dengan membuka bagian Diagnostik di Commerce Manager Anda, atau gunakan Feed API untuk meminta contoh kesalahan dan peringatan. Mulailah dengan terlebih dahulu meng-kueri sesi unggahan terkini.

Pelajari selengkapnya tentang cara menyelesaikan peringatan dan kesalahan Diagnostik di Commerce Manager dengan Blueprint.

Permintaan

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

Contoh Tanggapan

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

Selanjutnya, gunakan nilai yang dikembalikan di kolom id untuk mengambil contoh kesalahan dan peringatan.

Permintaan

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

Contoh Tanggapan

Severitas fatal di sini berarti item tidak dapat diserap oleh Meta; severitas warning berarti beberapa atribut yang direkomendasikan hilang atau salah format.

{
  "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"
          }
        ]
      }
    }
  ]
}

Memecahkan Masalah Feed Data Anda

Lihat Aturan yang Disarankan

Terapkan Aturan ke Feed Data

Memperbaiki Kesalahan Unggahan Feed dengan Aturan

Memperbarui dan Menghapus Aturan

Memperbaiki Item yang Hilang di Katalog

Meminta Laporan Kesalahan Unggahan Kabar Data

Iklan Katalog Advantage+

Perdagangan

Dapatkan Status Laporan Kesalahan

Kemungkinan Nilai - Status yang Dikembalikan

Mengelola Kesalahan Unggahan Feed Produk

Iklan Katalog Advantage+

Permintaan

Contoh Tanggapan

Perdagangan

Permintaan

Contoh Tanggapan

Permintaan

Contoh Tanggapan

Pelajari Selengkapnya