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:

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, ubah 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 memecahkan masalah feed Anda dengan Blueprint.

Meminta Laporan Kesalahan Unggahan Feed 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

POST https://graph.facebook.com/vX.X/{upload-session-id}/error_report

Tanggapan

{
  "success": true
}

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

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).

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

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 membuat kueri pertama untuk sesi unggahan terbaru.

Pelajari selengkapnya tentang 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"
          }
        ]
      }
    }
  ]
}

Pelajari Selengkapnya

• Memecahkan Masalah Feed Data, Pusat Bantuan Iklan
• Katalog dan Kualitas Sinyal
• Kolom Feed Data dan Spesifikasi untuk Katalog, Pusat Bantuan Iklan
• Katalog dan Kualitas Sinyal
• Batch Katalog API, Iklan Katalog Advantage+
• Batch Katalog API, perdagangan
• Feed Data, Referensi
• Feed Data dalam Katalog, Referensi
• Feed API, Referensi
• Pengambilan Data Feed yang Terjadwal, Referensi
• Aturan Pemfilteran, Referensi
• Batch Katalog Produk, Referensi
• Batch Item Katalog Produk, Referensi
• Pemeriksaan Status Permintaan Batch Katalog Produk, Referensi
• Jadwal Feed Produk, Referensi
• Unggahan Feed Produk, Referensi
• Item Produk, Referensi
• Pencarian Produk dalam Katalog, Referensi
• Pelatihan Siaran Langsung pada Katalog, Blueprint