Documentación Guía para desarrolladores de Target

Enviar notificaciones (.NET)

Última actualización: 20 de julio de 2024

Temas:
APIs/SDKs

Creado para:

Desarrollador

Descripción

SendNotifications() se usa para enviar notificaciones de clics o visualizaciones a Adobe Target para la medición y generación de informes.

NOTE

Cuando un objeto Execute con parámetros requeridos se encuentra dentro de la propia solicitud, la impresión se incrementará automáticamente para las actividades calificadas.

Los métodos del SDK que incrementarán una impresión automáticamente son:

GetOffers()
GetAttributes()

Cuando se pasa un objeto Prefetch dentro de la solicitud, la impresión no se incrementa automáticamente para las actividades con mboxes dentro del objeto Prefetch. SendNotifications() debe usarse para experiencias previamente recuperadas para incrementar impresiones y conversiones.

Método

Crear

TargetDeliveryResponse TargetClient.SendNotifications(TargetDeliveryRequest request)

Ejemplo

En primer lugar, vamos a generar la solicitud Target Delivery API para recuperar previamente contenido para los mboxes home y product1.

.NET

var mboxRequests = new List<MboxRequest>
    {
        new (index: 1, name: "home"),
        new (index: 2, name: "product1"),
    };

var targetDeliveryRequest = new TargetDeliveryRequest.Builder()
    .SetPrefetch(new PrefetchRequest(mboxes: mboxRequests))
    .Build();

// Next, we fetch the offers via Target .NET SDK GetOffers() API
var targetResponse = targetClient.GetOffers(targetDeliveryRequest);

Una respuesta correcta contendrá un objeto de respuesta Target Delivery API, que incluye contenido recuperado previamente para los mboxes solicitados. Un objeto targetResponse.Response de ejemplo puede aparecer de la siguiente manera:

.NET

{
  "status": 200,
  "requestId": "e8ac2dbf5f7d4a9f9280f6071f24a01e",
  "id": {
    "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "client": "adobetargetmobile",
  "edgeHost": "mboxedge21.tt.omtrdc.net",
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "home",
        "options": [
          {
            "type": "html",
            "content": "HOME OFFER",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      },
      {
        "index": 1,
        "name": "product1",
        "options": [
          {
            "type": "html",
            "content": "TEST OFFER 1",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      }
    ]
  }
}

Observe los campos mbox name y state, así como el campo eventToken, en cada una de las Target opciones de contenido. Se deben proporcionar en la solicitud SendNotifications(), en cuanto se muestre cada opción de contenido. Supongamos que el mbox product1 se ha mostrado en un dispositivo que no es de explorador. La solicitud de notificaciones aparecerá de la siguiente manera:

.NET

var mboxNotifications = new List<Notification>
{
    new (id: "1", type: MetricType.Display, timestamp: DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
        mbox: new NotificationMbox("product1", "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"),
        tokens: new List<string> { "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==" })
};

var mboxNotificationRequest = new TargetDeliveryRequest.Builder()
    .SetNotifications(mboxNotifications)
    .Build();

Tenga en cuenta que hemos incluido el estado de mbox y el token de evento correspondiente a la oferta Target entregada en la respuesta de recuperación previa. Una vez creada la solicitud de notificaciones, podemos enviarla a Target mediante el método de API SendNotifications():

.NET

var notificationResponse = targetClient.SendNotifications(mboxNotificationRequest);

recommendation-more-help