Show Menu
ARGOMENTI×

Metodi di destinazione per iOS

Elenco dei metodi di Adobe Target forniti dalla libreria iOS.
L'SDK supporta attualmente più soluzioni Adobe Experience Cloud, tra cui Analytics, Target, Audience Manager e il servizio Adobe Experience Platform Identity. Ai metodi è applicato il prefisso della relativa soluzione. Ad esempio, i metodi di hanno il prefisso target target.
Le metriche del ciclo di vita sono inviate come parametri a ciascun caricamento Mbox. Per ulteriori informazioni, vedi Metriche del ciclo di vita . Se invii richieste Target all'interno del metodo didFinishLaunching delegate, aggiungi un [ADBMobile trackAction:data:] o una chiamata [ADBMobile trackState:data:] prima del codice di implementazione di Target. In questo modo, le richieste Target conterranno tutti i dati del ciclo di vita.

Guida di riferimento della classe ADBTargetLocationRequest

Proprietà

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

Costanti di stringa

Le seguenti costanti di stringa offrono facilità di utilizzo quando imposti le chiavi per i parametri personalizzati.
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;

  • Se utilizzi gli SDK precedenti alla versione 4.14.0, consulta Parametri di input per conoscere le limitazioni relative ai parametri.
  • Se utilizzi gli SDK versione 4.14.0 o successiva , consulta Parametri batch di input per conoscere le limitazioni relative ai parametri.

Metodi

  • targetLoadRequest:​callback
    Invia la richiesta al server di Target configurato e restituisce il valore della stringa dell'offerta generato in un blocco callback .
    • Di seguito è riportata la sintassi per questo metodo:
      + (void) targetLoadRequest:(ADBTargetLocationRequest *)request
                        callback:(void (^)(NSString *content))callback;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      [ADBMobile targetLoadRequest:myRequest
                          callback:^(NSString *content) {
                            // do something with content
                          }];
      
      
  • targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:requestLocationParameters:callback:
    Invia una richiesta al server di Target configurato e restituisce il valore stringa dell'offerta generata in una funzione callback di un blocco.
    • Di seguito è riportata la sintassi per questo metodo:
      + (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;
      
      
    • Restituisce: N/D
    • I parametri di questo metodo sono i seguenti:
      • name
        Nome dell'Mbox/posizione Target che desideri recuperare.
        • Tipo : NSString*
      • defaultContent
        Valore restituito nella callback se il server di Target non è raggiungibile, oppure se l'utente non è qualificato per la campagna.
        • Tipo : NSString*
      • profileParameters
        I valori in questo dizionario entrano nell'oggetto "profileParameters" nella richiesta a Target.
        • Tipo : NSDictionary*
      • orderParameters
        I valori in questo dizionario entrano nell'oggetto "order" nella richiesta a Target.
        • Tipo : NSDictionary
      • mboxParameters
        I valori in questo dizionario entrano nell'oggetto "mboxParameters" nella richiesta a Target.
        • Tipo : NSDictionary*
      • requestLocationParameters
        I valori in questo dizionario entrano nell'oggetto "requestLocation" nella richiesta a Target.
        Tipo : NSDictionary*
      • callback
        Questo metodo sarà chiamato con il contenuto dell'offerta dal server di Target. Se non è possibile accedere al server di Target o se l'utente non è idoneo per la campagna, viene restituito defaultContent. Tipo : Funzione
    • Di seguito è riportato un esempio di codice per questo metodo:
      [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];
                                 }];
      
      
      Per ulteriori informazioni sull'API Target sottostante, consulta Sviluppatori Adobe Target .
  • targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:callback
    Invia una richiesta al server di Target configurato e restituisce il valore stringa dell'offerta generata in un callback di un blocco.
    • Di seguito è riportata la sintassi per questo metodo:
      + (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;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      [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
    Crea una ADBTargetLocationRequest .
    • Di seguito è riportata la sintassi per questo metodo:
      + (ADBTargetLocationRequest *)
      targetCreateOrderConfirmRequestWithName:(NSString *)name
                                      orderId:(NSString *)orderId
                                  orderTotal:(NSString *)orderTotal
                          productPurchasedId:(NSString *)productPurchasedId
                              parameters:(NSDictionary *)parameters;
      
      
  • targetCreateRequestWithName:​​defaultContent:​parameters
    Costruttore di convenienza per creare un oggetto ADBTargetLocationRequest con i parametri indicati.
    • Di seguito è riportata la sintassi per questo metodo:
      + (ADBTargetLocationRequest *)
      targetCreateRequestWithName:(NSString *)name
                           defaultContent:(NSString *)defaultContent
                               parameters:(NSDictionary *)parameters;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      ADBTargetLocationRequest *myRequest =  
      [ADBMobile targetCreateRequestWithName:@"heroBanner"
                              defaultContent:@"default.png"
                                  parameters:nil];
      
      
  • targetThirdPartyID
    Restituisce l'ID di terze parti.
    • Di seguito è riportata la sintassi per questo metodo:
      + (nullable NSString *) targetThirdPartyID;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      NSString *thirdPartyId = [ADBMobile targetThirdPartyID];
      
      
  • targetSetThirdPartyID
    Imposta l'ID di terze parti.
    • Di seguito è riportata la sintassi per questo metodo:
      + (void) targetSetThirdPartyID:(nullable NSString *)thirdPartyID;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      [ADBMobile targetSetThirdPartyID:@"thirdPartyID"];
      
      
  • targetClearCookies
    Elimina tutti i cookie di Target dall'applicazione.
    A partire dalla versione 4.10.0 dell'SDK, Target non usa più i cookie. Questo metodo reimposta gli ID thirdPartyID e sessionID.
    • Di seguito è riportata la sintassi per questo metodo:
      + (void) targetClearCookies;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      [ADBMobile targetClearCookies];
      
      
  • targetPcID
    Restituisce il PcID.
    • Di seguito è riportata la sintassi per questo metodo:
      + (nullable NSString *) targetPcID;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      NSString *myTargetPcID = [ADBMobile targetPcID];
      
      
  • targetSessionID
    Restituisce l'ID SessionID.
    • Di seguito è riportata la sintassi per questo metodo:
      + (nullable NSString *) targetPcID;
      
      
    • Di seguito è riportato un esempio di codice per questo metodo:
      NSString *myTargetSessionID = [ADBMobile targetSessionID];
      
      

Esempio

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