Se actualizó este documento.
La traducción en español no está disponible todavía.

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

Solucionar problemas de tu lista de datos

Utiliza estas soluciones y normas en relación con cualquier problema en las listas de datos que puedas encontrar.

Ver reglas sugeridas

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

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

Para obtener detalles, consulta API de reglas de listas de datos de productos, Referencia.

Puedes obtener reglas sugeridas de Meta para corregir errores en tu lista de datos. Para ver las reglas sugeridas en relación con tu sesión de subida, sigue los pasos que se indican a continuación:

Paso 1: Recopilar sesiones de subida:

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

Paso 2: Recopilar errores de la sesión de subida:

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

Paso 3: Recopilar reglas sugeridas de errores 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 detalles, consulta API de reglas sugeridas, Referencia.

Aplicar regulaciones a listas de datos

Para aplicar reglas a una lista de datos, debes asociar la regla a dicha lista.

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

El formato de params debe ser el siguiente:

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 está limitado a 10, y longitud de cadenas, a 20.
Regla de mayúsculas y minúsculas	"type": uno de : "capitalize_first", "capitalize_all", "to_upper", "to_lower"	"type": "capitalize_first"

Para obtener detalles, consulta API de reglas de listas de datos de productos, Referencia.

Solucionar errores de subida de listas con reglas

Solucionar y prevenir errores de subida de listas de datos en curso con reglas. Puedes proporcionar reglas que Meta aplique a cada subida de listas de datos. Establece las reglas según el atributo (columna) al que se deben aplicar, por el tipo de regla y por parámetros. Actualmente no puedes utilizar reglas con la API de lote. 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 columna) en un archivo de lista de datos a campos que podemos reconocer.
Regla de mayúsculas y minúsculas: cambia las mayúsculas y minúsculas de las palabras en 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 de valores:

Errores ortográficos en las contraseñas de gavailability a availability
Solucionar enumeraciones no reconocidos de InStock a in stock
Precio de formato de 45$ a 45.00 USD
Condición de traducción: Neu en la condición: New

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

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

Actualizar y eliminar reglas

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

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

Para obtener detalles, consulta API de reglas de listas de datos de productos, Referencia.

Corregir catálogos en los que faltan artículos

Si el administrador de ventas indica que faltan o no se encuentran artículos en tu catálogo, es posible que tengas que comprobar si el píxel de Meta o la app se configuraron correctamente. Puede que este error suceda en los siguientes casos:

El content_id incluido en tu píxel o evento de la app no coincide con el identificador de la lista de datos del catálogo.
El píxel o la app no está asociado 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 resolución de problemas de tu lista con Blueprint.

Solicitar un informe de error de subida de lista de datos

Anuncios del catálogo Advantage+

Puedes utilizar la API de informe de errores de subida de listas de Datos para solicitar un informe de errores completo relativo a cualquier sesión de subida de listas. Una vez que recibimos la solicitud, ejecutaremos una tarea de fondo para preparar estos errores y almacenarlos en un archivo CSV.

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

El informe contiene información sobre los siguientes elementos:

Identificador de comercio minorista del artículo que presentó un error
Mensaje de error
Gravedad del error (FATAL si el error causó que se rechace el artículo; WARNING si el artículo se cargó, pero con un error)
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 Advantage+ que contienen 'da' dentro de esta columna
Si el error bloquea la capacidad (true/false). Por ejemplo, si el error impide que el elemento 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 los errores y las advertencias suele ser suficiente para solucionar la mayoría de los problemas de subida de las listas de productos. Sin embargo, puede que sea necesario contar con la lista completa de errores para hacer un análisis más profundo. Para descargar una lista completa de los errores y las advertencias, primero debes realizar una consulta a la sesión de subida más reciente (consulta la sección superior).

Puedes solicitar el informe de error completo relacionado con el identificador de una sesión de subida determinada.

Solicitud

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

Respuesta

{
  "success": true
}

Si el informe no está listo, repite la última llamada después de unos segundos. Puedes descargar el propio 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"
}

Puedes encontrar una URL que puedas descargar (por ejemplo, con wget, curl, etc.). El archivo descargado contendrá el informe de error completo.

Si obtienes este error: "No se puedes acceder a un objeto no administrado por el negocio al que pertenezca esta app", asegúrate de que la app que usas sea propiedad del negocio (Configuración del negocio > Cuenta > Apps).

Obtén el estado del informe de error

Una vez que se solicitó un informe, usa GET /{upload_session_id}?fields=error_report para obtener el estado del informe de error.

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

Valores posibles y estado devuelto

Valor	Descripción
`NOT_REQUESTED`	No se solicitó el informe de error en relación con esta subida de listas de datos.
`REQUESTED`	Se recibió La solicitud y se encuentra en proceso.
`CREATED`	El informe se creó correctamente y en breve se guardará en un archivo CSV.
`WRITE_FINISHED`	Se preparó el archivo del informe y está listo para descargar.
`SESSION_DATA_NOT_FOUND`	No se encontraron datos relativos a esta sesión de subida de listas datos. Es probable que no se hayan procesaron elementos para esta subida de listas de datos.
`ERROR_REPORT_OUTDATED`	El informe de error es mayor a 30 días y ya no está disponible.
`FATAL_ERROR`	Algo salió mal de nuestro lado mientras intentábamos preparar este informe de error. Puedes volver a intentar solicitar un informe de error.

Nota: Se pudo descargar una URL de la CDN que utiliza este informe de error y se devolverá como "file_handle" cuando el estado del error_report sea WRITE_FINISHED.

Administrar errores de subida de listas de productos

Anuncios del catálogo Advantage+

Lee la documentación de errores de subida de listas de productos. Consulta también Manejo de 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 carga recientes.

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

Luego, 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 que se muestra aquí significa que Meta no incorporó el artículo; warning, que faltan algunos atributos recomendados o que presentan 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

Lee la documentación de errores de subida de listas de productos. Consulta también cómo administrar errores de subida de las listas de productos, Anuncios de catálogo Advantage+.

Recomendamos que verifiques los errores y las advertencias de subida de catálogo después de cada sesión de carga. Puedes hacerlo si vas a la sección de Diagnósticos de tu administrador de ventas, o bien si utilizas la API de listas para solicitar una muestra de errores y advertencias. Comienza realizando una consulta de las sesiones de subidas recientes.

Obtén más información sobre la resolución de advertencias y errores de diagnóstico en el administrador de ventas 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"
    }
  ]
}

Luego, utiliza el valor devuelto en el campo id para obtener una muestra de errores y advertencias.

Solicitud

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

Ejemplo de respuesta

La gravedad fatal que se muestra aquí significa que Meta no incorporó el artículo; warning, que faltan algunos atributos recomendados o que presentan 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 tu lista de datos

Ver reglas sugeridas

Aplicar regulaciones a listas de datos

Solucionar errores de subida de listas con reglas

Actualizar y eliminar reglas

Corregir catálogos en los que faltan artículos

Solicitar un informe de error de subida de lista de datos

Anuncios del catálogo Advantage+

Comercio

Obtén el estado del informe de error

Valores posibles y estado devuelto

Administrar errores de subida de listas de productos

Anuncios del catálogo Advantage+

Solicitud

Ejemplo de respuesta

Comercio

Solicitud

Ejemplo de respuesta

Solicitud

Ejemplo de respuesta

Más información