Méthodes de ciblage pour iOS

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.

CONSEIL

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.

Référence de classe : ADBTargetLocationRequest

Propriétés

NSString *name; 
NSString *defaultContent; 
NSMutableDictionary *parameters;

Constantes de chaîne

CONSEIL

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;
IMPORTANT

  • 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.

Méthodes

  • 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
                    }];

  • :defaultContent::orderParameters::requestLocationParameters:targetLoadRequestWithNameprofileParametersmboxParameterscallback:

    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.

        • Type : NSString*

      • 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.

        • Type : NSString*

      • profileParameters

        Les valeurs de ce dictionnaire seront placées dans l’objet "profileParameters" dans la demande à Target.

        • Type : NSDictionary*

      • orderParameters

        Les valeurs de ce dictionnaire seront placées dans l’objet "order" dans la demande à Target.

        • Type : NSDictionary

      • mboxParameters

        Les valeurs de ce dictionnaire seront placées dans l’objet "mboxParameters" dans la demande à Target.

        • Type : NSDictionary*

      • 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-jacente, voir Référence de l’API Target.

  • :defaultContent::orderParameters:targetLoadRequestWithNameprofileParametersmboxParameters: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 
                           }
                         }];

  • targetCreateOrder​ConfirmRequestWithName:​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.

    CONSEIL

    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];

Exemple

// 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];
                    }];

Sur cette page