Para integrarse con CitrusAd, necesitará al menos un catálogo de productos.
¿Qué es un catálogo?
Un catálogo es un grupo de productos y sus atributos, y se utiliza especialmente para agrupar todos los productos del sitio de un integrador en un solo catálogo.
Los anunciantes seleccionan los catálogos en el proceso de creación de la campaña y sus campañas solo se ejecutarán dentro del catálogo de productos seleccionado. Es una práctica común que todos los productos se agrupen en un solo catálogo para un integrador, lo que facilita la selección para los anunciantes.
La creación de varios catálogos se puede utilizar para segmentar la disponibilidad de productos en diferentes minoristas o países con el fin de crear campañas dirigidas.
Si desea crear varios catálogos, póngase en contacto con el administrador técnico de su cuenta para debatir las mejores prácticas, ya que puede haber formas más adecuadas de aplicar la segmentación.
Si se integra en un espacio de nombres de red, debe crear un solo catálogo.
¿Qué son los productos?
Los productos son GTIN individuales en el sitio del integrador. Los productos sincronizados con CitrusAd se sincronizan con valores y atributos de identificación individuales. Los productos deben representar cada GTIN/SKU en su catálogo actual de productos.
Los anunciantes seleccionan los productos en la creación de campañas y solo se muestran los productos relevantes para los catálogos que ha seleccionado mostrar el anunciante. Los productos no deben utilizarse para representar más de un GTIN de un solo producto. Las variaciones del mismo producto deben enumerarse como productos diferentes, p. ej., las variaciones de 200 ml, 600 ml y 2 litros del mismo producto de bebida se considerarían como tres productos diferentes en CitrusAd, en concordancia con las mejores prácticas existentes de los integradores.
Explicación de los filtros de productos
Los filtros de productos se utilizan principalmente para la generación de anuncios, además de contener propiedades como imageUrl y nombre. Al solicitar anuncios de CitrusAd, enviará un contexto con información relevante de la página para garantizar que se muestren anuncios relevantes en cada página.
La estructura de los filtros depende del integrador, pero lo más importante que hay que tener en cuenta es que estos filtros de producto se enviarán en su contexto de generación de anuncios. Los filtros de producto deben coincidir exactamente con lo que se solicita en la generación de anuncios.
Un contexto de ejemplo que contiene productFilters se describe a continuación:
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"productFilters": [
["category:Cupboard"],["dietary:Gluten-free"]
],
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
Este contexto solo devolverá anuncios de productos que contengan todos los filtros de la matriz correspondiente.
Si desea utilizar los valores mínimos de puja por categoría, asegúrese de que sus categorías son intuitivas y fáciles para los anunciantes que crean campañas, p. ej., category:Keyboards es más fácil de entender que la category:12.
Indicación de imágenes y nombres de productos
CitrusAd necesita información sobre las imágenes y los nombres de los productos para que puedan buscarse al crear campañas en el portal de CitrusAd. Estos valores se pueden enviar a CitrusAd dentro de etiquetas con el formato del siguiente ejemplo:
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",
"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"
]
}
]
}
Se ven en varias áreas del portal de CitrusAd, incluida la selección de productos, como en el siguiente ejemplo:
Imagen de referencia