Inviare parametri a Target utilizzando l’estensione Offer Decisioning e Target

Le implementazioni di Target differiscono tra le applicazioni mobili a causa dell’architettura dell’app, dei requisiti aziendali e delle funzioni utilizzate. La maggior parte delle implementazioni di Target include il passaggio di vari parametri per informazioni contestuali, tipi di pubblico e consigli sui contenuti.

Con l'estensione Target, tutti i parametri di Target sono stati passati utilizzando la funzione TargetParameters.

Con l’estensione Offer Decisioning e Target:

Parametri personalizzati

I parametri mbox personalizzati sono il modo più semplice per trasmettere dati a Target e possono essere trasmessi negli oggetti xdm o data.__adobe.target.

Parametri del profilo

I parametri di profilo memorizzano i dati per un periodo di tempo prolungato nel profilo Target dell'utente e devono essere trasmessi nell'oggetto data.__adobe.target.

Parametri di entità

I parametri di entità vengono utilizzati per trasmettere dati comportamentali e informazioni di catalogo supplementari per i consigli di Target. Analogamente ai parametri di profilo, la maggior parte dei parametri di entità deve essere passata sotto l'oggetto data.__adobe.target. L'unica eccezione è rappresentata dall'array xdm.productListItems, quindi il primo valore SKU viene utilizzato come entity.id.

I parametri di entità per un elemento specifico devono avere il prefisso entity. per l'acquisizione dei dati corretta. I parametri riservati cartIds e excludedIds per gli algoritmi dei consigli non devono avere un prefisso e il valore di ciascuno deve contenere un elenco separato da virgole di ID entità.

Parametri di acquisto

I parametri di acquisto vengono trasmessi in una pagina di conferma dell’ordine dopo che quest’ultimo è stato completato correttamente e vengono utilizzati per gli obiettivi di conversione e ottimizzazione di Target. Con un'implementazione di Platform Mobile SDK che utilizza l'estensione Offer Decisioning e Target, questi parametri e vengono mappati automaticamente dai dati XDM passati come parte del gruppo di campi commerce.

Le informazioni di acquisto vengono passate a Target quando il gruppo di campi commerce ha purchases.value impostato su 1. L'ID ordine e il totale ordine vengono mappati automaticamente dall'oggetto order. Se l'array productListItems è presente, i valori SKU vengono utilizzati per productPurchasedId.

Se non trasmetti i campi commerce nell'oggetto xdm, puoi trasmettere i dettagli dell'ordine a Target utilizzando i campi data.__adobe.target.orderId, data.__adobe.target.orderTotal e data.__adobe.target.productPurchasedId.

ID cliente (mbox3rdPartyId)

Target consente la sincronizzazione dei profili tra dispositivi e sistemi utilizzando un singolo ID cliente. Questo ID cliente deve essere passato nel campo identityMap dell'oggetto XDM e mappato al campo ID terze parti di Target nel flusso di dati.

Tabella

Esempi di parametri di passaggio

Utilizziamo un semplice esempio per dimostrare le differenze tra le estensioni quando si trasmettono i parametri a Target.

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

Successivamente, scopri come tenere traccia degli eventi di conversione di Target con Platform Web SDK.