Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 5 mar.

Solucionar problemas de la lista de datos

Utiliza estas soluciones y normas para cualquier problema que puedas encontrar con la lista de datos.

Ver reglas sugeridas

Para enumerar todas las reglas asociadas a una lista de datos, realiza una llamada HTTP GET a:

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

Para obtener más información, consulta API de reglas de listas de datos de productos, Referencia.

Puedes obtener las reglas sugeridas de Meta para solucionar errores en tu lista de datos. Si quieres ver las reglas sugeridas para tu sesión de subida, sigue estos pasos:

Paso 1. Recuperar sesiones de subida:

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

Paso 2. Recuperar errores de la sesión de subida:

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

Paso 3 Recuperar reglas sugeridas para un error de subida:

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

Ejemplo de respuesta

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

Para obtener más información, consulta API de reglas sugeridas, Referencia.

Aplicar reglas a listas de datos

Para aplicar reglas a una lista de datos, tienes que asociar la regla a la lista de datos.

Realiza una llamada HTTP POST a:

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

Ejemplo

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"

Ejemplo de respuesta

"id": "{RULE_ID}"

Aplica formato a params de la siguiente manera:

Tipo de regla	Formato	Ejemplo	Notas
Regla de asignación	"map_from": <string>	"map_from": "gavailability"
Regla de asignación de valores	<string> : <string>	"InStock": "in stock"	El número máximo de asignaciones se limita a diez y la longitud de las cadenas, a 20.
Regla de mayúsculas y minúsculas	"type": one of : "capitalize_first", "capitalize_all", "to_upper", "to_lower"	"type": "capitalize_first"

Para obtener más información, consulta API de reglas de listas de datos de productos, Referencia.

Solucionar errores de subida de listas con reglas

Soluciona y evita los errores continuos de subida de listas de datos con reglas. Puedes proporcionar reglas que Meta aplique a cada subida de listas de datos. Especifica las reglas según el atributo (columna) en el que deben aplicarse, según el tipo de regla y según los parámetros. Actualmente no puedes utilizar reglas con la API de lotes. Puedes proporcionar estos tipos de reglas:

Regla de asignación: asigna atributos (nombres de columnas) en un archivo de lista de datos a atributos que podemos reconocer.
Regla de asignación de valores: asigna campos (valores de columnas) en un archivo de lista de datos a campos que podemos reconocer.
Regla de mayúsculas y minúsculas: cambia el uso de mayúsculas o minúsculas de las palabras de un campo. Por ejemplo, cambia todas las descripciones en mayúsculas a minúsculas.

Por ejemplo, puedes solucionar estos problemas con la regla de asignación y la regla de asignación de valores:

Faltas de ortografía de atributos (de gavailability a availability).
Solucionar enumeraciones no reconocidas (de InStock a in stock).
Formato de precio (de 45$ a 45.00 USD).
Traducción de la condición Neu en la condición New.

Puedes utilizar la regla de mayúsculas y minúsculas para abordar estos tipos de problemas:

Cambiar las descripciones en mayúsculas (de BRAND NEW WITH LEATHER DETAIL... a Brand new with leather detail...).
Corregir los títulos en mayúsculas (de FACEBOOK T-SHIRT a Facebook T-shirt).

Actualizar y eliminar reglas

Para cambiar una regla asociada a una lista de datos, realiza una llamada HTTP POST para actualizar los parámetros y HTTP DELETE para eliminarlos. Solo puedes actualizar los parámetros. Si quieres cambiar attribute o rule_type, debes eliminar la regla y volver a crearla.

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

Para obtener más información, consulta API de reglas de listas de datos de productos, Referencia.

Solucionar artículos que faltan en un catálogo

Si Commerce Manager notifica que algunos artículos faltan en el catálogo o que no se pueden encontrar, es posible que debas comprobar que el píxel de Meta o la aplicación estén configurados correctamente. Puedes encontrar este error cuando:

El valor de content_id incluido en el evento del píxel o la aplicación no coincide con el identificador en la lista de datos del catálogo.
El píxel o la aplicación no están asociados al catálogo.
El artículo no existe en el catálogo.

Obtén más información aquí.

Obtén más información sobre la solución de problemas de la lista con Blueprint.

Solicitar un informe de errores de subida de listas de datos

Anuncios de catálogo de Advantage+

Puedes utilizar la API de informes de errores de subida de listas de datos para solicitar un informe de errores completo de cualquier sesión de subida de listas. Cuando recibimos la solicitud, ejecutamos un trabajo en segundo plano para preparar estos errores y almacenarlos en un archivo CSV.

Para solicitar un informe de errores completo, usa POST /{upload_session_id}/error_report.

El informe contiene información sobre:

El identificador de minorista del artículo en el que se produjo un error.
El mensaje de error.
La gravedad del error (FATAL si el error provocó el rechazo del artículo o WARNING si el artículo se subió, pero con un error).
Los nombres de los campos en los que se produjo este error.
Las capacidades que se ven afectadas por este error; por ejemplo, errores que afectan a los anuncios de catálogo de Advantage+ que contienen 'da' en esta columna.
Si el error bloquea la capacidad (true o false); por ejemplo, si el error impide que el artículo se muestre en esta superficie.

Solicitud

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

Respuesta. La respuesta indica si la solicitud se realizó correctamente o no:

{
  "success": bool,
}

Comercio

Obtener una muestra de errores y advertencias suele ser suficiente para solucionar la mayoría de los problemas de subida de listas de productos. Sin embargo, puede que necesites la lista completa de errores para realizar un análisis más exhaustivo. Para descargar una lista completa de errores y advertencias, primero debes consultar la sesión de subida más reciente (consulta la sección anterior).

Puedes solicitar la generación del informe de errores completo para un identificador de sesión de subida determinado.

Solicitud

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

Respuesta

{
  "success": true
}

En caso de que el informe no esté listo, repite la última llamada tras unos segundos. A continuación, podrás descargar el informe.

Solicitud

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

Respuesta

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

Deberías ver una URL que puedes descargar (por ejemplo, con wget, curl, etc.). El archivo descargado contendrá el informe de errores completo.

Si recibes un error que indica que no se puede acceder a un objeto que no administre la empresa propietaria de esa aplicación, asegúrate de que la aplicación que estés utilizando pertenezca a la empresa (Configuración de la empresa > Cuenta > Aplicaciones).

Obtener el estado del informe de errores

Una vez solicitado un informe, usa GET /{upload_session_id}?fields=error_report para obtener el estado del informe de errores.

Ejemplo

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

Respuesta

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

Posibles valores: Estado devuelto

Valor	Descripción
`NOT_REQUESTED`	El informe de errores de esta subida de listas de datos no se ha solicitado.
`REQUESTED`	La solicitud se ha recibido y se está procesando.
`CREATED`	El informe se creó correctamente y está esperando para escribirse en un archivo CSV.
`WRITE_FINISHED`	El archivo del informe se ha preparado y está listo para descargarse.
`SESSION_DATA_NOT_FOUND`	No se encontraron datos para esta sesión de subida de listas de datos; es probable que no hubiese artículos procesados para esta subida de listas.
`ERROR_REPORT_OUTDATED`	El informe de errores tiene más de 30 días y ya no está disponible.
`FATAL_ERROR`	Se produjo un problema en nuestro sistema mientras intentábamos preparar este informe de errores. Puedes solicitar un informe de errores para volver a intentarlo.

Nota: Una URL de CDN que utilice este informe de errores se puede descargar y se devolverá como “file_handle” cuando el estado de error_report sea WRITE_FINISHED.

Administrar errores de subida de listas de productos

Anuncios de catálogo de Advantage+

Consulta la documentación de errores de subida de listas de productos. Consulta también Gestionar errores de subida de listas de productos, Plataforma de comercio.

Solicitud

Para obtener los errores y las advertencias de una subida de listas, primero debes consultar las sesiones de subida recientes.

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

A continuación, usa upload_session_id para recuperar los errores y las advertencias.

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

Ejemplo de respuesta

La gravedad fatal aquí significa que Meta no pudo ingerir el artículo y la gravedad warning significa que algunos atributos recomendados faltan o tienen un formato incorrecto.

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

Comercio

Consulta la documentación de errores de subida de listas de productos. Consulta también información sobre cómo gestionar errores de subida de listas de productos, Anuncios de catálogo de Advantage+.

Te recomendamos que compruebes los errores y las advertencias de subida de catálogo después de cada sesión de subida. Para ello, accede a la sección Diagnóstico de la cuenta de Commerce Manager o utiliza la API de listas para solicitar una muestra de los errores y las advertencias. Para empezar, consulta las sesiones de subida recientes.

Obtén más información sobre cómo resolver los errores y las advertencias de diagnóstico en Commerce Manager con Blueprint.

Solicitud

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

Ejemplo de respuesta

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

A continuación, utiliza el valor devuelto en el campo id para obtener una muestra de los errores y las advertencias.

Solicitud

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

Ejemplo de respuesta

La gravedad fatal aquí significa que Meta no pudo ingerir el artículo y la gravedad warning significa que algunos atributos recomendados faltan o tienen un formato incorrecto.

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

Solucionar problemas de la lista de datos

Ver reglas sugeridas

Aplicar reglas a listas de datos

Solucionar errores de subida de listas con reglas

Actualizar y eliminar reglas

Solucionar artículos que faltan en un catálogo

Solicitar un informe de errores de subida de listas de datos

Anuncios de catálogo de Advantage+

Comercio

Obtener el estado del informe de errores

Posibles valores: Estado devuelto

Administrar errores de subida de listas de productos

Anuncios de catálogo de Advantage+

Solicitud

Ejemplo de respuesta

Comercio

Solicitud

Ejemplo de respuesta

Solicitud

Ejemplo de respuesta

Más información