Envoi de paramètres à Target à l’aide de l’extension Offer Decisioning et Target

Les implémentations de Target varient d’une application mobile à l’autre en raison de l’architecture des applications, des exigences commerciales et des fonctionnalités utilisées. La plupart des implémentations de Target incluent la transmission de divers paramètres pour les informations contextuelles, les audiences et les recommandations de contenu.

Avec l’extension Target, tous les paramètres Target étaient transmis à l’aide de la fonction TargetParameters.

Avec l’extension Offer Decisioning and Target :

Paramètres personnalisés

Les paramètres de mbox personnalisés sont la méthode la plus simple pour transmettre des données à Target et peuvent être transmis dans les objets xdm ou data.__adobe.target.

Paramètres de profil

Les paramètres de profil stockent des données pendant une période prolongée dans le profil Target de l’utilisateur et doivent être transmis à l’objet data.__adobe.target.

Paramètres de l’entité

Les paramètres d’entité sont utilisés pour transmettre des données comportementales et des informations de catalogue supplémentaires pour Target Recommendations. Tout comme les paramètres de profil, la plupart des paramètres d’entité doivent être transmis sous l’objet data.__adobe.target. La seule exception est la présence du tableau xdm.productListItems, puis la première valeur SKU est utilisée comme entity.id.

Les paramètres d'entité pour un élément spécifique doivent être précédés de entity. pour une capture de données correcte. Les paramètres cartIds et excludedIds réservés aux algorithmes de recommandations ne doivent pas être précédés de préfixes et la valeur de chaque doit contenir une liste d’identifiants d’entité séparés par des virgules.

Paramètres d’achat

Les paramètres d’achat sont transmis sur une page de confirmation de commande après une commande réussie et sont utilisés pour les objectifs de conversion et d’optimisation de Target. Avec une implémentation de Platform Mobile SDK utilisant l’extension Offer Decisioning et Target, ces paramètres et sont automatiquement mappés à partir des données XDM transmises dans le cadre du groupe de champs commerce.

Les informations d’achat sont transmises à Target lorsque le groupe de champs commerce a purchases.value défini sur 1. L’ID de commande et le total de la commande sont automatiquement mappés à partir de l’objet order. Si le tableau productListItems est présent, les valeurs SKU sont utilisées pour la productPurchasedId.

Si vous ne transmettez pas commerce champs dans l’objet xdm, vous pouvez transmettre les détails de la commande à Target à l’aide des champs data.__adobe.target.orderId, data.__adobe.target.orderTotal et data.__adobe.target.productPurchasedId.

Identifiant client (mbox3rdPartyId)

Target permet de synchroniser les profils sur plusieurs appareils et systèmes à l’aide d’un seul identifiant client. Cet ID de client doit être transmis dans le champ identityMap de l’objet XDM et mappé au champ ID de tiers cible dans le flux de données.

Tableau

Exemples de transmission de paramètres

Prenons un exemple simple pour démontrer les différences entre les extensions lors de la transmission de paramètres à 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))

Ensuite, découvrez comment suivre les événements de conversion Target avec le SDK web de Platform.