Tracking von Target-Konversionsereignissen mit Platform Web SDK
Konversionsereignisse für Target können mit Platform Web SDK ähnlich wie bei at.js verfolgt werden. Konversionsereignisse fallen normalerweise in die folgenden Kategorien:
- Automatisch verfolgte Ereignisse, für die keine Konfiguration erforderlich ist
- Kaufkonversionsereignisse, die für eine Best-Practice-Implementierung von Platform Web SDK angepasst werden sollten
- Nicht-Kauf-Konversionsereignisse, die Code-Aktualisierungen erfordern
Vergleich der Zielverfolgung
In der folgenden Tabelle wird verglichen, wie at.js und Platform Web SDK Konversionsereignisse verfolgen
context.address.url
in der Payload der at.js-Anfrage.xdm.web.webPageDetails.URL
in der sendEvent
PayloadtrackEvent()
oder sendNotifications()
mit einem type
Wert von display
.sendEvent
-Aufruf mit dem eventType
von decisioning.propositionDisplay
.notifications
-Objekt in der Payload der Anfrage und einem type
von click
.sendEvent
-Aufruf mit dem eventType
von decisioning.propositionInteract
.Automatisch getrackte Ereignisse
Die folgenden Konversionsziele erfordern keine spezifischen Anpassungen an Ihrer Implementierung:
- Konversion > Angezeigte Seite
- Konversion > Element angeklickt
- Interaktion > Seitenansichten
- Interaktion > Zeit vor Ort
xdm.web.webPageDetails.URL
-Wert die vollständige Seiten-URL mit dem richtigen Groß-/Kleinschreibung enthält.Benutzerdefinierte Ereignisse
Target-Implementierungen verwenden in der Regel benutzerdefinierte Konversionsereignisse, um Klicks für formularbasierte Aktivitäten zu verfolgen, eine Konversion in einem Fluss anzugeben oder Parameter zu übergeben, ohne neue Inhalte anzufordern.
In der folgenden Tabelle sind der at.js-Ansatz und das Platform Web SDK-Äquivalent für einige gängige Anwendungsfälle für das Konversions-Tracking aufgeführt.
trackEvent()
oder sendNotifications()
mit dem type
Wert click
für einen bestimmten Mbox-Speicherort aus.sendEvent
Befehl mit dem Ereignistyp decisioning.propositionInteract
austrackEvent()
oder sendNotifications()
mit dem type
Wert display
für einen bestimmten Mbox-Speicherort aus.sendEvent
Befehl mit dem Ereignistyp decisioning.propositionDisplay
ausdecisioning.propositionDisplay
am häufigsten verwendet wird, um Impressions für bestimmte Bereiche zu inkrementieren, sollte es in der Regel auch als direkter Ersatz für at.js-trackEvent()
verwendet werden. Die trackEvent()
-Funktion ist standardmäßig auf einen Typ von display
festgelegt, falls dieser nicht angegeben ist. Überprüfen Sie Ihre Implementierung, um sicherzustellen, dass Sie für alle definierten benutzerdefinierten Konversionen den richtigen Ereignistyp verwenden.Weitere Informationen zur Verwendung von trackEvent()
und sendNotifications()
zum Tracking von Target-Ereignissen finden Sie in der entsprechenden at.js-Dokumentation .
at.js-Beispiel mit trackEvent()
zum Tracking eines Klicks auf einen Mbox-Speicherort:
adobe.target.trackEvent({
"type": "click",
"mbox": "homepage_hero"
});
Mit einer Implementierung von Platform Web SDK können Sie Ereignisse und Benutzeraktionen verfolgen, indem Sie den sendEvent
-Befehl aufrufen, die _experience.decisioning.propositions
XDM-Feldergruppe ausfüllen und den eventType
auf einen von zwei Werten setzen:
decisioning.propositionDisplay
: Signalisiert das Rendering der Target-Aktivität.decisioning.propositionInteract
: Signalisiert eine Benutzerinteraktion mit der Aktivität wie ein Mausklick.
Die _experience.decisioning.propositions
XDM-Feldergruppe ist ein Array von -Objekten. Die Eigenschaften der einzelnen -Objekte werden von dem result.propositions
abgeleitet, der im sendEvent
-Befehl zurückgegeben wird: { id, scope, scopeDetails }
alloy("sendEvent", {
xdm: { ...},
decisionScopes: ["hero-banner"]
}).then(function (result) {
var propositions = result.propositions;
if (propositions) {
// Find the discount proposition, if it exists.
for (var i = 0; i < propositions.length; i++) {
var proposition = propositions[i];
for (var j = 0; j < proposition.items; j++) {
var item = proposition.items[j];
if (item.schema === "https://ns.adobe.com/personalization/measurement") {
// add metric to the DOM element
const button = document.getElementById("form-based-click-metric");
button.addEventListener("click", event => {
const executedPropositions = [
{
id: proposition.id,
scope: proposition.scope,
scopeDetails: proposition.scopeDetails
}
];
// send the click track event
alloy("sendEvent", {
"xdm": {
"eventType": "decisioning.propositionInteract",
"_experience": {
"decisioning": {
"propositions": executedPropositions
}
}
}
});
});
}
}
}
}
});
Erfahren Sie als Nächstes, wie Sie Domain-übergreifende ID-Freigabe aktivieren für konsistente Besucherprofile aktivieren.