Opciones premium para socios

Las opciones premium refuerzan las colaboraciones entre los minoristas y las marcas que usan nuestra solución de anuncios colaborativos con funciones únicas de segmentación y minería de insights. Los minoristas pueden ofrecer a los socios de marca complementos para los anuncios colaborativos mediante las opciones premium.

Configuraciones disponibles

Segmentación de categorías

La nueva segmentación de audiencias ampliadas permite a las marcas y a los anunciantes dirigir anuncios a audiencias en el nivel de la categoría formadas por personas que han visto artículos de la categoría a la que pertenecen los productos de la marca o los han añadido al carrito.

Insights de la cesta

Las insights de la cesta proporcionan información sobre las categorías de otras compras que se han realizado junto con el producto destacado del anuncio de la marca o el anunciante.

Audiencias personalizadas para minoristas

Las audiencias personalizadas para minoristas permiten a los minoristas compartir audiencias que tienen protección de dominio integrada con las marcas y los anunciantes con los que colaboran. La protección del dominio restringe las audiencias para que solo las usen socios de marca y dirige el tráfico de las campañas exclusivamente al sitio web del minorista.

Recuperar las opciones premium

Utiliza una llamada GET a la API para recuperar la configuración de las opciones premium de un segmento de catálogo. Puedes proporcionar los parámetros catalog_segment_id y partner_business_id o bien solo el parámetro vendor_id. Si usas ambas opciones, asegúrate de que el proveedor proporcionado sea el propietario del parámetro catalog_segment_id.

Solicitud

Para obtener la configuración con los parámetros catalog_segment_id y partner_business_id:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .catalog_segment_id(CATALOG_SEGMENT_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  .vendor_id(VENDOR_ID) \
  &access_token=ACCESS_TOKEN"

Para obtener la configuración únicamente con el parámetro vendor_id:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .vendor_id(VENDOR_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  &access_token=ACCESS_TOKEN"

Parámetros

Nombre	Descripción
`business_id` Cadena numérica o entero	Obligatorio. Identificador de la empresa en la que se encuentra el catálogo o el proveedor.
`catalog_segment_id` Cadena numérica o entero	Opcional. Identificador del segmento de catálogo que se debe actualizar. Es obligatorio proporcionar este campo o el campo `vendor_id`.
`vendor_id` Cadena	Opcional. Identificador del proveedor que se va a actualizar. Es obligatorio proporcionar este campo o el campo `catalog_segment_id`.
`partner_business_id` Cadena numérica o entero	Obligatorio. Identificador de la empresa del socio que se va a recuperar.

Respuesta

Si se completa correctamente, obtendrás la configuración actual de las opciones premium:

{
  "collaborative_ads_partner_premium_options": {
    "enable_extended_audience_retargeting": bool,
    "enable_basket_insight": bool,
    "retailer_custom_audience_config": {
      "audience_id": [
        AUDIENCE_ID_1,
        AUDIENCE_ID_2,
        AUDIENCE_ID_3
      ]
    }
  }
}

Actualizar las opciones premium

Utiliza una llamada POST a la API al extremo /{business_id}/partner_premium_options para actualizar la información de las opciones premium.

Solicitud

Para actualizar la configuración únicamente con los parámetros catalog_segment_id y partner_business_id:

curl -i -X POST \
  "https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?catalog_segment_id=CATALOG_SEGMENT_ID \
  &partner_business_id=PARTNER_BUSINESS_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

Para actualizar la configuración únicamente con el parámetro vendor_id:

curl -i -X POST \
"https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?vendor_id=VENDOR_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

Parámetros

Nombre	Descripción
`business_id` Cadena numérica o entero	Obligatorio. Identificador de la empresa en la que se encuentra el catálogo o el proveedor.
`catalog_segment_id` Cadena numérica o entero	Opcional. Identificador del segmento de catálogo que se va a actualizar. Es obligatorio proporcionar este campo o el campo `vendor_id`.
`vendor_id` Cadena	Opcional. Identificador del proveedor que se va a actualizar. Es obligatorio proporcionar este campo o el campo `catalog_segment_id`.
`partner_business_id` Cadena numérica o entero	Obligatorio. Identificador de la empresa del socio que se va a recuperar.
`enable_extended_audience_retargeting` Booleano	Obligatorio. Habilita o inhabilita la nueva segmentación de audiencias ampliadas.
`enable_basket_insight` Booleano	Obligatorio. Habilita o inhabilita las insights de la cesta.
`retailer_custom_audience_config` Objeto JSON {`audience_id`: matriz de cadenas}	Obligatorio. Contiene la lista de `audience_ids` que se van compartir con el segmento de catálogo. Introduce una matriz vacía para inhabilitar la opción de compartir. Ejemplo:`{'audience_id':[AUDIENCE_IDs]}`

Respuesta

{
  "status": "success"
}

Obtener identificadores de audiencia del Centro de colaboraciones

Puedes obtener el identificador de audiencia de la herramienta Audiencias del Centro de colaboraciones. Si no ves la columna Identificador de audiencia, haz clic en el menú desplegable Columnas en la esquina superior derecha de la página y selecciona la casilla Identificador de audiencia.

Más información

Anuncios colaborativos