Integración de productos principales

¿Qué es un producto secundario?

Algunos productos tienen relaciones de tipo principal y secundario. Hay un producto principal y sus múltiples variaciones son los productos secundarios. Los anunciantes quieren optimizar las campañas a nivel de producto secundario para asegurarse de que promocionar los productos más relevantes y con mejor rendimiento para los clientes.

Otros productos no tendrán estas relaciones y, por lo tanto, no experimentarán ningún cambio o impacto en la plataforma.

Capacidades de IU

Selección de productos

Al seleccionar productos, se agruparán los productos principales/secundarios.

Al hacer clic en un producto principal, se expandirá para mostrar los productos secundarios. Esto permitirá a sus anunciantes optimizar la campaña a un nivel de producto secundario único.

Informes

Los informes en la plataforma se agruparán automáticamente por producto principal cuando un producto tenga una productCollection asociada.

En las exportaciones en CSV de la plataforma, para los códigos de producto hay una nueva columna, «Código principal», que rellenará automáticamente el productCollection valor.

Al filtrar por código de producto en la IU, las métricas del producto principal aparecen en blanco y se puede hacer clic en el producto principal para mostrar informes de cualquier producto secundario.

Requisitos de integración

Actualización de productos

Al sincronizar productos con CitrusAd, hay un nuevo productCollection campo en la solicitud de PUBLICACIÓN de sus productos.

POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1 
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "productCollection": "abc-123",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]

Cuando este campo esté presente, las tablas de selección de productos e informes se añadirán al nivel de colección de productos para todos los productos que compartan la misma productCollection.

Si sincroniza por archivo, hay una product_collection columna que puede rellenar opcionalmente por producto.

Renderización de anuncios

No hay necesidad de realizar cambios al renderizar anuncios de CitrusAd. El gtin que recibirá en la respuesta de la API será el del producto «secundario» y deberá renderizarlo en su sitio web para sus clientes.