以下為 iOS 資料庫所提供的 Adobe Target 方法清單。
SDK 目前已支援多個 Adobe Experience Cloud 解決方案,包括 Analytics、Target、Audience Manager 以及 Adobe Experience Platform Identity Service。各方法會根據解決方案加上前置詞。例如, 方法會加上前置詞 target
target。
生命週期量度會以參數形式傳送至各 mbox 負載。如需詳細資訊,請參閱生命週期量度。如果您是在 didFinishLaunching
委派方法內傳送 Target 要求,請在 Target 實施程式碼之前新增 [ADBMobile trackAction:data:]
或 [ADBMobile trackState:data:]
呼叫。如此一來,Target 要求就會包含完整的生命週期資料。
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
}];
targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mbox參數:requestLocationParameters:回調:
傳送要求至您設定的 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/位置名稱。
defaultContent
如果 Target 伺服器無法連線或使用者不符合促銷活動資格,則將會在回撥中傳回值。
profileParameters
此字典中的值會根據 Target 要求進入「profileParameters」物件。
orderParameters
此字典中的值會根據 Target 要求進入「order」物件。
mboxParameters
此字典中的值會根據 Target 要求進入「mboxParameters」物件。
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];
}];
有關基礎目標API的詳細資訊,請參見 目標API引用。
targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:回調
傳送要求至您設定的 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];
}];