Parameters naar doel verzenden met de extensie Offer Decisioning en Target

De doelimplementaties verschillen per mobiele toepassing vanwege de toepassingsarchitectuur, de zakelijke vereisten en de gebruikte functies. De meeste doelimplementaties bevatten het doorgeven van verschillende parameters voor contextuele informatie, doelgroepen en aanbevelingen voor inhoud.

Met de extensie Doel zijn alle doelparameters doorgegeven via de functie TargetParameters .

Met de extensie Offer Decisioning en Target:

Aangepaste parameters

Aangepaste mbox-parameters zijn de eenvoudigste manier om gegevens door te geven aan Target en kunnen worden doorgegeven in de xdm - of data.__adobe.target -objecten.

Profielparameters

Profielparameters slaan gegevens gedurende een langere periode op in het doelprofiel van de gebruiker en moeten worden doorgegeven in het data.__adobe.target -object.

Parameters entiteit

​ de parameters van de Entiteit ​ worden gebruikt om gedragsgegevens en aanvullende catalogusinformatie voor de Aanbevelingen van het Doel over te gaan. Net als profielparameters moeten de meeste eenheidsparameters worden doorgegeven onder het data.__adobe.target -object. De enige uitzondering is dat de array xdm.productListItems aanwezig is en dat de eerste SKU -waarde als entity.id wordt gebruikt.

Entiteiteits-parameters voor een specifiek item moeten vooraf met entity. worden vastgelegd om de gegevens correct vast te leggen. De gereserveerde cartIds - en excludedIds -parameters voor aanbevelingen-algoritmen mogen niet vooraf worden ingesteld en de waarde voor beide moet een door komma's gescheiden lijst met entiteit-id's bevatten.

Aankoopparameters

De parameters van de aankoop worden overgegaan op een de bevestigingspagina van het orde na een succesvolle orde en voor de omzettings en optimalisatiedoelstellingen van het Doel gebruikt. Met een Platform Mobile SDK-implementatie met de Offer Decisioning- en Target-extensie worden deze parameters en automatisch toegewezen aan XDM-gegevens die worden doorgegeven als onderdeel van de veldgroep commerce .

Aankoopgegevens worden doorgegeven aan Target wanneer voor de veldgroep commerce purchases.value is ingesteld op 1 . De bestellings-id en het totaal van de bestellingen worden automatisch toegewezen aan het order -object. Als de array productListItems aanwezig is, worden de waarden SKU gebruikt voor productPurchasedId .

Als u geen commerce -velden doorgeeft in het xdm -object, kunt u de ordergegevens doorgeven om het object te activeren met de velden data.__adobe.target.orderId , data.__adobe.target.orderTotal en data.__adobe.target.productPurchasedId .

Klant-id (mbox3rdPartyId)

Met Doel is het synchroniseren van profielen tussen apparaten en systemen mogelijk met één id van de klant. Deze klant-id moet worden doorgegeven in het veld identityMap van het XDM-object en worden toegewezen aan het veld Id van derde doelpartij in de gegevensstroom.

Tabel

Voorbeelden van parameters doorgeven

Gebruik een eenvoudig voorbeeld om de verschillen tussen de uitbreidingen aan te tonen wanneer het overgaan van parameters aan Doel.

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))

Daarna, leer hoe te ​ de omzettingsgebeurtenissen van het spoordoel ​ met het Web SDK van het Platform.