adobe.target.sendNotifications(options)

Diese Funktion sendet eine Benachrichtigung an den Target -Edge, wenn ein Erlebnis ohne Verwendung von adobe.target.applyOffer() oder adobe.target.applyOffers() gerendert wird.

NOTE
Diese Funktion wurde in at.js 2.1.0 eingeführt und steht für Versionen höher als 2.1.0 zur Verfügung.
Schlüssel
Typ
Erforderlich?
Beschreibung
consumerId
Zeichenfolge
Nein
Der Standardwert ist die globale Mbox des Kunden, falls nicht angegeben. Dieser Schlüssel wird verwendet, um die ID für zusätzliche Daten zu generieren, die für die A4T-Integration verwendet wird.
Anfrage
Objekt
Ja
Siehe Anforderungstabelle unten.
Zeitüberschreitung
Nummer
Nein
Zeitüberschreitung der Abfrage. Wenn nicht angegeben, wird die standardmäßige at.js-Zeitüberschreitung verwendet.

Anfrage

Feldname
Typ
Erforderlich?
Einschränkung
Beschreibung
Request > notifications
Array von Objekten
Ja
Benachrichtigungen für den angezeigten Inhalt, angeklickte Selektoren und/oder besuchte Ansichten oder Mboxes.
Request > notifications > address
Objekt
Nein
Request > notifications > address > url
Zeichenfolge
Nein
URL, über die die Benachrichtigung ausgelöst wurde.
Request > notifications > address > referringUrl
Zeichenfolge
Nein
Die Referenz-URL, über die die Benachrichtigung ausgelöst wurde.
Request > notifications > parameters
Zeichenfolge
Nein

Die folgenden Namen sind für Parameter nicht zulässig:

  • orderId
  • orderTotal
  • productPurchasedIds

Beachten Sie Folgendes:

  • Maximale Begrenzung für Parameter: 50.
  • Der Parametername darf nicht leer sein.
  • Maximale Länge des Parameternamens: 128
  • Parameternamen dürfen nicht mit „profile“ beginnen.
  • Maximale Wertelänge des Parameters: 5.000.
Request > notifications > profileParameters
Zeichenfolge
Nein

Die folgenden Namen sind für Parameter nicht zulässig:

  • orderId
  • orderTotal
  • productPurchasedIds

Beachten Sie Folgendes:

  • Maximale Begrenzung für Parameter: 50.
  • Der Parametername darf nicht leer sein.
  • Maximale Länge des Parameternamens: 128
  • Parameternamen dürfen nicht mit „profile“ beginnen.
  • Maximale Wertelänge: 5.000.
Request > notifications > order
Objekt
Nein
Objekt, das die Bestelldetails beschreibt.

Request > notifications > order

id

Zeichenfolge
Nein
<= 250 Zeichen.
Bestell-ID.

Request > notifications > order

total

Zeichenfolge
Nein
>= 0
Bestellsumme.

Request > notifications > order

purchasedProductIds

Zeichenfolgen-Array
Nein
  • Keine leeren Werte zulässig.
  • Maximale Länger der Produkt-ID: 50
  • Produkt-IDs (durch Kommas getrennt und verkettet) dürfen eine Gesamtlänge von 250 nicht überschreiten.
Bestellprodukt-IDs.
Request > notifications > product
Objekt
Nein
Request > notifications > product > id
Zeichenfolge
Nein
<= 128 Zeichen; darf nicht leer sein.
Produkt-ID.
Request > notifications > product > categoryId
Zeichenfolge
Nein
<= 128 Zeichen; darf nicht leer sein.
Kategorie-ID.
Request > notifications > id
Zeichenfolge
Ja
<= 200 Zeichen.
Die Benachrichtigungs-ID wird in der Antwort zurückgegeben und gibt an, dass die Benachrichtigung erfolgreich verarbeitet wurde.
Request > notifications > impressionId
Zeichenfolge
Nein
<= 128 Zeichen.
Die Impressions-ID wird verwendet, um die aktuelle Benachrichtigung mit einer vorherigen Benachrichtigung oder Ausführungsanforderung zu verknüpfen. Stimmen beide überein, generieren die zweite sowie andere nachfolgende Anforderungen keine neue Impression für die Aktivität oder das Erlebnis.
Anforderung > Benachrichtigungen > Typ
Zeichenfolge
Ja
"click"oder "display"wird unterstützt.
Benachrichtigungstyp.
Request > notifications > timestamp
Nummer<int64>
Ja
Zeitstempel der Benachrichtigung in Millisekunden, die seit Beginn der UNIX-Epoche verstrichen sind.
Request > notifications > tokens
Zeichenfolgen-Array
Ja
Eine Liste der Token für angezeigte Inhalte oder angeklickte Selektoren basierend auf dem Typ der Benachrichtigung.
Request > notifications > mbox
Objekt
Nein
Benachrichtigungen für die Mbox.

Request > notifications > mbox

name

Zeichenfolge
Nein

Keine leeren Werte zulässig.

Zulässige Zeichen: Siehe Hinweis nach dieser Tabelle.

Name der Mbox.

Request > notifications > mbox

state

Zeichenfolge
Nein
Mbox-Statustoken.
Request > notifications > view
Objekt
Nein

Request > notifications > view

id

Ganzzahl <int64>
Nein
Ansicht-ID Die ID, die der Ansicht zugewiesen wurde, als die Ansicht über die Ansicht-API erstellt wurde.

Request > notifications > view

name

Zeichenfolge
Nein
<= 128 Zeichen
Name der Ansicht.

Request > notifications > view

key

Zeichenfolge
Nein
<= 512 Zeichen.
Ansichtsschlüssel. Der Schlüssel, der mit der Ansicht über die API festgelegt wurde.

Request > notifications > view

state

Zeichenfolge
Nein
Token für den Ansichtsstatus.

Hinweis: Die folgenden Zeichen sind nicht für Request > notifications > mbox > name zulässig:

- '-, ./=`:;&!@#$%^&*()+|?~[]{}'

sendNotifications()-Aufruf nach dem Rendern vorgeladener Mboxes

function createTokens(options) {
  return options.map(e => e.eventToken);
}

function createNotification(mbox, type, tokens) {
  const id = 11111; // here we should use a random ID like UUID
  const timestamp = Date.now();
  const { name, state, parameters, profileParameters, order, product } = mbox;
  const result = {
    id,
    type,
    timestamp,
    parameters,
    profileParameters,
    order,
    product
  };

  result.mbox = { name, state };
  result.tokens = tokens;

  return result;
}

adobe.target.getOffers({
  request: {
    prefetch: {
      mboxes: [
        {
          index: 0,
          name: "a1-serverside-ab"
        }
      ]
    }
  }
})
.then(response => {
  const mboxes = response.prefetch.mboxes;
  const notifications = mboxes.map(mbox => {
    const type = "display";
    const tokens = createTokens(mbox.options);

    return createNotification(mbox, type, tokens);
  });

  adobe.target.sendNotifications({
    request: { notifications }
  });
})
NOTE
Wenn Sie Adobe Analytics, getOffers() nur mit Vorabruf und sendNotifications() verwenden, muss die Analytics -Anfrage ausgelöst werden, nachdem sendNotifications() ausgeführt wurde. Dadurch soll sichergestellt werden, dass die durch sendNotifications() generierte SDID mit der an Analytics und Target gesendeten SDID übereinstimmt.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3