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.

SUGGERIMENTO

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

SUGGERIMENTO

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;
IMPORTANTE
  • 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
                          }];
      
  • :defaultContent::orderParameters::requestLocationParameters:targetLoadRequestWithNameProfileParametersBoxParametersScalabilità:

    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 Riferimento API di Target.

  • :defaultContent::orderParameters:targetLoadRequestWithNameProfileParametersboxParameters: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.

    SUGGERIMENTO

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

In questa pagina