Senden von Parametern an Target mithilfe der Offer Decisioning- und Target-Erweiterung

Target-Implementierungen unterscheiden sich je nach Mobile App-Architektur, Geschäftsanforderungen und verwendeten Funktionen. Bei den meisten Target-Implementierungen werden verschiedene Parameter für Kontextinformationen, Zielgruppen und Inhaltsempfehlungen übergeben.

Bei der Target-Erweiterung wurden alle Target-Parameter mithilfe der TargetParameters-Funktion übergeben.

Mit der Offer Decisioning- und Target-Erweiterung:

Benutzerdefinierte Parameter

Benutzerdefinierte Mbox-Parameter sind die einfachste Möglichkeit, Daten an Target zu übergeben, und können in den xdm oder data.__adobe.target Objekten übergeben werden.

Profilparameter

Profilparameter speichern Daten für einen längeren Zeitraum im Zielprofil des Benutzers und müssen im data.__adobe.target Objekt übergeben werden.

Entitätsparameter

Entitätsparameter werden verwendet, um Verhaltensdaten und zusätzliche Kataloginformationen für Target Recommendations zu übergeben. Ähnlich wie Profilparameter sollten die meisten Entitätsparameter unter dem data.__adobe.target Objekt übergeben werden. Die einzige Ausnahme ist, dass das xdm.productListItems-Array vorhanden ist, dann wird der erste SKU als entity.id verwendet.

Entitätsparameter für ein bestimmtes Element müssen mit dem Präfix entity. versehen werden, um eine ordnungsgemäße Datenerfassung zu gewährleisten. Die reservierten cartIds- und excludedIds-Parameter für Recommendations-Algorithmen sollten nicht mit einem Präfix versehen werden und der Wert für jedes muss eine kommagetrennte Liste von Entitäts-IDs enthalten.

Kaufparameter

Kaufparameter werden nach erfolgreicher Bestellung auf einer Auftragsbestätigungsseite weitergeleitet und für Konversions- und Optimierungsziele von Target verwendet. Bei einer Implementierung von Platform Mobile SDK unter Verwendung der Offer Decisioning- und Target-Erweiterung werden diese Parameter und automatisch aus XDM-Daten zugeordnet, die als Teil der commerce Feldergruppe übergeben werden.

Kaufinformationen werden an Target übergeben, wenn die commerce Feldergruppe auf purchases.value gesetzt 1. Die Auftrags-ID und die Bestellsumme werden automatisch aus dem order Objekt zugeordnet. Wenn das productListItems-Array vorhanden ist, werden die SKU Werte für die productPurchasedId verwendet.

Wenn Sie keine commerce Felder im xdm Objekt übergeben, können Sie die Bestelldetails mithilfe der Felder data.__adobe.target.orderId, data.__adobe.target.orderTotal und data.__adobe.target.productPurchasedId an Target übergeben.

Kunden-ID (mbox3rdPartyId)

Target ermöglicht die Synchronisierung von Profilen über Geräte und Systeme hinweg mithilfe einer einzigen Kunden-ID. Diese Kunden-ID sollte im identityMap Feld des XDM-Objekts übergeben und dem Feld „Target Third-Party-ID“ im Datenstrom zugeordnet werden.

Tabelle

Beispiele für die Übergabe von Parametern

Verwenden wir ein einfaches Beispiel, um die Unterschiede zwischen den Erweiterungen beim Übergeben von Parametern an Target zu veranschaulichen.

Android

final Map<String, Object> data = new HashMap<>();
final Map<String, String> targetParameters = new HashMap<>();

// Mbox parameters
targetParameters.put("status", "platinum");

// Profile parameters - prefix with profile.
targetParameters.put("profile.gender", "male");

// Product parameters
targetParameters.put("productId", "pId1");
targetParameters.put("categoryId", "cId1");

// Order parameters
targetParameters.put("orderId", "id1");
targetParameters.put("orderTotal", "1.0");
targetParameters.put("purchasedProductIds", "ppId1");

data.put("__adobe", new HashMap<String, Object>() {
  {
    put("target", targetParameters);
  }
});

// Target location (or mbox)
final DecisionScope decisionScope = DecisionScope("myTargetLocation")

final List<DecisionScope> decisionScopes = new ArrayList<>();
decisionScopes.add(decisionScope);

Optimize.updatePropositions(decisionScopes, null, data);

Map<String, String> mboxParameters = new HashMap<String, String>();
mboxParameters1.put("status", "platinum");

Map<String, String> profileParameters = new HashMap<String, String>();
profileParameters1.put("gender", "male");

List<String> purchasedProductIds = new ArrayList<String>();
purchasedProductIds.add("ppId1");
TargetOrder targetOrder = new TargetOrder("id1", 1.0, purchasedProductIds);

TargetProduct targetProduct = new TargetProduct("pId1", "cId1");

TargetParameters targetParameters = new TargetParameters.Builder()
                                    .parameters(mboxParameters)
                                    .profileParameters(profileParameters)
                                    .product(targetProduct)
                                    .order(targetOrder)
                                    .build();

iOS

var data: [String: Any] = [:]
var targetParameters: [String: String] = [:]

// Mbox parameters
targetParameters["status"] = "platinum"

// Profile parameters - prefix with profile.
targetParameters["profile.gender"] = "make"

// Product parameters
targetParameters["productId"] = "pId1"
targetParameters["categoryId"] = "cId1"

// Add order parameters
targetParameters["orderId"] = "id1"
targetParameters["orderTotal"] = "1.0"
targetParameters["purchasedProductIds"] = "ppId1"

data["__adobe"] = [
  "target": targetParameters
]

// Target location (or mbox)
let decisionScope = DecisionScope(name: "myTargetLocation")
Optimize.updatePropositions(for: [decisionScope] withXdm: nil andData: data)

let mboxParameters = [
                        "status": "platinum"
                     ]

let profileParameters = [
                            "gender": "male"
                        ]

let order = TargetOrder(id: "id1", total: 1.0, purchasedProductIds: ["ppId1"])

let product = TargetProduct(productId: "pId1", categoryId: "cId1")

let targetParameters = TargetParameters(parameters: mboxParameters, profileParameters: profileParameters, order: order, product: product))

Erfahren Sie als Nächstes, wie Sie Target-Konversionsereignisse ​ Platform Web SDK verfolgen.