El primer paso consiste en crear un catálogo de productos. El catálogo contiene los detalles de su producto, que son obligatorios para publicar anuncios de sus productos.

• Puede crear un solo catálogo o varios catálogos en una solicitud. Si va a crear varios catálogos, puede secuenciar hasta 100 catálogos por solicitud.
• Al crear un catálogo, catalogId se devuelve un . Este catalogId es obligatorio al añadir detalles del producto al catálogo, ya que sirve como identificador único para el catálogo.
• Si no puede crear un catálogo con las API mencionadas en este documento, póngase en contacto con su ingeniero de integración de clientes (CIE). Podrá crear el catálogo por usted.
• Una vez creado el catálogo, este está oculto de forma predeterminada, por lo que tiene que ponerse en contacto con su CIE para que lo haga visible en su espacio de nombres.

Requisitos

Debe tener claves de API y la URL básica antes de solicitar la creación de catálogos.

1. Debe tener una clave de API válida. Para obtener las claves de API, haga lo siguiente:

   1. Inicie sesión en la cuenta de equipo de Epsilon Retail Media.

   2. Navegue hasta la parte superior derecha de la página y haga clic en el menú desplegable.

   3. Seleccione Configuración de integración en el menú desplegable.

      

   4. Haga clic en la pestaña Clave API . Su clave API secreta estará inicialmente oculta. Para verla, haga clic en el botón Mostrar . Una vez sea visible, copie su clave API secreta. Utilice esta clave para realizar llamadas a la API.

2. Debe tener la URL base del punto de conexión de la API. Por ejemplo, https://staging-test.citrusad.com/v1/ads/generate HTTP/1.1. Consulte a su gestor técnico de cuentas para conocer la URL base.

Crear un catálogo único

Este endpoint de la API le permite crear un nuevo catálogo. Cada catálogo se identifica de forma única mediante un id que necesitará para otras operaciones, como al añadir detalles del producto al catálogo.

Solicitar parámetros

Ejemplo de solicitud

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        }
    ]
}

Ejemplo de respuesta

Las respuestas siguen un formato JSON estándar y devuelven los siguientes detalles en una matriz.

• teamId: el ID del equipo asociado al catálogo.
• name: el nombre del catálogo.
• id: el identificador único del catálogo. Este ID es necesario para otras operaciones, como al añadir detalles del producto al catálogo.

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        }
    ]
}

📘

Una vez que un objeto se haya devuelto correctamente, recibirá un ID para su nuevo catálogo. Si vuelve a enviar la misma solicitud, recibirá un nuevo ID que permitirá crear dos catálogos.

Crear varios catálogos

Este endpoint de la API le permite crear varios catálogos. Al crear varios catálogos, puede secuenciar hasta 100 catálogos por solicitud. A continuación se muestra un contexto de ejemplo para crear dos catálogos:

Ejemplo de solicitud

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        },
        {
            "name": "Retailer B"
        }
    ]
}

Ejemplo de respuesta

Las respuestas siguen un formato JSON estándar y devuelven los siguientes detalles en una matriz. Cada catálogo tendrá su propio teamid, namey del contexto. id:

• teamId: el ID del equipo asociado al catálogo.
• name: el nombre del catálogo.
• id: el identificador único del catálogo. Este ID es necesario para otras operaciones, como al añadir detalles del producto al catálogo.

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        },
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer B",
            "id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
        }
    ]
}

Crear varios catálogos por minorista

Para gestionar varios catálogos:

• Cree equipos de minoristas «secundarios» independientes para cada catálogo y un equipo de minoristas «principal» único.
• Configure la relación principal/secundario entre el equipo principal y cada equipo secundario, asegurándose de que el equipo principal esté correctamente asociado a todos los equipos secundarios.
• Después de configurar el equipo principal, actualice los estándares de contenido de todos los equipos secundarios para vincularlos con el equipo principal. Para ello, póngase en contacto con su ingeniero de integración de clientes (CIE).

Al crear varios catálogos para un minorista, tenga en cuenta los siguientes puntos:

• Relación 1 a 1: la configuración más segura es tener una relación 1 a 1 entre los equipos de catálogos y minoristas. Aunque no es estrictamente necesario, ayuda a evitar complicaciones.

• Ejemplo de estructura: en el siguiente diagrama, el equipo principal está anidado en el espacio de nombres del minorista. Cada equipo secundario (A, B, C) tiene su propio catálogo asociado (A, B, C). Esta estructura garantiza que las compras se atribuyan correctamente a los catálogos respectivos en función de la clave API del equipo utilizada en la confirmación del pedido.

  

• Varios catálogos en un solo equipo: puede crear varios catálogos en el mismo equipo de minoristas. Sin embargo, asegúrese de que las SKU y los ID de sesión no se compartan entre estos catálogos para mantener la atribución correcta. Si se incluye el catalogId en la llamada API del pedido ayuda a diferenciar los catálogos y evita errores de atribución. Para obtener más información, consulte Sincronización de datos de pedidos a través de API.

• Problemas de atribución: el hecho de compartir SKU y session IDs entre catálogos puede generar problemas de atribución. Por ejemplo, si tiene un sitio web en dos idiomas (p.ej., ES y FR) con un equipo de minoristas asociado a dos catálogos (uno para cada idioma) y SKU compartidos, un usuario identificado por el mismo sessionID en ambas versiones podría dar lugar a que una compra en el sitio en ES se atribuyera al sitio en FR y viceversa. Si se incluye el catalogId en la llamada API, se soluciona este problema garantizando que la atribución se asigne correctamente al catálogo correspondiente. Para obtener más información, consulte Sincronización de datos de pedidos a través de API.