Códigos de error

A continuación, se enumeran los códigos de error que devuelve la API:

Código de error Descripción

-

Negative-value error codes are internal Facebook errors. Check error_subcode for the actual failure code.

1

An unknown error occurred

1, subcódigo 99

Se produjo un error desconocido. Se puede producir si se establece el valor de level en adset, cuando el valor correcto debería ser campaign.

4

Application request limit reached

10

Application does not have permission for this action

17

User request limit reached

100

Invalid parameter

100, subcódigo 33

Unsupported post request.

Este error puede producirse si tu identificador de acceso no se añade como un usuario del sistema con permisos adecuados a la cuenta publicitaria que posee una audiencia personalizada. Verifica la cuenta publicitaria en Business Manager y comprueba que todos los usuarios del sistema aparecen en ella con el rol Admin:


  • Haz clic en Business Settings.
  • Haz clic en la cuenta publicitaria.
  • Selecciona Add people.
  • Busca el usuario del sistema y agrégalo como administrador.
  • Reintenta la llamada a la API.

100, subcódigo 1487694

Invalid parameter.

La categoría que has seleccionado ya no está disponible. Se han retirado varias categorías de segmentación basadas en comportamiento. Si intentas usarlas para crear anuncios, la solicitud devolverá este error. Utiliza la búsqueda de segmentación para ver las categorías disponibles para la segmentación.

100, subcódigo 1752129

Invalid parameter.

Esta combinación de tareas no se admite. Para asignar funciones válidas de esta cuenta publicitaria a un usuario, debes pasar una combinación de tareas definida en la asignación. Consulta API de Business Manager, Roles permitidos.

102

Session key invalid or no longer valid

104

Incorrect signature

190

Invalid OAuth 2.0 Access Token

200

Permission error

200, subcódigo 1870034

Condiciones de las audiencias personalizadas no aceptadas: deberás aceptar las condiciones de las audiencias personalizadas para poder crear o editar una audiencia o un conjunto de anuncios. Consulta Facebook, Condiciones de las audiencias personalizadas.

200, subcódigo 1870047

Audience Size too Low: You cannot remove users from this audience because it will result in a low audience size and may result in under-delivery or non-delivery of your ads.

294

Managing advertisements requires the extended permission `ads_management` and an application that is in our allow list to access the Marketing API

2606

Unable to display a preview of this ad

2607

The given currency is invalid for usage with ads.

2615

Invalid call to update this adaccount

2654

Failed to create custom audience.

2654, subcódigo 1713092

No write permission for this ad account. Developer making this call must have permissions for the ad account to create an audience for it.

5000

Unknown Error Code

1349118

La opción de configuración “Seguridad de URL en conjuntos de publicaciones” de la aplicación no admite una o varias de las URL especificadas. Debe coincidir con la URL del sitio web o la URL de Canvas, o bien el dominio debe ser un subdominio de uno de los dominios de la aplicación. Obtén más información sobre la seguridad del inicio de sesión para conocer más detalles sobre la configuración de la aplicación en relación con la seguridad.

1359036

Ad Create Failed - Too Many Ads: The account {account_id} has reached the maximum number of ads {max}

1359102

Invalid Parameter In Spec: Parameter has invalid value or missing required parameter: {param-value}

1487006

Invalid Campaign ID: You must specify a campaign, and the campaign specified must belong to the account specified and must not be deleted.

1487007

Campaign Ended: You can't edit ads in a campaign that has ended. Please create a new ad within this campaign, update the campaign end time, pick another campaign, or create a new campaign.

1487010

Ad Bid Too High: Your bid is above the maximum for its type and placement. Please try again with a value below the maximum if you would like to raise your bid.

1487013

Bid Too Low: Your bid is below the minimum for its placement and type. If you don't want your ad to run at the minimum bid rate, please pause it. Otherwise, please increase the bid to be within the suggested range.

1487014

Campaign budget was too low. Please increase the daily budget to at least 2 times the amount of the highest CPC ad bid, which is at least {minimum_budget}. You bid {bid}.

1487015

The ad creative is invalid

1487065

Ad Missing Targeting Spec: Ad spec needs a targeting spec. Please use targeting field to specify what audience the ad should be shown to. Field 'countries' is required; all others are optional.

1487087

Ad Create Failed: The Ad Create Failed for the following reason: {reason}

1487089

Target Spec Invalid: The target spec is invalid: {reason}

1487090

Ad Edit Failed - Spec Errors: {error}

1487108

Invalid Cities: Please check that the format in which you are specify the cities is correct, and if you specify IDs, that they are of the correct type. This can not be the the ID of the page for the city; city ids are returned by, `/search?type=adcity`.

1487124

Invalid Connection: You can only specify connections to objects you are an administrator or developer of.

1487133

Invalid Negative Connections: If you specify negative targeting, you must be the administrator or developer of the objects whose fans you want to specify to exclude. You are not an admin of the following specified connections: {connections}

1487172

Could not save creative

1487174

Invalid Image Hash: Invalid Image Hash - {hash}

1487194

Permission Error: Either the object you are trying to access is not visible to you or the action you are trying to take is restricted to certain account types.

1487199

Ad targeting does not match targeting of the story: The targeting specified for this ad is not compatible with the story being boosted. Check the privacy and language/country targeting of the story you are trying to sponsor.

1487202

Invalid object - not admin or object not public: The user is not an admin of the object or the object is not publicly accessible.

1487211

Invalid URL For Creative Destination: Creative must have a valid destination URL, and if attached object is page, destination must match page.

1487225

Ad Creation Limited By Daily Spend: The number of ads you can create in a given period of time has a limit determined by your daily spend level. Higher spend levels allow creation of more ads. Increase your daily spend limit or create fewer ads per time period.

1487244

Campaign Update Failed: Campaign {campaign_id}: {reason}

1487246

Campaign Creation Failed: {reason}

1487256

Targeting declined due to policy: Invalid ads targeting. The targeting spec was declined due to policy restrictions.

1487283

Not Allowed To Use View Tags: Only some partners are allowed to use view tags. Please verify that you are using an approved account.

1487301

Custom Audience Unavailable: The custom audience you're trying to use hasn't been shared with your ad account. Please create or choose a different custom audience, or ask the owner of the custom audience to let you use it.

1487346

The post does not belong to the specified Page: Post to be promoted does not belong to the Page specified. The post belongs to {otherDestination}; try using this as the destination or using a post that belongs to the specified Page. Specified Page: {destination}.

1487366

Custom Audience Has Been Deleted: Cannot use deleted custom audience. Please choose another audience.

1487376

Conversion Spec Needed: For ads pointing to an offsite location with a non-zero bid on actions, you must specify the conversion spec.

1487380

Invalid aggregation day for conversion data. The aggregation day must be larger than or equal to 1.

1487390

Adcreative Create Failed: The Adcreative Create Failed for the following reason: {reason}

1487391

Cannot Use Syndicated Audiences From Multiple Partners: When specifying partner-created custom audiences for an ad, all audiences must be from the same provider.

1487396

Failed to update the creative: Failed to update creative {id}. Failed for the following reason: {reason}

1487424

Ad Needs Exclusion Targeting: This ad cannot be created with the targeting spec you selected. Your ad has a conversion objective that users can only do once, so you must target the ad at those users who have not already converted. If you are using the Facebook API, consider including the following string in your targeting spec: {exclusion-targeting-spec}.

1487465

Invalid CPA Bid: The action type you selected is not allowed for Cost-Per-Action (CPA) bidding: '{action_type}'. Please change your optimization goal or switch your bid type to regular Optimized CPM.

1487472

This type of page post is not eligible to be promoted. {debug_info}

1487477

Conversion Tracking Pixel Permission Error: The conversion tracking pixel you're trying to use is owned by another user and hasn't been shared with you. Please use a tracking pixel that's been shared with you or create a new one.

1487485

Too many async requests

1487506

The new budget value is too low: The new budget value of {new_budget} is too low. The minimum acceptable is {minimum_budget}.

1487557

No supported fields were provided for updating the campaign

1487558

No supported fields were provided for updating the ad

1487559

Ad Update Failed {reason}

1487573

You must specify an object_id for this adcreative type (creative type 27)

1487742

There have been too many calls from this ad-account. Wait a bit and try again.

1487756

You have overlapping locations specified in the geo_locations field. Your broader option will override the narrower option, please remove one to proceed.

1487790

The promoted object is invalid: it could have been deleted or never existed.

1487881

The given prediction id in a reach and frequency campaign is not reserved.

1487882

The given reservation in a reach and frequency campaign is not finalized yet.

1487884

The given reservation in a reach and frequency campaign is already finalized

1487885

The prediction in a reach and frequency campaign is already reserved.

1487886

This indicates the operation fails for an unknown reason.

1487887

The given page types are not supported by the inventory manager.

1487915

A finalized prediction order can not be cancelled. You can create a new prediction or delete the campaign.

1634013

Conversion Spec Targets Invalid ID: You are targeting an ID in your conversion spec without admin permissions on that object. {debug_info}

1667002

This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.

1667002

This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.

1815826

Tu estrategia de puja no es válida. Las estrategias de puja disponibles actualmente son LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP y TARGET_COST. Elige una estrategia de puja válida para tus objetivos de negocio. En vigor a partir de la versión 3.0.

1815829

Estás intentando establecer una estrategia de puja en un conjunto de anuncios de una campaña publicitaria que tiene habilitada la optimización del presupuesto de la campaña. No se permite establecer la estrategia de puja en un conjunto de anuncios de este tipo. Elimina la estrategia de puja del conjunto de anuncios o deshabilita la optimización del presupuesto en tu campaña. En vigor a partir de la versión 3.0.

1815830

Estás intentando establecer una estrategia de puja en un conjunto de anuncios de una campaña publicitaria que no usa el tipo de compra “Subasta”. No se permite establecer la estrategia de puja en un conjunto de anuncios de este tipo. En vigor a partir de la versión 3.0.

1815857

Importe de la puja necesario: debes proporcionar un límite de puja o coste objetivo en el campo “bid_amount”. Para LOWEST_COST_WITH_BID_CAP, debes proporcionar el campo “bid_amount” para establecer un límite de puja. Para TARGET_COST, debes proporcionar el campo “bid_amount” para establecer un objetivo de coste medio. En vigor a partir de la versión 3.0.

1815858

No puedes establecer un límite de puja en los conjuntos de anuncios con la estrategia de puja LOWEST_COST_WITHOUT_CAP. Elimina el campo “bid_amount” o modifícalo para utilizar LOWEST_COST_WITH_BID_CAP con este. En vigor a partir de la versión 3.0.

1815067

El objetivo de optimización no está disponible: no puedes utilizar el objetivo de optimización seleccionado para tu objetivo de la campaña. Selecciona un objetivo diferente y edita la campaña.

1798130

No se permite crear conjuntos de productos vacíos para los anuncios de catálogo de Advantage+. Añade productos al catálogo y crea un conjunto que contenga, como mínimo, un producto.

2310025

No se puede crear la campaña mediante esta cuenta publicitaria. Para crear campañas de anuncios colaborativos, los anunciantes de marca deben utilizar una cuenta publicitaria diferente para cada vendedor con el que se asocian. Asegúrate de utilizar una cuenta publicitaria diferente asociada con el vendedor al que pertenece este segmento de catálogo. Sujeto a disponibilidad limitada.

2310039

No se puede crear la campaña mediante este segmento de catálogo. No puedes usar esta cuenta publicitaria para poner en circulación anuncios de este segmento de catálogo. La empresa creó este segmento de catálogo para que el anunciante de una marca lo use en anuncios colaborativos. Elige una cuenta publicitaria distinta o bien usa esta cuenta publicitaria para poner en circulación campañas mediante un catálogo de productos. Sujeto a disponibilidad limitada.

3260011

No puedes editar el píxel, el evento de conversión, la conversión personalizada ni la optimización de un conjunto de anuncios una vez que este se ha publicado. Para poner en circulación un conjunto de anuncios con los cambios deseados, crea un nuevo conjunto de anuncios.

3858064

Esta campaña contiene opciones que ya no se pueden usar en campañas con audiencias menores de 18 años en todo el mundo, 20 en Tailandia o 21 en Indonesia. Aumenta la edad mínima de la audiencia o elimina todas las opciones de segmentación excepto para la edad y los lugares que sean ciudades o más grandes (salvo el código postal y la Designated Marketing Area).

3858065

Esta campaña contiene opciones que ya no se pueden usar en campañas con audiencias menores de 18 años en todo el mundo, 20 en Tailandia o 21 en Indonesia. Aumenta la edad mínima de la audiencia o elimina la opción siguiente: Ubicaciones no disponibles.

La gestión de errores debe realizarse únicamente mediante los códigos de error. La cadena de descripción puede cambiar en cualquier momento sin previo aviso.

blame_field_specs

Esta es una propiedad incluida en el blob error_data de cualquier llamada a la API que provoca un error de validación, que indica los campos responsables del error de validación. Se puede usar para proporcionar errores contextuales; por ejemplo, para mostrar un error justo al lado de los campos que lo provocan en la GUI de una herramienta de creación de anuncios.

blame_field_specs es una matriz, donde cada elemento de la matriz es un elemento blame_field_spec, que indica un campo único de la especificación de la API que provoca el error.

Un elemento blame_field_spec también es una matriz, que indica el nombre del campo que provoca el error y la ubicación de este campo en la especificación de la API general proporcionada.

Ejemplos:

Error en un único campo

{  
  "error":{  
    "type":"Exception",
    "message":"The budget for your Ad-Set is too low.  It must be at least $1.00 per day.",
    "code":1487901,
    "is_transient":false,
    "error_data":{  
      "blame_field_specs":[  
        ["daily_budget"]
      ]
    }
  }
}

Indica que el campo daily_budget de la especificación de la API provoca un error; en este caso, el presupuesto era demasiado bajo.

Error en varios campos

"blame_field_specs":[  
  ["targeting_spec", "interested_in"], 
  ["bid_info", "impressions"]
]

Indica que existe un error relacionado con el subcampo interested_in en el campo targeting_spec de la especificación de la API y que el error también está relacionado con el campo impressions en el campo bid_info de la especificación de la API.