適用於 iOS 的 Target 方法
以下為 iOS 資料庫所提供的 Adobe Target 方法清單。
SDK 目前已支援多個 Adobe Experience Cloud 解決方案，包括 Analytics、Target、Audience Manager 以及 Adobe Experience Platform Identity Service。各方法會根據解決方案加上前置詞。例如， 方法會加上前置詞 targettarget。
生命週期量度會以參數形式傳送至各 mbox 負載。如需詳細資訊，請參閱生命週期量度。如果您是在 didFinishLaunching 委派方法內傳送 Target 要求，請在 Target 實施程式碼之前新增 [ADBMobile trackAction:data:] 或 [ADBMobile trackState:data:] 呼叫。如此一來，Target 要求就會包含完整的生命週期資料。
類別參考：ADBTargetLocationRequest
屬性
NSString *name;
NSString *defaultContent;
NSMutableDictionary *parameters;
字串常數
下列常數可方便您針對自訂參數設定索引鍵。
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;
方法
-
targetLoadRequest:callback
傳送要求至您設定的 Target 伺服器並傳回區塊
callback中產生之選件的字串值。-
此方法的語法如下：
+ (void) targetLoadRequest:(ADBTargetLocationRequest *)request callback:(void (^)(NSString *content))callback; -
此方法的程式碼範例如下：
[ADBMobile targetLoadRequest:myRequest callback:^(NSString *content) { // do something with content }];
-
-
:defaultContent::orderParameters::requestLocationParameters:targetLoadRequestWithNameprofileParametersmboxParameterscallback:
傳送要求至您設定的 Target 伺服器並傳回區塊回撥中產生之選件的字串值。
-
此方法的語法如下：
+ (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; -
傳回：N/A
-
以下是此方法的參數：
-
name您要擷取的 Target mbox/位置名稱。
- 類型：NSString*
-
defaultContent如果 Target 伺服器無法連線或使用者不符合促銷活動資格，則將會在回撥中傳回值。
- 類型：NSString*
-
profileParameters此字典中的值會根據 Target 要求進入「profileParameters」物件。
- 類型：NSDictionary*
-
orderParameters此字典中的值會根據 Target 要求進入「order」物件。
- 類型：NSDictionary
-
mboxParameters此字典中的值會根據 Target 要求進入「mboxParameters」物件。
- 類型：NSDictionary*
-
requestLocationParameters此字典中的值會根據 Target 要求進入「requestLocation」物件。
類型：NSDictionary*
-
callback此方法將會與 Target 伺服器中的選件內容一併接受呼叫。如果 Target 伺服器無法連線，或使用者不符合促銷活動資格，則將會傳回 defaultContent。
類型：函式
-
-
此方法的範例程式碼如下：
[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]; }];如需底層Target API的詳細資訊，請參閱Target API參考。
-
-
:defaultContent::orderParameters:targetLoadRequestWithNameprofileParametersmboxParameters:callback
傳送要求至您設定的 Target 伺服器，並傳回區塊回撥中產生之選件的字串值。
-
此方法的語法如下：
+ (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; -
此方法的範例程式碼如下：
[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
建立
ADBTargetLocationRequest。-
此方法的語法如下：
+ (ADBTargetLocationRequest *) targetCreateOrderConfirmRequestWithName:(NSString *)name orderId:(NSString *)orderId orderTotal:(NSString *)orderTotal productPurchasedId:(NSString *)productPurchasedId parameters:(NSDictionary *)parameters;
-
-
targetCreateRequestWithName:defaultContent:parameters
方便讓建構函式使用指定的參數來建立 ADBTargetLocationRequest 物件。
-
此方法的語法如下：
+ (ADBTargetLocationRequest *) targetCreateRequestWithName:(NSString *)name defaultContent:(NSString *)defaultContent parameters:(NSDictionary *)parameters; -
此方法的範例程式碼如下：
ADBTargetLocationRequest *myRequest = [ADBMobile targetCreateRequestWithName:@"heroBanner" defaultContent:@"default.png" parameters:nil];
-
-
targetThirdPartyID
傳回第三方 ID。
-
此方法的語法如下：
+ (nullable NSString *) targetThirdPartyID; -
此方法的範例程式碼如下：
NSString *thirdPartyId = [ADBMobile targetThirdPartyID];
-
-
targetSetThirdPartyID
設定第三方 ID。
-
此方法的語法如下：
+ (void) targetSetThirdPartyID:(nullable NSString *)thirdPartyID; -
此方法的範例程式碼如下：
[ADBMobile targetSetThirdPartyID:@"thirdPartyID"];
-
-
targetClearCookies
清除應用程式中的目標 Cookie。
秘訣由於使用 SDK 4.10.0 版，因此 Target 不再使用 Cookie。此方法會重設 thirdPartyID 和 sessionID。
-
此方法的語法如下：
+ (void) targetClearCookies; -
此方法的範例程式碼如下：
[ADBMobile targetClearCookies];
-
-
targetPcID
傳回 PcID。
-
此方法的語法如下：
+ (nullable NSString *) targetPcID; -
此方法的範例程式碼如下：
NSString *myTargetPcID = [ADBMobile targetPcID];
-
-
targetSessionID
傳回 SessionID。
-
此方法的語法如下：
+ (nullable NSString *) targetPcID; -
此方法的範例程式碼如下：
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];
}];
