adobe.target.sendNotifications(options)

Questa funzione invia una notifica al server Edge di Target quando viene eseguito il rendering di un’esperienza senza utilizzare adobe.target.applyOffer() o adobe.target.applyOffers().

NOTA

Questa funzione è stata introdotta in at.js 2.1.0 e sarà disponibile per tutte le versioni successive alla versione 2.1.0.

Chiave Tipo Obbligatorio Descrizione
consumerId Stringa No Il valore predefinito è la mbox globale del client, se non specificato. Questa chiave si utilizza per generare l’ID dati supplementare utilizzato per l’integrazione A4T.
Richiesta Oggetto Vedi la tabella Richieste di seguito.
timeout Numero No Timeout richiesta. Se non specificato, si utilizza il timeout predefinito di at.js.

Richiesta

Nome campo Tipo Obbligatorio Limitazione Descrizione
Request > notifications Array di oggetti Notifiche per il contenuto visualizzato, i selettori su cui è stato fatto clic e/o le visualizzazioni o le mbox visitate.
Request > notifications > address Oggetto No
Request > notifications > address > url Stringa No URL da cui è stata avviata la notifica.
Request > notifications > address > referringUrl Stringa No URL di riferimento da cui è stata avviata la notifica.
Request > notifications > parameters Oggetto No I seguenti nomi non sono consentiti per i parametri:
  • orderId
  • orderTotal
  • productPurchasedIds
Considera i seguenti aspetti:
  • Limite massimo di parametri: 50.
  • Il nome del parametro non può restare vuoto.
  • Lunghezza massima del nome del parametro: 128.
  • Il nome del parametro non può iniziare con “profile”.
  • Lunghezza massima del valore parametro: 5000.
Request > notifications > profileParameters Oggetto No I seguenti nomi non sono consentiti per i parametri:
  • orderId
  • orderTotal
  • productPurchasedIds
Considera i seguenti aspetti:
  • Limite massimo di parametri: 50.
  • Il nome del parametro non può restare vuoto.
  • Lunghezza massima del nome del parametro: 128.
  • Il nome del parametro non può iniziare con “profile”.
  • Lunghezza massima del valore parametro: 5000.
Request > notifications > order Oggetto No Oggetto che descrive i dettagli dell’ordine.
Request > notifications > order > id Stringa No <= 250 caratteri. ID ordine.
Request > notifications > order > total Stringa No >= 0 Totale ordine.
Request > notifications > order > purchasedProductIds Array di stringa No
  • Non sono consentiti valori vuoti.
  • Lunghezza massima di ogni ID prodotto: 50.
  • Lunghezza massima degli ID dei prodotti, separati da virgole e concatenati: 250.
ID dei prodotti di un ordine.
Request > notifications > product Oggetto No
Request > notifications > product > id Stringa No <= 128 caratteri; non può essere vuoto. ID prodotto.
Request > notifications > product > categoryId Stringa No <= 128 caratteri; non può essere vuoto. ID categoria.
Request > notifications > id Stringa <= 200 caratteri. L’ID della notifica viene restituito nella risposta e indica che la notifica è stata elaborata correttamente.
Request > notifications > impressionId Stringa No <= 128 caratteri. L’ID dell’impression viene utilizzato per unire (collegare) la notifica corrente con una notifica precedente o per eseguire una richiesta. Se entrambi corrispondono, la seconda e altre richieste successive non genereranno una nuova impression per l’attività o l’esperienza.
Request > notifications > type Stringa È supportato il tipo “click” o “display”. Tipo di notifica.
Request > notifications > timestamp Numero<int64> Marca temporale della notifica, in millisecondi trascorsi dall’epoca UNIX.
Request > notifications > tokens Array di stringa Elenco di token per i contenuti visualizzati o i selettori su cui è stato fatto clic, in base al tipo di notifica.
Request > notifications > mbox Oggetto No Notifiche per la mbox.
Request > notifications > mbox > name Stringa No Non sono consentiti valori vuoti.
Caratteri consentiti: vedi la nota in calce alla tabella.
Nome Mbox.
Request > notifications > mbox > state Stringa No Token dello stato della mbox.
Request > notifications > view Oggetto No
Request > notifications > view > id Intero <int64> No ID visualizzazione. ID assegnato alla visualizzazione al momento della creazione della stessa tramite l’API per le visualizzazioni.
Request > notifications > view > name Stringa No <= 128 caratteri. Nome della visualizzazione.
Request > notifications > view > key Stringa No <= 512 caratteri. Chiave visualizzazione. Chiave impostata per la visualizzazione tramite l’API.
Request > notifications > view > state Stringa No Token dello stato della visualizzazione.

Nota: I seguenti caratteri non sono ** consentiti per Request > notifications > mbox > name:

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

Chiamata sendNotifications() dopo il rendering delle mbox preacquisite

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 }
  });
})
NOTA

Se utilizzi Adobe Analytics, getOffers() esegue solo la preacquisizione e sendNotifications(), la richiesta di Analytics deve essere attivata dopo l’esecuzione di sendNotifications(). In tal modo l’identificatore SDID generato da sendNotifications() corrisponderà all’identificatore SDID inviato ad Analytics e Target.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now