Adobe Target 預先擷取功能使用 Android Mobile SDK,透過快取伺服器回應,盡量以最少次數擷取提供項目內容。
Android 版 Mobile SDK 中的預先擷取功能不支援 Adobe Target 中的自動指定目標、自動分配以及自動個人化活動類型。
此程式可縮短載入時間、防止多個網路呼叫,並讓Adobe Target得到行動應用程式使用者瀏覽哪個mbox的通知。 在預回遷呼叫期間,將會擷取和快取所有內容,而且會從快取中擷取此內容,以供日後所有呼叫使用,這些呼叫包含指定mbox名稱的快取內容。
預先擷取內容不會在跨啟動之間持續有效。只要應用程式仍然存在,或直到呼叫 clearPrefetchCache()
方法為止,則會快取預先擷取內容。
自 SDK 4.14.0 版開始,即可使用 Target 預先擷取 API。如需有關參數限制的詳細資訊,請參閱 Batch-input-parameters。
在 SDK 4.14 或更新版本中,若要指定 ,啟動 v2 批次 mbox TnT 呼叫時,系統會從 檔案中挑選 environmentId
ADBMobileConfig.json
environmentId。若未指定此檔案中的 environmentId
,系統就不會以 TNT 批次 mbox 呼叫傳送任何環境參數,而是為預設環境傳送選件。
例如:
if (MobileConfig.getInstance().mobileUsingTarget()){
long environmentID = MobileConfig.getInstance().getEnvironmentID();
if(environmentID != 0L){
parametersJson.put(TargetJson.ENVIRONMENT_ID, environmentID);
}
}
以下是您可以在 Android 中用於預先擷取的方法:
prefetchContent
將含有一連串位置的預先擷取要求傳送至設定的 Target 伺服器,並在提供的回撥中傳回要求狀態。
以下是此方法的語法:
public static void prefetchContent(
final List<TargetPrefetchObject> targetPrefetchArray,
final Map<String, Object> profileParameters,
final TargetCallback<Boolean> callback)
以下是此方法的參數:
targetPrefetchArray
TargetPrefetchObjects
陣列,包含每個要預先擷取之 Target 位置的名稱與 mboxParameters。
profileParameters
包含要與此要求中每個位置預先擷取搭配使用之設定檔參數的鍵值和值。
callBack
完成預先擷取時叫用。如果預先擷取成功,會傳回 true
,如果預先擷取失敗,則傳回 false
。
loadRequests
針對在要求陣列中指定的多個 mbox 位置執行批次要求。 陣列中的每個物件都包含回呼函式,當內容可用於其指定mbox位置時,就會呼叫該函式。
如果已快取要求位置的內容,則會在提供的回撥中立即傳回內容。否則,SDK 將會傳送網路要求給 Target 伺服器以擷取內容。
以下是此方法的語法:
public static void loadRequests( final List<TargetRequestObject> requestArray, final Map<String, Object> profileParameters)
以下是此方法的參數:
requestArray
TargetRequestObjects
陣列,包含要擷取之每個位置的名稱、預設內容、參數,以及回撥函式。
profileParameters
包含要與此要求中每個位置預先擷取搭配使用之設定檔參數的鍵值和值。
clearPrefetchCache
清除 Target 預先擷取快取的資料。
以下是此方法的語法:
public static void clearPrefetchCache();
沒有適用於此方法的參數。
createTargetRequestObject
使用提供的資料建立並傳回 TargetRequestObject
例項。
以下是此方法的語法:
public static TargetPrefetchObject createTargetRequestObject(
final String mboxName,
final String defaultContent,
final Map<String, Object> mboxParams,
final Map<String, Object> orderParams,
final Map<String, Object> productParams,
final Target.TargetCallback<String> callback)
createTargetPrefetchObject
使用提供的資料建立並傳回 TargetPrefetchObject 例項。
以下是此方法的語法:
public static TargetPrefetchObject createTargetPrefetchObject(
final String mboxName,
final Map<String, Object> mboxParams)
final Map<String, Object> orderParams,
final Map<String, Object> productParams)
以下是 Android 中支援預先擷取的公用類別:
封裝用於 mbox 預先擷取的 mbox 名稱和參數。
name
將預先擷取的位置名稱。
mboxParameters
將針對此 mboxParameters
要求附加作為 TargetPrefetchObject
的鍵值值組集合。
<String, Object>
orderParameters
將附加至 order 節點下目前 mbox 的鍵值值組集合。
<String, Object>
productParameters
將附加至 product 節點下目前 mbox 的鍵值值組集合。
<String, Object>
此類別封裝 mbox 名稱、預設內容、mbox 參數,以及用於 Target 位置要求的傳回回撥。
mboxName
要求位置的名稱。
mboxParameters
將針對此 mboxParameters
附加作為 TargetRequestObject
的鍵值值組集合。
<String, Object>
orderParameters
將附加至 order 節點下目前 mbox 的鍵值值組集合。
<String, Object>
productParameters
將附加至 product 節點下目前 mbox 的鍵值值組集合。
<String, Object>
defaultContent
如果 SDK 無法從 Target 伺服器擷取內容,在回撥中傳回的字串值。
callback
當指定的 TargetRequestObject
內容為可用狀態時,將呼叫函式指標。
<String>
以下是如何藉由使用 Android SDK 預先擷取內容的範例:
// When your app launches, prefetch the content for a list of locations.
// Define the list of mboxes that you want to prefetch.
List<TargetPrefetchObject> prefetchMboxesList = new ArrayList<>();
Map<String, Object> mboxParameters1 = new HashMap<>();
mboxParameters1.put("status", "platinum");
prefetchMboxesList.add(Target.createTargetPrefetchObject("mboxName1", mboxParameters1));
Map<String, Object> mboxParameters2 = new HashMap<>();
mboxParameters2.put("userType", "paid");
List<String> purchasedIds = new ArrayList<String>();
purchasedIds.add("34");
purchasedIds.add("125");
Map<String, Object> orderParameters2 = new HashMap<>();
orderParameters2.put("id", "ADCKKIM");
orderParameters2.put("total", "344.30");
orderParameters2.put("purchasedProductIds", purchasedIds);
Map<String, Object> productParameters2 = new HashMap<>();
productParameters2.put("id", "24D3412");
productParameters2.put("categoryId","Books");
prefetchMboxesList.add(Target.createTargetPrefetchObject("mboxName2", mboxParameters2, orderParameters2, productParameters2));
// Define the profile parameters map.
Map<String, Object> profileParameters = new HashMap<>();
profileParameters.put("ageGroup", "20-32");
// Define the target callback for the prefetch call status.
Target.TargetCallback<Boolean> prefetchStatusCallback = new Target.TargetCallback<Boolean>() {
@Override
public void call(final Boolean status) {
// check the returned status for the prefetch call
}};
// Call the prefetchContent API.
Target.prefetchContent(prefetchMboxesList, profileParameters, prefetchStatusCallback);
// When the content is required, you can initiate the locations request.
// Define the list of target request objects.
List<TargetRequestObject> locationRequests = new ArrayList<>();
Target.TargetCallback<String> callback1 = new Target.TargetCallback<String>() {
@Override
public void call(final String content) {
// check the returned content for mboxName1.
}};
locationRequests.add(Target.createTargetRequestObject("mboxName1", "defaultContent1", mboxParameters1, callback1));
Target.TargetCallback<String> callback2 = new Target.TargetCallback<String>() {
@Override
public void call(final String content) {
// check the returned content for mboxName2.
}};
locationRequests.add(Target.createTargetRequestObject("mboxName2", "defaultContent2", mboxParameters2, orderParameters2, productParameters2, callback2));
// Call the loadRequests API.
Target.loadRequests(locationRequests, profileParameters);
以下是關於這些範例的部分其他資訊:
ProductParameters
僅允許下列鍵值:
id
categoryId
OrderParameters
僅允許下列鍵值:
id
total
purchasedProductIds
purchasedProducts
接受字串的 ArrayList。