Campañas de compras de Advantage+

Las campañas de compras de Advantage+ son una solución que permite a los anunciantes de marcas y directos al consumidor de comercio minorista y comercio electrónico potencialmente lograr un mejor rendimiento, una mayor personalización y más eficiencia. Estas campañas ofrecen una mayor flexibilidad para controlar elementos como el contenido, la segmentación, las ubicaciones y el presupuesto, así como más oportunidades de optimización de campañas para generar conversiones.

En lugar de lanzar varias campañas con audiencias segmentadas, las campañas de compras de Advantage+ permiten combinar todas tus audiencias para un mercado determinado en una única estructura de campaña. Su finalidad es simplificar la creación y la administración, y al mismo tiempo, reducir el solapamiento de audiencias.

Comparación entre la configuración manual de campañas y las campañas de compras de Advantage+

Configuración manual de las campañas habitualesCampaña de compras de Advantage+

Varias campañas habituales

Reemplazo del porfolio de campañas habituales


Segmentación manual con siete elementos de segmentación


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


Asignaciones presupuestarias estrictas en varias campañas


Liquidez presupuestaria dentro de una campaña


Prueba hasta 50 combinaciones de contenido


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


En este documento se describen los pasos que tienes que seguir si quieres configurar la integración para las campañas de compras de Advantage+. Necesitarás lo siguiente:

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

Paso 1: Definir los clientes actuales

Las campañas de compras de Advantage+ permiten definir los clientes actuales como una colección de identificadores de audiencias personalizadas. Los clientes actuales son usuarios que ya están familiarizados con tu negocio o producto. Una vez configurada esta definición, puedes utilizarla para segmentar el presupuesto para las campañas de compras de Advantage+ con el objetivo de limitar el gasto en los clientes actuales. También proporcionamos métricas que informan del rendimiento de tus campañas en los diferentes segmentos.

Para definir el anuncio, publica en el extremo /act_{ad_account_id}. Debes incluir el siguiente parámetro para configurar la definición:

ParámetroDescripción

existing_customers

Matriz<string>

Matriz de identificadores de audiencias personalizadas a las que la cuenta publicitaria tiene acceso. Actualmente, los orígenes admitidos para las audiencias personalizadas son el sitio web, la actividad de la aplicación, la lista de clientes, el catálogo y la actividad fuera de internet.


Para obtener información sobre cómo crear una audiencia personalizada, 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/v20.0/act_<AD_ACCOUNT_ID>

Para obtener más información sobre el seguimiento de audiencias nuevas y actuales en herramientas de seguimiento de terceros, consulta Parámetros de URL del tipo de audiencia.

Paso 2: Crear una campaña

Crea una campaña publicitaria. Para ello, realiza una solicitud POST a /act_{ad_account_id}/campaigns.

Parámetros


ParámetroDescripción

name
Cadena

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

objective
Enumeración

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

special_ad_categories

Lista<Object>

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

adlabels

Lista<Object>

Opcional.
Etiquetas de anuncios asociadas a la campaña de compras de Advantage+.

buying_type
Cadena

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

execution_options

Lista<enum>

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

  • validate_only: cuando se especifica esta opción, la llamada a la API no llevará a cabo la mutación, sino que se ejecutará mediante las reglas de validación con los valores de cada campo.
  • include_recommendations: esta opción no se puede utilizar sola. Cuando se use esta opción, se incluirán recomendaciones para la configuración del objeto de anuncio. Se incluirá en la respuesta una sección independiente de recomendaciones, pero solo si hay recomendaciones para esta especificación.

Si la llamada supera la validación o la revisión, la respuesta será {"success": true}. Si la llamada no supera la validación, se devolverá un error con más detalles.

smart_promotion_type
Enumeración

Obligatorio.
Para especificar que se trata de una campaña de compras de Advantage+, el tipo de promoción inteligente debe establecerse en AUTOMATED_SHOPPING_ADS.

status
Enumeración

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


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

Ejemplo de creación de campañas

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/v20.0/act_<AD_ACCOUNT_ID>/campaigns

Actualización

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

Parámetros


ParámetroDescripción

name
Cadena

Nombre de la campaña de compras de Advantage+.

special_ad_categories

Lista<Object>

Categorías de anuncios especiales asociadas a la campaña de compras de Advantage+.

adlabels

Lista<Object>

Etiquetas de anuncios asociadas a la campaña de compras de Advantage+.

execution_options

Lista<enum>

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

  • validate_only: cuando se especifica esta opción, la llamada a la API no llevará a cabo la mutación, sino que se ejecutará mediante las reglas de validación con los valores de cada campo.
  • include_recommendations: esta opción no se puede utilizar sola. Cuando se use esta opción, se incluirán recomendaciones para la configuración del objeto de anuncio. Se incluirá en la respuesta una sección independiente de recomendaciones, pero solo si hay recomendaciones para esta especificación.

Si la llamada supera la validación o la revisión, la respuesta será {"success": true}. Si la llamada no supera la validación, se devolverá un error con más detalles.

topline_id
Cadena numérica o entero

Identificador de la línea superior.

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 publicitaria se establece en PAUSED, sus objetos dependientes activos se pondrán en pausa y tendrán el estado efectivo CAMPAIGN_PAUSED.

Ejemplo de actualización de campañas

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

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

Para verificar que hayas creado correctamente una campaña de compras de Advantage+, puedes realizar una solicitud GET a /<AD_CAMPAIGN_ID> con el campo smart_promotion_type.

Una campaña de compras de Advantage+ válida devolverá el valor del campo AUTOMATED_SHOPPING_ADS.

Ejemplo

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

Respuesta

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

Paso 4: Crear un conjunto de anuncios

Una vez que tengas una campaña publicitaria, crea el conjunto de anuncios. Cada campaña de compras de Advantage+ solo puede tener un conjunto de anuncios asociado.

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

Parámetros


ParámetroDescripción

campaign_id
Cadena numérica o entero

Obligatorio.
Campaña de compras de Advantage+ válida a la que quieres añadir este conjunto de anuncios.

name
Cadena

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

promoted_object
Objeto

Obligatorio.
Objeto que promociona este conjunto de anuncios en todos sus anuncios. Para campañas de compras de Advantage+, proporciona lo siguiente:

  • pixel_id y
  • custom_event_type: los conjuntos de anuncios de compras de Advantage+ admiten los eventos siguientes: PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH y OTHER.

targeting
Objeto de segmentación

Obligatorio.
Estructura de segmentación del conjunto de anuncios de compras de Advantage+. Solo se permite especificar valores de geo_locations.

geo_locations
Matriz

Obligatorio.
Se usa para restringir la audiencia del conjunto de anuncios según lo siguiente:

daily_budget
Entero de 64 bits

Opcional.
Presupuesto diario definido en la moneda de la cuenta que solo se permite en el caso de conjuntos de anuncios con una duración (diferencia entre end_time y start_time) superior a 24 horas.


daily_budget o lifetime_budget debe ser mayor que 0.

lifetime_budget
Entero de 64 bits

Opcional.
Presupuesto total definido en la moneda de la cuenta. Si se especifica, también debes especificar un valor de end_time.


daily_budget o lifetime_budget debe ser mayor que 0.

end_time
Fecha y hora

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


Por 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 quieres 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 te proporciona los resultados con un menor coste. Si resulta necesario, aumenta de forma automática la puja efectiva para obtener los resultados que quieres en función del objetivo que estableciste en el campo optimization_goal. Este es el valor predeterminado de bid_strategy cuando “optimization_goal” es OFFSITE_CONVERSION o VALUE.
  • LOWEST_COST_WITH_MIN_ROAS: opción de puja específica para la optimización del valor. Debes especificar un valor de roas_average_floor, que es el retorno mínimo que se quiere obtener del gasto en anuncios. Consulta Pujas con un retorno del gasto publicitario mínimo.
  • COST_CAP: obtén el mayor número de resultados posible, a la vez que nos esforzamos por respetar el coste por acción que has establecido. Debes proporcionar un número límite en el campo bid_amount. Nota: No podemos garantizar el cumplimiento de los límites de coste. Consulta Límites de coste.

bid_amount

Obligatorio si el valor de “bid_strategy” es COST_CAP.

bid_constraints
Objeto JSON

Opcional.

  • optimization_goal debe ser VALUE.
  • bid_strategy debe ser LOWEST_COST_WITH_MIN_ROAS.
  • Las pujas de ROAS mínimo utilizan bid_constraints para pasar los límites de ROAS, pero no pueden utilizarse con bid_constraints. En su lugar, utiliza roas_average_floor. Consulta Pujas con un retorno del gasto publicitario mínimo.
  • El intervalo válido de roas_average_floor es [100, 10000000], con ambos valores incluidos. Es decir, que el intervalo válido de “ROAS mínimo” es [0.01, 1000.0] o [1%, 100000.0%], con ambos valores incluidos.

billing_event
Enumeración

Obligatorio.
Evento de facturación del conjunto de anuncios. Solo se admite IMPRESSIONS para las campañas de compras 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 a la cuenta publicitaria. Los valores más bajos pueden significar mayores costes por conversión. Los valores válidos están comprendidos entre 0 y 100.

adlabels

Lista<Object>

Opcional.

Especifica la lista de etiquetas que se asociarán a este objeto.

start_time
Fecha y hora

Opcional.
Hora de inicio del conjunto. Marca de tiempo UNIX UTC.


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

time_start
Fecha y hora

Opcional.

Hora de inicio.

time_stop
Fecha y hora

Opcional.

Hora de finalización.

attribution_spec

Lista<JSON Object>

Opcional.
Especificación de atribución de conversiones utilizada para atribuir conversiones que se quieren optimizar.

Ejemplo de creación de conjuntos 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/v20.0/act_<AD_ACCOUNT_ID>/adsets

Actualización

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

Parámetros


ParámetroDescripción

adlabels

Lista<Object>

Especifica la lista de etiquetas que se asociarán a este objeto. Este campo es opcional.

daily_budget
Entero de 64 bits

Presupuesto diario definido en la moneda de la cuenta que solo se permite en el caso de conjuntos de anuncios con una duración (diferencia entre end_time y start_time) superior a 24 horas.


daily_budget o lifetime_budget debe ser mayor que 0.

existing_customer_budget_percentage
Número

Especifica el porcentaje máximo del presupuesto que se puede gastar en los clientes actuales asociados a la cuenta publicitaria. Los valores más bajos pueden significar mayores costes por conversión. Los valores válidos están comprendidos entre 0 y 100.

end_time
Fecha y hora

Hora de finalización (obligatoria cuando se especifica lifetime_budget).


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


Al crear un conjunto de anuncios con un presupuesto diario, especifica end_time=0 para establecer el conjunto de anuncios como continuo sin fecha de finalización.


Marca de tiempo UNIX UTC.

execution_options

Lista<enum>

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

  • validate_only: cuando se especifica esta opción, la llamada a la API no llevará a cabo la mutación, sino que se ejecutará mediante las reglas de validación con los valores de cada campo.
  • include_recommendations: esta opción no se puede utilizar sola. Cuando se use esta opción, se incluirán recomendaciones para la configuración del objeto de anuncio. Se incluirá en la respuesta una sección independiente de recomendaciones, pero solo si hay recomendaciones para esta especificación.

Si la llamada supera la validación o la revisión, la respuesta será {"success": true}. Si la llamada no supera la validación, se devolverá un error con más detalles.

start_time
Fecha y hora

Hora de inicio del conjunto. Debe proporcionarse en una marca de tiempo UNIX UTC.


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

status
Enumeración

Opciones de actualizaciones disponibles:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Si se establece en PAUSED, todos sus anuncios activos se pondrán en pausa y tendrán el estado efectivo ADSET_PAUSED.

lifetime_budget
Entero de 64 bits

Presupuesto del conjunto de anuncios definido en la moneda de la cuenta. Si se especifica, también debes especificar un valor de end_time.


daily_budget o lifetime_budget debe ser mayor que 0.

time_start
Fecha y hora

Hora de inicio.

time_stop
Fecha y hora

Hora de finalización.

targeting
Objeto de segmentación

Estructura de segmentación para el conjunto de anuncios. Los valores válidos para la segmentación son geo_locations.

geo_locations
Matriz

Obligatorio.
Se usa para restringir la audiencia del conjunto de anuncios según lo siguiente:

attribution_spec

Lista<JSON Object>

Opcional.
Especificación de atribución de conversiones utilizada para atribuir conversiones que se quieren optimizar.

Ejemplo de actualización de conjuntos de anuncios

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

Paso 5: Proporcionar contenido y crear anuncios

Cuando tengas un conjunto de anuncios, puedes publicar en el extremo /act_{ad_account_id}/ads para crear el anuncio. Puedes incluir los siguientes parámetros:

Parámetros


ParámetroDescripción

name
Cadena

Obligatorio.
Nombre del anuncio.

adset_id
Entero de 64 bits

Obligatorio.
Identificador del conjunto de anuncios, necesario durante la creación.

creative
Contenido del anuncio

Obligatorio.
Especificación de contenido o identificador del contenido del anuncio que utilizará este anuncio. Los campos válidos son los siguientes:

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Puedes obtener más información sobre los contenidos aquí.


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


Como alternativa, proporciona una especificación de contenido:

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

status
Enumeración

Opcional.
Durante la creación, solo son válidos los valores ACTIVE y PAUSED. Durante las pruebas, se recomienda establecer los anuncios en el estado PAUSED para evitar gastos accidentales.

adlabels

Lista<Object>

Opcional.
Etiquetas de anuncios asociadas a este anuncio.

execution_options

Lista<enum>

Opcional.
Valor predeterminado: set.

  • validate_only: cuando se especifica esta opción, la llamada a la API no llevará a cabo la mutación, sino que se ejecutará mediante las reglas de validación con los valores de cada campo.
  • synchronous_ad_review: esta opción no debe utilizarse sola. Siempre se debe especificar con validate_only. Cuando se especifican estas opciones, la llamada a la API llevará a cabo las validaciones de integridad de los anuncios, que incluyen la comprobación del idioma del mensaje o la regla que indica que el texto no debe ocupar más del 20 % de la imagen, entre otras cosas, así como las lógicas de validación.
  • include_recommendations: esta opción no se puede utilizar sola. Cuando se use esta opción, se incluirán recomendaciones para la configuración del objeto de anuncio. En la respuesta se incluirá una sección de recomendaciones independiente, pero solo si hay recomendaciones para esta especificación.

Si la llamada supera la validación o la revisión, la respuesta será {"success": true}. Si la llamada no supera la validación, se devolverá un error con más detalles.

Ejemplo de creación de 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/v20.0/act_<AD_ACCOUNT_ID>/ads

Campos de contenido

Para obtener la lista completa de campos de contenido de los anuncios, consulta aquí.

CampoDescripción

object_story_spec
AdCreativeObjectStorySpec

Obligatorio.
Utilízalo si quieres crear una nueva publicación de página oculta y convertir la publicación en un anuncio. Identificador de la página y contenido para crear una nueva publicación de página oculta.

use_page_actor_override
Contenido del anuncio

Obligatorio.
Si se establece en true, se muestra la página de Facebook asociada a los anuncios de compras de Advantage.

Ejemplo de creación de contenido

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

Actualización

Para actualizar un anuncio, realiza una solicitud POST a /{ad_id}.

Parámetros


ParámetroDescripción

name
Cadena

Nuevo nombre del anuncio.

adlabels

Lista<Object>

Etiquetas de anuncios asociadas a este anuncio.

execution_options

Lista<enum>

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

  • validate_only: cuando se especifica esta opción, la llamada a la API no llevará a cabo la mutación, sino que se ejecutará mediante las reglas de validación con los valores de cada campo.
  • synchronous_ad_review: esta opción no debe utilizarse sola. Siempre se debe especificar con validate_only. Cuando se especifican estas opciones, la llamada a la API llevará a cabo las validaciones de integridad de los anuncios, que incluyen la comprobación del idioma del mensaje o la regla que indica que el texto no debe ocupar más del 20 % de la imagen, entre otras cosas, así como las lógicas de validación.
  • include_recommendations: esta opción no se puede utilizar sola. Cuando se use esta opción, se incluirán recomendaciones para la configuración del objeto de anuncio. En la respuesta se incluirá una sección de recomendaciones independiente, pero solo si hay recomendaciones para esta especificación.

Si la llamada supera la validación o la revisión, la respuesta será {"success": true}. Si la llamada no supera la validación, se devolverá un error con más detalles.

status
Enumeración

Las opciones son las siguientes:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Durante las pruebas, se recomienda establecer los anuncios en el estado PAUSED para evitar gastos accidentales.

creative
Contenido del anuncio

La especificación de contenido del anuncio que se utilizará en este anuncio. Los campos válidos son object_story_spec, asset_feed_spec y use_page_actor_override. Para verlos, haz clic aquí. Puedes obtener más información sobre los contenidos 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/v20.0/<AD_ID>