Cette section répertorie les méthodes Adobe Target fournies par la bibliothèque iOS.
Le SDK prend actuellement en charge plusieurs solutions Adobe Experience Cloud, notamment Analytics, Target, Audience Manager, ainsi que le service d’identification Adobe Experience Platform. Un préfixe est ajouté aux méthodes selon la solution. Par exemple, les méthodes sont précédées du préfixe target
target.
Les mesures de cycle de vie sont envoyées sous la forme de paramètres à chaque chargement de mbox. Pour en savoir plus, voir la section Mesures de cycle de vie. Si vous envoyez des requêtes Target dans la méthode didFinishLaunching
déléguée, ajoutez un appel [ADBMobile trackAction:data:]
ou [ADBMobile trackState:data:]
avant le code de mise en œuvre Target. Ainsi, les requêtes Target contiennent les données de cycle de vie complètes.
NSString *name;
NSString *defaultContent;
NSMutableDictionary *parameters;
Les constantes suivantes facilitent la définition des clés pour les paramètres personnalisés.
NSString *const ADBTargetParameterOrderId;
NSString *const ADBTargetParameterOrderTotal;
NSString *const ADBTargetParameterProductPurchasedId;
NSString *const ADBTargetParameterCategoryId;
NSString *const ADBTargetParameterMbox3rdPartyId;
NSString *const ADBTargetParameterMboxPageValue;
NSString *const ADBTargetParameterMboxPc;
NSString *const ADBTargetParameterMboxSessionId;
NSString *const ADBTargetParameterMboxHost;
Si vous utilisez un SDK antérieur à la version 4.14.0, voir Paramètres d’entrée pour les restrictions des paramètres.
Si vous utilisez un SDK version 4.14.0 ou version supérieure, voir Paramètres d’entrée de lot pour les restrictions des paramètres.
targetLoadRequest:callback
Envoie request au serveur Target configuré et renvoie la valeur de chaîne de l’offre générée dans un bloc callback
.
Voici la syntaxe de cette méthode :
+ (void) targetLoadRequest:(ADBTargetLocationRequest *)request
callback:(void (^)(NSString *content))callback;
Voici l’exemple de code pour cette méthode :
[ADBMobile targetLoadRequest:myRequest
callback:^(NSString *content) {
// do something with content
}];
targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:requestLocationParameters:callback:
Envoie la demande à votre serveur Target configuré et renvoie la valeur de chaîne de l’offre générée dans un rappel de bloc.
Voici la syntaxe de cette méthode :
+ (void) targetLoadRequestWithName:(nullable NSString *)name
defaultContent:(nullable NSString *)defaultContent
profileParameters:(nullable NSDictionary *)profileParameters
orderParameters:(nullable NSDictionary *)orderParameters
mboxParameters:(nullable NSDictionary *)mboxParameters
requestLocationParameters:(nullable NSDictionary *)requestLocationParameters
callback:(nullable void (^)(NSString
* __nullable content))callback;
Renvoie : S/O
Voici les paramètres pour cette méthode :
name
Nom de la mbox/l’emplacement Target que vous voulez récupérer.
defaultContent
Valeur renvoyée dans le rappel si le serveur Target n’est pas accessible ou si l’utilisateur n’est pas admissible pour la campagne.
profileParameters
Les valeurs de ce dictionnaire seront placées dans l’objet "profileParameters" dans la demande à Target.
orderParameters
Les valeurs de ce dictionnaire seront placées dans l’objet "order" dans la demande à Target.
mboxParameters
Les valeurs de ce dictionnaire seront placées dans l’objet "mboxParameters" dans la demande à Target.
requestLocationParameters
Les valeurs de ce dictionnaire seront placées dans l’objet "requestLocation" dans la demande à Target.
Type : NSDictionary*
callback
Cette méthode est appelée avec le contenu de l’offre depuis le serveur Target. Lorsque le serveur Target est inaccessible ou que l’utilisateur ne répond pas aux critères de la campagne, defaultContent est renvoyé.
Type : fonction
Voici l’exemple de code pour cette méthode :
[ADBMobile targetLoadRequestWithName:@"myHeroBanner"
defaultContent:@"defaultHeroBanner.png"
profileParameters:@{@"age":@"20-29"}
orderParameters:nil
mboxParameters:@{@"customParam":@"customValue"}
requestLocationParameters:@{@"host":@"my.hostname.com"}
callback:^(NSString *content){
// do something with content
myImageView.image = [UIImage imageNamed:content];
}];
Pour plus d’informations sur l’API Target sous-jacent, voir Développeurs Adobe Target.
targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:callback
Envoie request à votre serveur Target configuré et renvoie la valeur de chaîne de l’offre générée dans un rappel de bloc.
Voici la syntaxe de cette méthode :
+ (void) targetLoadRequestWithName:(nullable NSString *)name
defaultContent:(nullable NSString *)defaultContent
profileParameters:(nullable NSDictionary *)profileParameters
orderParameters:(nullable NSDictionary *)orderParameters
mboxParameters:(nullable NSDictionary *)mboxParameters
callback:(nullable void (^)(NSString * __nullable content))callback;
Voici l’exemple de code pour cette méthode :
[ADBMobile targetLoadRequestWithName:@"mboxName"
defaultContent:@"defaultContent"
profileParameters:{@"profile-parameter-key": @"profile-parameter-value"}
orderParameters:@{@"order-parameter-key": @"order-parameter-value"}
mboxParameters:@{@"mbox-parameter-key": @"mbox-parameter-value"}
callback:^(NSString * content) {
//do something with content
}
}];
targetCreateOrderConfirmRequestWithName:orderId:orderTotal:productPurchasedId:parameters
Crée une ADBTargetLocationRequest
.
Voici la syntaxe de cette méthode :
+ (ADBTargetLocationRequest *)
targetCreateOrderConfirmRequestWithName:(NSString *)name
orderId:(NSString *)orderId
orderTotal:(NSString *)orderTotal
productPurchasedId:(NSString *)productPurchasedId
parameters:(NSDictionary *)parameters;
targetCreateRequestWithName:defaultContent:parameters
Constructeur de commodité permettant de créer un objet ADBTargetLocationRequest avec les paramètres donnés.
Voici la syntaxe de cette méthode :
+ (ADBTargetLocationRequest *)
targetCreateRequestWithName:(NSString *)name
defaultContent:(NSString *)defaultContent
parameters:(NSDictionary *)parameters;
Voici l’exemple de code pour cette méthode :
ADBTargetLocationRequest *myRequest =
[ADBMobile targetCreateRequestWithName:@"heroBanner"
defaultContent:@"default.png"
parameters:nil];
targetThirdPartyID
Renvoie l’identifiant tiers.
Voici la syntaxe de cette méthode :
+ (nullable NSString *) targetThirdPartyID;
Voici l’exemple de code pour cette méthode :
NSString *thirdPartyId = [ADBMobile targetThirdPartyID];
targetSetThirdPartyID
Définit l’identifiant tiers.
Voici la syntaxe de cette méthode :
+ (void) targetSetThirdPartyID:(nullable NSString *)thirdPartyID;
Voici l’exemple de code pour cette méthode :
[ADBMobile targetSetThirdPartyID:@"thirdPartyID"];
targetClearCookies
Efface les cookies de ciblage de l’application.
Depuis la version 4.10.0 du SDK, Target n’utilise plus les cookies. Cette méthode permet de réinitialiser thirdPartyID et sessionID.
Voici la syntaxe de cette méthode :
+ (void) targetClearCookies;
Voici l’exemple de code pour cette méthode :
[ADBMobile targetClearCookies];
targetPcID
Renvoie le PcID.
Voici la syntaxe de cette méthode :
+ (nullable NSString *) targetPcID;
Voici l’exemple de code pour cette méthode :
NSString *myTargetPcID = [ADBMobile targetPcID];
targetSessionID
Renvoie SessionID.
Voici la syntaxe de cette méthode :
+ (nullable NSString *) targetPcID;
Voici l’exemple de code pour cette méthode :
NSString *myTargetSessionID = [ADBMobile targetSessionID];
// make your request
ADBTargetLocationRequest *myRequest =
[ADBMobile targetCreateRequestWithName:@"heroBanner"
defaultContent:@"default.png"
parameters:nil];
// load your request
[ADBMobile targetLoadRequest:myRequest
callback:^(NSString *content) {
// do something with content
heroImage.image = [UIImage imageNamed:content];
}];