Al usar la propiedad de CitrusAd, campaignFilterDate puede consultar las campañas que estarán activas en la fecha solicitada.

📘

Esta función es mejor para las integraciones de anuncios de banner, especialmente si tiene un requisito jurídico que le obligue a mostrar información de precios en el banner en el momento de la selección de una posición de entrega del cliente.

¿Qué hace esta opción?

Al especificar una campaignFilterDate en su solicitud de anuncio a CitrusAd, solo veremos las campañas que estarán activas en la fecha que ha especificado o las campañas que están configuradas como «Siempre activas» en el sistema CitrusAd.

En el sistema CitrusAd, los anunciantes pueden configurar una campaña para que solo esté activa en ciertos intervalos de fechas.

Esto depende normalmente del anunciante, de si desea programar su campaña durante un periodo de tiempo específico, o también puede seleccionar «Siempre activa» para permitir que la campaña siga con el gasto si hay presupuesto disponible.

Por ejemplo, la campaña anterior estará activa entre el 07/02/2023 y el 14/03/2023. Si se recibe una solicitud de anuncio relevante con una campaignFilterDate entre estas dos fechas, la campaña se entregará si se considera el anuncio más relevante.

Requisitos de integración

Descripción general

Además de una integración estándar con CitrusAd, su integración deberá mejorarse para especificar una campaignFilterDate en su solicitud de anuncio. No es necesario realizar cambios en los informes de impresiones y clics, pero debe asegurarse de que los informes de pedidos sean correctos, como se indica a continuación.

Solicitud de anuncio

La solicitud de anuncio deberá especificar una campaignFilterDate, en formato ISO-8601; a continuación se muestra un ejemplo:

Se prevé que esta capacidad campaignFilterDate será la fecha en la que el cliente recibirá su pedido desde su sitio web.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "campaignFilterDate": "2022-11-20T13:40:00+01:00",
    "options": {
                         "filterMode": "AndOr",
                             },
    "maxNumberOfAds": 3    
}

Informes de pedidos

Al generar informes de pedidos, deberá asegurarse de que se incluya lo siguiente:

• la fecha del pedido que especifique debe ser la hora en que el cliente realizó el pago y no la hora en que se recogerá o entregará el pedido del cliente.
  • Esto sirve para garantizar que el algoritmo de atribución de CitrusAd pueda aplicar la ventana correcta de retrospectiva a las interacciones de su cliente para atribuir las ventas a las campañas que se han mostrado al cliente.
• Como es probable que un cliente vuelva a enviar sus pedidos, también deberá asegurarse de no enviar una ID de pedido a CitrusAd. Esto garantizará que, al volver a enviar los pedidos y sus actualizaciones, el algoritmo de CitrusAD revise el pedido y los atributos en consecuencia.
  • Actualmente, el algoritmo de atribución de CitrusAd no vuelve a procesar un pedido cuando se envía con una ID de pedido que se ha enviado anteriormente.

Revise los datos del pedido para obtener la información correcta sobre los informes de pedidos.

Informes de plataforma

Como el sistema CitrusAd muestra informes en tiempo real, se generarán los informes de clics e impresiones, incluidos los de futuras entregas, cuando se visualice o se haga clic en ellos.

Como los anuncios se publican en tiempo real, se cobrarán en los monederos a medida que se generen los informes de impresiones y clics para CitrusAd.

🚧

Informes de gastos

Dado que esta función realiza consultas de campañas en el futuro, es posible que vea campañas con fechas activas en el futuro con datos de gasto e informes acumulados; este es el comportamiento previsto de la función, ya que las campañas que se planea que estén activas durante un periodo futuro se consultan con antelación.