Risoluzione dei problemi relativi all'elenco di dati

Usa queste soluzioni e linee guida per eventuali problemi con l'elenco di dati che potresti incontrare.

Visualizza le regole suggerite

Per elencare tutte le regole associate a un elenco di dati, effettua una chiamata HTTP GET a:

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

Per i dettagli, consulta API Product Data Feed Rules, riferimento.

Puoi ottenere le regole suggerite da Meta per risolvere gli errori nel tuo elenco di dati. Per vedere le regole suggerite per la tua sessione di caricamento, segui questi passaggi:

Passaggio 1: recupera le sessioni di caricamento:

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

Passaggio 2: recupera gli errori per la sessione di caricamento:

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

Passaggio 3: recupera le regole suggerite per l'errore di caricamento:

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

Esempio di risposta

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

Per i dettagli, consulta API Suggested Rules, riferimento.

Applicare le regole agli elenchi di dati

Per applicare le regole a un elenco di dati, devi associare la regola all'elenco di dati.

Fai una chiamata HTTP POST a:

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

Esempio

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" 

Esempio di risposta

"id": "{RULE_ID}"

Applica a params il formato indicato di seguito:

Per i dettagli, consulta API Product Data Feed Rules, riferimento.

Correggere gli errori di caricamento dell'elenco con le regole

Correggi e previeni gli errori di caricamento dell'elenco di dati continui grazie alle regole. Puoi fornire regole che Meta applica a ogni caricamento di elenco di dati. Specifica le tue regole in base all'attributo (colonna) a cui dovrebbero applicarsi, al tipo di regola e ai parametri. Attualmente non puoi usare regole con l'API Batch. Puoi fornire questi tipi di regole:

• Regola di mappatura: mappa gli attributi (nomi di colonne) in un file di elenco di dati ad attributi che possiamo riconoscere.
• Regola di mappatura del valore: mappa i campi (valori delle colonne) in un file di elenco di dati a campi che possiamo riconoscere.
• Regola maiuscole/minuscole: modifica le lettere delle parole in un campo in maiuscole/minuscole. Ad esempio, cambia tutte le descrizioni in maiuscolo mettendole in minuscolo.

Ad esempio, puoi correggere questi problemi con la Regola di mappatura e di mappatura del valore:

• Errori di battitura negli attributi da gavailability a availability
• Correzione di enum non riconosciuti da InStock a in stock
• Formato dei prezzi da 45$ a 45.00 USD
• Condizione della traduzione: Neu in Stato: New

Puoi usare la Regola maiuscole/minuscole per risolvere questo tipo di problemi:

• Modifica delle descrizioni in maiuscolo da BRAND NEW WITH LEATHER DETAIL... a Brand new with leather detail...
• Correzione dei titoli tutti in maiuscolo da FACEBOOK T-SHIRT a Facebook T-shirt

Aggiornare ed eliminare le regole

Per cambiare una regola associata a un elenco di dati, effettua una chiamata HTTP POST per aggiornare eventuali parametri e HTTP DELETE per eliminarla. Puoi solo aggiornare i parametri. Se vuoi cambiare attribute o rule_type, devi eliminare e ricreare la regola.

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

Per i dettagli, consulta l'API Product Data Feed Rule, riferimento.

Correggere gli articoli mancanti in un catalogo

Se Gestore delle vendite segnala che alcuni articoli del tuo catalogo sono mancanti o non si trovano, potresti dover controllare che il tuo pixel o la tua app di Meta siano stati configurati correttamente. Potresti incontrare questo errore quando:

• l'content_id incluso nel tuo pixel o nell'evento nell'app non corrisponde all'ID nell'elenco di dati del catalogo;
• il pixel o l'app non sono associati al catalogo;
• l'articolo non esiste nel catalogo.

Scopri di più qui.

Scopri di più sulla risoluzione dei problemi del tuo elenco con Blueprint.

Richiedere un report degli errori di caricamento di un elenco di dati

Inserzioni del catalogo Advantage+

Puoi usare l'API Data Feed Upload Error Report per richiedere un report completo degli errori per qualsiasi sessione di caricamento dell'elenco. Una volta ricevuta la richiesta, eseguiamo un processo in background per preparare gli errori e salvarli in un file CSV.

Per richiedere un report completo degli errori, usa POST /{upload_session_id}/error_report.

Il report contiene informazioni in merito agli elementi seguenti:

• ID del rivenditore dell'articolo che presentava un errore
• Messaggio di errore
• Gravità dell'errore (FATAL se l'errore ha causato il rifiuto dell'articolo, WARNING se l'articolo è stato caricato, ma con un errore)
• Nomi dei campi interessati dall'errore
• Funzionalità interessate dall'errore; ad esempio errori che interessano le inserzioni del catalogo Advantage+ contenenti 'da' all'interno di questa colonna
• Se l'errore blocca la funzionalità (true/false); ad esempio, se l'errore impedisce che l'articolo venga mostrato su questa piattaforma

Richiesta

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

Risposta La risposta indica se la richiesta è andata o meno a buon fine:

{
  "success": bool,
}

Commerce

Ottenere un campione di errori e avvisi è spesso sufficiente per risolvere la maggior parte dei problemi di caricamento dell'elenco prodotti. Tuttavia, potresti aver bisogno della lista completa degli errori per effettuare analisi più approfondite. Per scaricare una lista completa di errori e avvisi, devi prima interrogare la sessione di caricamento più recente (vedi sezione sopra).

Puoi richiedere che venga generato il report completo degli errori per un determinato ID di sessione di caricamento.

Richiesta

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

Risposta

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

Dovresti trovare un URL che puoi scaricare (ad esempio, con wget, curl e così via). Il file scaricato conterrà il report completo degli errori.

Se ricevi questo errore: "Cannot access an object not managed by the business owning this app" (Impossibile accedere a un oggetto non gestito dal Business Manager proprietario di questa app", assicurati che l'app che stai usando appartenga al Business Manager (Impostazioni business > Account > App).

Nel caso in cui il report non sia pronto, ripeti l'ultima chiamata dopo pochi secondi. A questo punto puoi scaricare il report.

Ottenere lo stato del report degli errori

Dopo aver richiesto un report, usa GET /{upload_session_id}?fields=error_report per ottenere lo stato del report degli errori.

Esempio

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

Risposta

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

Valori possibili - Stato restituito

Nota: un URL CDN che utilizza questo report degli errori può essere scaricato e verrà restituito come "file_handle" quando lo stato dell'error_report è WRITE_FINISHED.

Gestire gli errori di caricamento dell'elenco prodotti

Inserzioni del catalogo Advantage+

Leggi la documentazione relativa agli errori di caricamento dell'elenco prodotti. Consulta anche Gestione degli errori di caricamento dell'elenco prodotti, piattaforma di vendita .

Richiesta

Per ricevere errori e avvisi dal caricamento di un elenco, devi prima interrogare le sessioni di caricamento recenti.

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

Usa quindi upload_session_id per recuperare errori e avvisi.

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

Esempio di risposta

Una gravità fatal qui indica che l'articolo non può essere acquisito da Meta; una gravità warning indica che alcuni attributi consigliati sono mancanti o hanno un formato non corretto.

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

Commerce

Leggi la documentazione relativa agli errori di caricamento dell'elenco prodotti. Consulta anche come gestire gli errori di caricamento dell'elenco prodotti, inserzioni del catalogo Advantage+.

Ti consigliamo di controllare gli errori e gli avvisi di caricamento del catalogo dopo ogni sessione di caricamento. Per farlo, vai alla sezione Diagnostica del Gestore delle vendite, oppure usa l'API Feed per richiedere un campione di errori e avvisi. Inizia chiedendo prima le sessioni di caricamento recenti.

Scopri di più su come risolvere avvisi ed errori di diagnostica in Gestore delle vendite con Blueprint.

Richiesta

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

Esempio di risposta

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

Quindi, usa il valore restituito nel campo id per recuperare un campione di errori e avvisi.

Richiesta

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

Esempio di risposta

Una gravità fatal qui indica che l'articolo non può essere acquisito da Meta; una gravità warning indica che alcuni attributi consigliati sono mancanti o hanno un formato non corretto.

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

Per saperne di più

• Risoluzione dei problemi relativi agli elenchi di dati, Centro assistenza per le inserzioni
• Qualità del catalogo e dei segnali
• Campi dell'elenco di dati e specifiche per i cataloghi, Centro assistenza per le inserzioni
• Qualità del catalogo e dei segnali
• API Catalog Batch, inserzioni del catalogo Advantage+
• API Catalog Batch, vendite
• Elenco di dati, riferimento
• Elenchi di dati nel catalogo, riferimento
• API Feed, riferimento
• Recupero programmato dell'elenco di dati, riferimento
• Regole del filtro, riferimento
• Batch catalogo prodotti, riferimento
• Batch articoli catalogo prodotti, riferimento
• Stato richiesta batch controllo catalogo prodotti, riferimento
• Programmazione dell'elenco prodotti, riferimento
• Caricamento dell'elenco prodotti, riferimento
• Prodotto, riferimento
• Ricerca prodotti nel catalogo, riferimento
• Formazione in diretta sul catalogo, Blueprint