Crear y poner en circulación campañas publicitarias

En esta página, se muestran los pasos para crear campañas publicitarias de socios administrados (vendedores) que registraste para anuncios de socios administrados.

Antes de empezar

Antes de crear y poner en circulación campañas publicitarias para tus socios, asegúrate de haber completado estos pasos:

Permisos obligatorios

Para llamar a la API de creación de anuncios de vendedores, necesitarás los siguientes permisos:

Administrador del negocio del vendedor

Segmentar para ubicaciones reguladas por la DSA (Unión Europea)

En el caso de las campañas publicitarias que segmentan para la Unión Europea (UE) y/o territorios asociados, los campos dsa_payor y dsa_beneficiary son obligatorios. La información proporcionada en estos dos campos se mostrará a los usuarios finales para indicar quién paga por el anuncio y quién es el beneficiario de este.

Se requerirá información sobre el beneficiario y el emisor del pago de todas las campañas dirigidas a la UE y los territorios asociados. Si no se proporcionan los campos, los anunciantes no podrán crear campañas de anuncios de socios administrados (MPA) y la API devolverá una respuesta con los códigos de error que se enumeran más abajo.

Llamada a la API de creación de anuncios de vendedor

Solicitud

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

La respuesta a la llamada a la API se devuelve de manera inmediata con un ASYNC_SESSION_ID. Mientras se procesa la solicitud, es necesario realizar una consulta periódica del ASYNC_SESSION_ID hasta que se alcance el estado final [COMPLETED|FAILED].

Parámetros

Nombre	Descripción
`conversion_domain` cadena	Obligatorio. Establece el dominio de conversión en el proceso de creación de anuncios. El campo `conversion_domain` debería coincidir con una configuración del píxel de Meta. Este campo debería incluir los dominios de primer y segundo nivel únicamente, y no debería incluir la URL completa. Por ejemplo, facebook.com.
`custom_event_type` enumeración	Opcional. Un evento de la app para el cual optimizar en anuncios de clientes potenciales y retargeting. Valores:`CONTENT_VIEW`, `ADD_TO_CART` y `PURCHASE` Condición: solo puedes especificar este campo si `use_marketplace_template` es `true` y `use_seller_template` es `false`.
`dsa_payor` cadena (máximo 512 caracteres)	Opcional. Quien paga por la campaña. Nota: Este campo es obligatorio en el caso de campañas que segmentan para la UE y/o territorios asociados.
`dsa_beneficiary` cadena (máximo 512 caracteres)	Opcional. El beneficiario de la campaña. Nota: Este campo es obligatorio en el caso de campañas que segmentan para la UE y/o territorios asociados.
`end_time` fecha y hora	Obligatorio. La hora de finalización de la campaña publicitaria en marca de tiempo UNIX UTC.
`lifetime_budget` cadena numérica	Obligatorio. El presupuesto de la campaña en la divisa de la cuenta publicitaria. En el mundo de los anuncios, la diferencia puede presentarse con 1 o 100 (en el caso de las divisas que incluyen el concepto de centavos). Por ejemplo, `lifetime_budget = 1` en USD (diferencia de 100) significa 1/100 (diferencia) = $0,01 (1 centavo). `lifetime_budget = 1` en JPY (diferencia de 1) significa 1/1 (diferencia) = ¥1 (1 yen).
`override_creative_text` cadena	Obligatorio. El cuerpo del contenido.
`override_targeting_countries` lista de <strings>	Opcional. La segmentación por país de la campaña. Esta configuración anula los países que se configuraron durante la creación del negocio del vendedor, tanto para los anuncios de clientes potenciales como los de retargeting.
`product_set_id` cadena numérica	Opcional. El identificador de un producto configurado dentro del catálogo de productos de un vendedor, que esta campaña promocionará en todos sus anuncios.
`start_time` fecha y hora	Obligatorio. La hora de inicio de la campaña publicitaria en marca de tiempo UNIX UTC.
`use_marketplace_template` booleano	Opcional. Especifica este campo para crear una campaña usando una plantilla predeterminada, que está disponible globalmente para todos los vendedores. Condición: se debe usar `use_marketplace_template` o `use_seller_template`, pero no ambos.
`use_seller_template` booleano	Opcional. Especifica este campo para crear una campaña usando una plantilla personalizada aplicada a un vendedor. Condición: se debe usar `use_marketplace_template` o `use_seller_template`, pero no ambos.

Respuesta

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

Usa el ASYNC_SESSION_ID para obtener el identificador correspondiente de un vendedor que se registró en los anuncios de socios administrados.

Si deseas obtener más información, consulta Cómo consultar una sesión asincrónica para obtener su respuesta.

Respuesta en caso de procesamiento correcto

Si el estado es COMPLETED, los datos que se obtienen de la consulta de la sesión asincrónica se verán de la siguiente manera:

{
  "result": "{\"id\":\"<NEWLY_CREATED_CAMPAIGN_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Respuesta en caso de error

Si el estado es FAILED, los datos que se obtienen de la encuesta de la sesión asincrónica se verán de la siguiente manera:

Códigos de error

Código de error	Subcódigo de error	Descripción
1800011	2310154	La publicación con contenido publicitario se creó con una app que se encuentra en modo de desarrollo. Debe ser pública para que se pueda crear este anuncio.
1800103	2310155	Falta un segmento de catálogo compartido en el {seller_business_id} del administrador comercial. Esto puede deberse a un registro incompleto. Puedes usar el centro de colaboraciones para compartir activos y agregar un segmento de catálogo, o bien puedes usar la API de eliminación de vendedores para eliminar el vendedor y volver a registrarlo con la API de registro de vendedores asincrónico. Si necesitas ayuda, también puedes ponerte en contacto con tu socio de Meta.
1800104	2310156	El identificador que ingresaste, {product_set_id}, no es un identificador de conjunto de productos. Ingresa un identificador de conjunto de productos asociado con el identificador de catálogo {catalog_id}.
1800105	2310157	El identificador que ingresaste, {product_set_id}, no es un identificador de conjunto de productos del segmento de catálogo del negocio. Ingresa un identificador de conjunto de productos asociado con el identificador de catálogo {catalog_id}.
1800208	2310152	La cuenta publicitaria de este negocio se desactivó debido a que infringía nuestras Políticas de publicidad u otras normas. Para obtener más información, ve a "Colaboraciones" en el centro de colaboraciones, selecciona "Socios administrados" y la pestaña "Problemas de calidad". Si necesitas ayuda o quieres hacer una apelación, también puedes ponerte en contacto con tu socio de Meta.
1800209	2310153	El {account_id} de la cuenta publicitaria que ingresaste no se creó con anuncios de socios administrados. Ingresa el identificador de la cuenta creado para este negocio cuando se registró en los anuncios de socios administrados.
1800308	2310137	Falta una página de vendedor en el {seller_business_id} del administrador comercial de este negocio. Esto puede deberse a un registro incompleto. Puedes usar la API de eliminación de vendedores para eliminar el vendedor y volver a registrarlo con la API de registro de vendedores asincrónico. Si necesitas ayuda, también puedes ponerte en contacto con tu socio de Meta.
1800309	2310159	La página de vendedor de este negocio se desactivó por una posible infracción de nuestras Política de publicidad u otras normas y no se puede usar para poner anuncios en circulación. Para obtener más información, ve a "Colaboraciones" en el centro de colaboraciones, selecciona "Socios administrados" y la pestaña "Problemas de calidad". Si necesitas ayuda o quieres hacer una apelación, también puedes ponerte en contacto con tu socio de Meta.
1800400	2310161	El presupuesto de la campaña que ingresaste es demasiado bajo. Según la plantilla utilizada, el presupuesto debe ser, como mínimo, de {minimum_budget}.
1800402	2310160	Los presupuestos de clientes potenciales y retargeting que ingresaste no equivalen al 100%. Ingresa un porcentaje de presupuesto para las campañas de clientes potenciales y uno para las campañas de retargeting que sumen 100%. Además, debes asegurarte de que se identifiquen una campaña de clientes potenciales y una de retargeting en la plantilla.
1800500	2310166	Estás intentando usar una API de anuncios de socios administrados (MPA) para actualizar campañas que no son de MPA. Revisa la campaña que ingresaste ({campaign_id}) o usa otra API.
1800501	2310168	El identificador de la campaña que ingresaste, ({campaign_id}), no pertenece a la cuenta publicitaria. Revisa el identificador y vuelve a intentarlo.
1800700	2310172	Ingresa la persona o la organización que paga por este conjunto de anuncios.
1800701	2310171	Ingresa la persona o la organización que se beneficia con este conjunto de anuncios.