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: Ayer
Actualización del documento en Español (España): 25 abr.

Campañas de compra Advantage+

Las campañas de compra de Advantage+ son una solución que permite a los anunciantes de marcas y de comercio electrónico y minoristas orientados al consumidor obtener un rendimiento potencialmente mejor, lograr una mayor personalización y registrar mayor eficiencia. Estas campañas ofrecen mayor flexibilidad para controlar ajustes como contenido, segmentación, ubicaciones y presupuesto, y proporcionan más oportunidades de optimizar las campañas para que impulsen las conversiones.

En lugar de ejecutar varias campañas con públicos segmentados, las campañas de compra Advantage+ te permiten combinar todos tus públicos de un determinado mercado en una sola estructura de campaña. Dicha estructura está diseñado para simplificar los procesos de creación y gestión y, al mismo tiempo, reducir la superposición de público.

Configuración manual de campañas en comparación con campañas de compra Advantage+

Configuración de la campaña habitual manualCampaña de compra Advantage+

Campañas habituales múltiples

Reemplazo de portfolio habitual


Segmentación manual con 7 ajustes de segmentación


Segmentación automatizada, automatización para incrementar la eficiencia de la configuración con la entrada de 1 país


Asignaciones presupuestarias estrictas de múltiples campañas


Liquidez presupuestaria dentro de 1 campaña


Prueba hasta 50 combinaciones de contenido


Permite anuncios dinámicos y estáticos con hasta 150 combinaciones de contenido


En este documento, se describen los pasos que necesitas seguir para configurar la integración de las campañas de compra Advantage+. Debes hacer lo siguiente:

  1. Definir clientes actuales
  2. Crear campaña
  3. Verificar creación de campaña
  4. Crear conjunto de anuncios
  5. Proporcionar contenido y crear anuncios
  6. Establecer restricción de edad mínima y exclusión geográfica (consultar documentación de referencia sobre los controles de la cuenta publicitaria)

Paso 1: Definir los clientes actuales

Las campañas de compra Advantage+ te permiten definir tus clientes actuales como una colección de identificadores del público personalizado. Tus clientes actuales son usuarios que ya están familiarizados con tu negocio o producto. Una vez que se definen los clientes, puedes utilizar esta definición para segmentar el presupuesto de las campañas de compra Advantage+ con el fin de limitar el gasto relacionado con los clientes actuales. Nosotros también proporcionaremos métricas de rendimiento relacionadas con tus campañas entre estos segmentos diferentes.

Puedes definir tu anuncio publicando en el punto de conexión /act_{ad_account_id}. Es necesario incluir el siguiente parámetro para configurar esta definición:

ParámetroDescripción

existing_customers

Matriz <string>

Matriz de identificadores de público personalizado a los que tiene acceso la cuenta publicitaria. Actualmente, los orígenes admitidos para el público personalizado son los sitios web, las actividades de la app, las listas de clientes, los catálogos y las actividades offline.


Para obtener información sobre cómo crear un público personalizado, consulta esta página.

Ejemplo

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>

Para obtener más información sobre el seguimiento de públicos nuevos y actuales en las herramientas de seguimiento de terceros, consulta Parámetros de URL de tipo de público.

Paso 2: Crear una campaña

Comienza creando tu campaña publicitaria. Para hacerlo, realiza una solicitud POST a /act_{ad_account_id}/campaigns.

Parámetros


ParámetroDescripción

name
Cadena

Obligatorio
Nombre de la campaña de compra de Advantage+.

objective
Enumeración

Obligatorio
Objetivo de la campaña. Especifica OUTCOME_SALES para este tipo de anuncio.

special_ad_categories

<Object> de lista

Obligatorio
Categorías de anuncios especiales asociadas a la campaña de compra de Advantage+

adlabels

<Object> de lista

Opcional
Etiquetas de anuncios asociados con la campaña de compra Advantage+

buying_type
Cadena

Opcional
Las campañas de compra Advantage+ solo admiten el valor AUCTION

execution_options

<enum> de lista

Opcional
Valor predeterminado: set. Las otras opciones son las siguientes:

  • validate_only: cuando está especificada esta opción, la llamada a la API no realiza la mutación, pero sí compara las reglas de validación con los valores de todos los campos.
  • include_recommendations: no es posible usar esta opción sola. Cuando se usa esta opción, se incluyen las recomendaciones para la configuración del objeto del anuncio. Se incluirá en la respuesta una sección de recomendaciones, pero solo si existen recomendaciones para esta especificación.

Si la llamada pasa la validación o la revisión, la respuesta será el código {"success": true}. Si la llamada no pasa, se devolverá un error con información más detallada.

smart_promotion_type
Enumeración

Obligatorio
Para especificar que se trata de una campaña de compra Advantage+, el tipo de promoción inteligente deberá configurarse en AUTOMATED_SHOPPING_ADS

status
Enumeración

Opcional
Las opciones válidas son: PAUSED y ACTIVE.


Si este estado es PAUSED, se pausarán todos los conjuntos de anuncios activos y los anuncios y tendrán el estado efectivo CAMPAIGN_PAUSED

Creación de ejemplo de campaña

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Actualización

Puedes actualizar una campaña enviando una solicitud POST a /{campaign_id}.

Parámetros


ParámetroDescripción

name
Cadena

Nombre de la campaña de compra de Advantage+

special_ad_categories

<Object> de lista

Categorías especiales de anuncios asociadas con la campaña de compra de Advantage+

adlabels

<Object> de lista

Etiquetas de anuncios asociadas con la campaña de compra de Advantage+

execution_options

<enum> de lista

Valor predeterminado: set. Las otras opciones son:

  • validate_only: cuando está especificada esta opción, la llamada a la API no realiza la mutación, pero sí compara las reglas de validación con los valores de todos los campos.
  • include_recommendations: no es posible usar esta opción sola. Cuando se usa esta opción, se incluyen las recomendaciones para la configuración del objeto del anuncio. Se incluirá en la respuesta una sección de recomendaciones, pero solo si existen recomendaciones para esta especificación.

Si la llamada pasa la validación o la revisión, la respuesta será el código {"success": true}. Si la llamada no pasa, se devolverá un error con información más detallada.

topline_id
Número entero o cadena

Identificador de líneas superiores

status
Enumeración

Puedes utilizar el siguiente estado para una llamada a la API de actualización:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Si una campaña de anuncios está configurada en PAUSED, los objetos secundarios activos se pausarán y tendrá el estado efectivo CAMPAIGN_PAUSED.

Ejemplo de actualización de campaña

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CAMPAIGN_ID>

Paso 3: Verificar la creación de la campaña

Para verificar que se creó con éxito una campaña de compra de Advantage+, puedes enviar una solicitud GET a /<AD_CAMPAIGN_ID> con el campo smart_promotion_type.

Una campaña de compra de Advantage+ válida regresará el valor de campo AUTOMATED_SHOPPING_ADS.

Ejemplo

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

Respuesta

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

Paso 4: Crear conjuntos de anuncios

Una vez que tengas una campaña publicitaria, crea tu conjunto de anuncios. Las campañas de compra de Advantage+ solo pueden tener un conjunto de anuncios asociado.

Para crear un conjunto de anuncios, envía una solicitud POST a /act_{ad_account_id}/adsets.

Parámetros


ParámetroDescripción

campaign_id
Cadenas numérica o número entero

Obligatorio
Una campaña de compra de Advantage+ válida que deseas agregar a este conjunto de anuncios.

name
Cadena

Obligatorio
Nombre de la campaña de compra de Advantage+.

promoted_object
Objeto

Obligatorio
El objeto que promociona este conjunto de anuncios en todos los anuncios. Para campañas de compra de Advantage+, proporciona la siguiente información:

  • pixel_id y
  • custom_event_type: el conjunto de anuncios de compras Advantage+ admite los eventos PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH y OTHER. No se admiten los eventos de conversión de clientes.

targeting
Objetivo de segmentación

Obligatorio
Estructura de segmentación del conjunto de anuncios de la compra de Advantage+. Solo se permiten especificaciones de geo_locations.

geo_locations
Matriz

Obligatorio
Se utiliza para limitar el público del conjunto de anuncios por

daily_budget
int64

Opcional
El presupuesto diario definido en la divisa de la cuenta, que solo se permite para conjuntos de anuncios con una duración (diferencia entre end_time y start_time) mayor a 24 horas.


Ni daily_budget ni lifetime_budget debe ser mayor a 0.

lifetime_budget
int64

Opcional
Presupuesto total definido en la divisa de tu cuenta. Si se especifica, también debes especificar una end_time.


Ni daily_budget ni lifetime_budget debe ser mayor a 0.

end_time
datetime

Obligatorio cuando lifetime_budget se configura.
Al crear un conjunto de anuncios con un daily_budget, especifica end_time=0 para configurar el conjunto de anuncios como continuo sin fecha de finalización. Marca de tiempo UNIX en UTC.


Ejemplo: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

optimization_goal
Enumeración

Opcional
Selecciona OFFSITE_CONVERSIONS como objetivo de optimización para maximizar el número de conversiones. Selecciona VALUE como objetivo de optimización si desea maximizar el valor de las conversiones. En el administrador de anuncios, mostramos el valor más alto como estrategia de puja.

bid_strategy
Enumeración

Opcional

  • LOWEST_COST_WITHOUT_CAP: Facebook hace pujas automáticamente en tu nombre y obtiene los resultados con los costos más bajos. Aumenta de forma automática tu puja efectiva según sea necesario para obtener los resultados que deseas según tu optimization_goal. Este es el valor predeterminado bid_strategy cuando optimization_goal es OFFSITE_CONVERSION o VALUE.
  • LOWEST_COST_WITH_MIN_ROAS: opción de puja específica de la optimización de valor. Debes especificar un roas_average_floor, es decir, el retorno mínimo esperado del gasto publicitario. Consulta Pujas de retorno mínimo de la inversión en publicidad.
  • COST_CAP: obtén los mejores resultados posibles mientras nos esforzamos por cumplir con los márgenes del costo por acción que configures. Debes proporcionar un número de límite en el campo bid_amount. Nota: No garantizamos el cumplimiento de los límites de costo. Consulta límite de costo.

bid_amount

Obligatorio si bid_strategy es COST_CAP.

bid_constraints
Objeto JSON

Opcional

  • optimization_goal debe ser VALUE.
  • bid_strategy debe ser LOWEST_COST_WITH_MIN_ROAS.
  • El ROAS mín., usa bid_constraints para pasar el "piso de ROAS", pero no puedes usarlo con bid_constraints. Usa roas_average_floor en su lugar. Consulta Pujas de retorno mínimo de la inversión en publicidad.
  • El rango válido de roas_average_floor is [100, 10000000], inclusive. Esto significa que el rango válido de "ROAS mínimo" es [0.01, 1000.0] o [1%, 100000.0%], inclusive.

billing_event
Enumeración

Obligatorio
Un evento de facturación del conjunto de anuncios. Solo se admite IMPRESSIONS para campañas de compra de Advantage+.

existing_customer_budget_percentage
Número

Opcional
Especifica el porcentaje máximo del presupuesto que se puede gastar en los clientes actuales asociados con esta cuenta publicitaria. Los valores más bajos pueden generar costos más altos por conversión. Valores válidos son entre 0 y 100.

adlabels

<Object> de lista

Opcional

Especifica una lista de etiquetas que estarán asociadas a este objeto.

start_time
Datetime

Opcional.
La fecha y hora de inicio del conjunto. Marca de tiempo UNIX en UTC.


Ejemplo: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

time_start
Datetime

Opcional

Inicio

time_stop
Datetime

Opcional

Finalización

attribution_spec

<JSON Object> de lista

Opcional
La atribución de la conversión que se utiliza para asignar conversiones que se desean optimizar.

Ejemplo de cómo crear conjunto de anuncios

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Actualización

Puedes actualizar un conjunto de anuncios realizando una solicitud POST a /{ad_set_id}.

Parámetros


ParámetroDescripción

adlabels

<Object> de lista

Especifica una lista de etiquetas que estarán asociadas a este objeto. Este campo es opcional.

daily_budget
int64

El presupuesto diario definido en la divisa de tu cuenta, que solo se permite para conjuntos de anuncios con una duración (diferencia entre end_time ystart_time) mayor a 24 horas.


Ni daily_budget ni lifetime_budget debe ser mayor a 0.

existing_customer_budget_percentage
Número

Especifica el porcentaje máximo del presupuesto que se puede gastar en los clientes existentes asociados con esta cuenta publicitaria. Los valores más bajos pueden generar costos más altos por conversión. Valores válidos son entre 0 y 100.

end_time
datetime

Se requiere la fecha de finalización cuando se especifica lifetime_budget.


Ejemplo: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT


Cuando crees un conjunto de anuncios con un presupuesto diario, especifica end_time=0 para configurar el conjunto de anuncios como continuo sin fecha de finalización.


Marca de tiempo UNIX en UTC.

execution_options

<enum> de lista

Valor predeterminado: set. Las otras opciones son:

  • validate_only: cuando está especificada esta opción, la llamada a la API no realiza la mutación, pero sí compara las reglas de validación con los valores de todos los campos.
  • include_recommendations: no es posible usar esta opción sola. Cuando se usa esta opción, se incluyen las recomendaciones para la configuración del objeto del anuncio. Se incluirá en la respuesta una sección de recomendaciones, pero solo si existen recomendaciones para esta especificación.

Si la llamada pasa la validación o la revisión, la respuesta será el código {"success": true}. Si la llamada no pasa, se devolverá un error con información más detallada.

start_time
Datetime

La fecha y hora de inicio del conjunto. Debe proporcionarse en una marca de tiempo UNIX en UTC.


Ejemplo: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

status
Enumeración

Opciones disponibles para las actualizaciones:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Si se configura en PAUSED, todos sus anuncios activos se pausarán y tendrán un estado efectivo ADSET_PAUSED.

lifetime_budget
int64

El presupuesto total definido en la divisa de tu cuenta. Si se especifica, también debes especificar una end_time.


Ni daily_budget ni lifetime_budget debe ser mayor a 0.

time_start
Datetime

Inicio

time_stop
Datetime

Finalización

targeting
Objetivo de segmentación

Estructura de segmentación de tu conjunto de anuncios. Los valores válidos de segmentación son geo_locations.

geo_locations
Matriz

Obligatorio
Se utiliza para limitar el público del conjunto de anuncios por

attribution_spec

<JSON Object> de lista

Opcional
La atribución de la conversión que se utiliza para asignar conversiones que se desean optimizar.

Ejemplo de actualización del conjunto de anuncios

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_SET_ID>

Paso 5: Proporcionar contenido y crear anuncios

Una vez que cuentas con un conjunto de anuncios, puedes crear tu anuncio haciendo una publicación en el punto de conexión /act_{ad_account_id}/ads. Pueden incluir los siguientes parámetros

Parámetros


ParámetroDescripción

name
Cadena

Obligatorio
El nombre del anuncio.

adset_id
int64

Obligatorio
El identificador del conjunto de anuncios; obligatorio cuando se crea.

creative
AdCreative

Obligatorio
La especificación de contenido del anuncio que usará este anuncio. Los campos válidos son:

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Puedes leer más sobre el contenido aquí.


Proporciona el contenido con el siguiente formato: {"creative_id": <CREATIVE_ID>}


O bien proporciona una especificación de contenido:

{
        "creative": {
          "name": <NAME>, 
          "object_story_spec": <SPEC>,
          "product_set_id": <PRODUCT_SET_ID>
        }
}

status
Enumeración

Opcional
Solo ACTIVE y PAUSED son válidos cuando se crea. Durante las pruebas, se recomienda configurar los anuncios en estado PAUSED para no incurrir en gastos accidentales.

adlabels

<Object> de lista

Opcional
Etiquetas de anuncios asociadas con este anuncio.

execution_options

<enum> de lista

Opcional
Valor predeterminado: set.

  • validate_only: cuando se especifica esta opción, la llamada a la API no realiza la mutación, pero sí compara las reglas de validación con los valores de todos los campos.
  • synchronous_ad_review: esta opción no se debería usar por sí sola. Se debe especificar siempre con validate_only. Cuando se especifican estas opciones, la llamada a la API realiza validaciones de integridad de los anuncios, lo que incluye la verificación del idioma del mensaje, la regla de 20% de texto en imágenes, etc., y las lógicas de validación.
  • include_recommendations: no es posible usar esta opción sola. Cuando se usa esta opción, se incluyen las recomendaciones para la configuración del objeto del anuncio. Se incluirá en la respuesta una sección independiente de recomendaciones, pero solo si existen recomendaciones para esta especificación.

Si la llamada pasa la validación o la revisión, la respuesta será el código {"success": true}. Si la llamada no pasa, se devolverá un error con información más detallada.

Ejemplo de cómo crear anuncios

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Campos del contenido

Para obtener una lista completa de los campos del contenido, consulta aquí.

CampoDescripción

object_story_spec
AdCreativeObjectStorySpec

Obligatorio
Se utiliza si deseas crear una nueva publicación de página oculta y transformar la publicación en un anuncio. El identificador de la página y el contenido para crear una nueva publicación de página oculta.

use_page_actor_override
AdCreative

Obligatorio
Si está configurado en true, mostramos la página de Facebook asociada con los anuncios de compra de Advantage.

Ejemplo de cómo crear contenido

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Actualización

Puedes actualizar un anuncio si envías una solicitud POST a /{ad_id}.

Parámetros


ParámetroDescripción

name
Cadena

Nuevo nombre del anuncio.

adlabels

<Object> de lista

Etiquetas de anuncios asociadas a este anuncio.

execution_options

<enum> de lista

Valor predeterminado: set. Las otras opciones son:

  • validate_only: cuando se especifica esta opción, la llamada a la API no realiza la mutación, pero sí compara las reglas de validación con los valores de todos los campos.
  • synchronous_ad_review: esta opción no se debería usar por sí sola. Se debe especificar siempre con validate_only. Cuando se especifican estas opciones, la llamada a la API realiza validaciones de integridad de los anuncios, lo que incluye la verificación del idioma del mensaje, la regla de 20% de texto en imágenes, etc., y las lógicas de validación.
  • include_recommendations: no es posible usar esta opción sola. Cuando se usa esta opción, se incluyen las recomendaciones para la configuración del objeto del anuncio. Se incluirá en la respuesta una sección independiente de recomendaciones, pero solo si existen recomendaciones para esta especificación.

Si la llamada pasa la validación o la revisión, la respuesta será el código {"success": true}. Si la llamada no pasa, se devolverá un error con información más detallada.

status
Enumeración

Las opciones son las siguientes:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Durante las pruebas, se recomienda configurar los anuncios en estado PAUSED para no incurrir en gastos accidentales.

creative
AdCreative

La especificación de contenido del anuncio que usará este anuncio. Los campos válidos son object_story_spec, asset_feed_spec y use_page_actor_override, y se pueden ver aquí. Puedes leer más sobre el contenido aquí.


Proporciona el contenido en el siguiente formato:

{
    "creative": {
      "name": <NAME>, 
      "object_story_spec": <SPEC>,
      "product_set_id": <PRODUCT_SET_ID>
    }
}

Ejemplo de actualización de anuncios

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>