Actualizar campañas publicitarias

En esta página se describen los pasos para actualizar las campañas publicitarias de socios administrados (vendedores) que has incorporado a los anuncios de socios administrados.

Antes de empezar

Antes de actualizar las campañas publicitarias para tus socios, asegúrate de completar los pasos siguientes:

1. Crear un usuario administrador del sistema.
2. Asignar permisos al usuario administrador del sistema.
3. Generar un identificador de acceso para el usuario administrador del sistema.
4. Comprobar la idoneidad del vendedor
5. Incorporar un vendedor

Permisos necesarios

Para llamar a la API de actualización de anuncios para vendedores, el usuario necesitará los siguientes permisos:

• Administrador del negocio del vendedor

Ubicaciones de segmentación reguladas por la DSA (Unión Europea)

Para campañas publicitarias que se dirijan a la Unión Europea (UE) o a territorios asociados, se requieren los campos dsa_payor y dsa_beneficiary. La información proporcionada en estos dos campos se mostrará a los usuarios finales para indicar quién financia el anuncio y quién se beneficia de él. Si no se proporcionan los campos, los anunciantes no podrán editar las campañas publicitarias de socios administrados y la API devolverá una respuesta con error. Puedes ver los códigos de error a continuación.

Llamada a la API para actualizar anuncios de vendedores

Solicitud

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "campaign_group_id=123456789&lifetime_budget=100000" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

La respuesta de la llamada a la API se devuelve inmediatamente con un ASYNC_SESSION_ID. Mientras la solicitud se sigue procesando, se debe consultar el valor de ASYNC_SESSION_ID hasta que se alcance el estado terminal [COMPLETED|FAILED].

Parámetros

Respuesta

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Usa el valor de ASYNC_SESSION_ID para obtener el identificador correspondiente de un vendedor incorporado en los anuncios de socios administrados.

Consulta Cómo consultar la sesión asíncrona para obtener una respuesta para obtener más información.

Respuesta correcta

Si el estado es COMPLETED, los datos resultantes de la consulta de la sesión asíncrona tendrán el siguiente aspecto:

{
  "result": "{\"id\":\"<NEWLY_UPDATED_CAMPAIGN_ID>\",\"success\":true}",
  "id": "<ASYNC_SESSION_ID>"
}

Respuesta con error

Si el estado es FAILED, los datos resultantes de la consulta de la sesión asíncrona tendrán el siguiente aspecto:

Códigos de error

Ver más

• Cómo consultar la sesión asíncrona para obtener una respuesta