預先擷取 Android 中的選件內容

Adobe Target 預先擷取功能使用 Android Mobile SDK，透過快取伺服器回應，盡量以最少次數擷取提供項目內容。

此程式可縮短載入時間、防止多個網路呼叫，並讓Adobe Target得到行動應用程式使用者瀏覽哪個mbox的通知。 在預回遷呼叫期間，將會擷取和快取所有內容，而且會從快取中擷取此內容，以供日後所有呼叫使用，這些呼叫包含指定mbox名稱的快取內容。

預先擷取內容不會在跨啟動之間持續有效。只要應用程式仍然存在，或直到呼叫 clearPrefetchCache() 方法為止，則會快取預先擷取內容。

在 SDK 4.14 或更新版本中，若要指定 ，啟動 v2 批次 mbox TnT 呼叫時，系統會從 檔案中挑選 environmentId ADBMobileConfig.jsonenvironmentId。若未指定此檔案中的 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 中支援預先擷取的公用類別:

類別參考: TargetPrefetchObject

封裝用於 mbox 預先擷取的 mbox 名稱和參數。

• name

  將預先擷取的位置名稱。

  • 類型: 字串

• mboxParameters

  將針對此 mboxParameters 要求附加作為 TargetPrefetchObject 的鍵值值組集合。

  • 類型: 對應 <String, Object>

• orderParameters

  將附加至 order 節點下目前 mbox 的鍵值值組集合。

  • 類型: 對應 <String, Object>

• productParameters

  將附加至 product 節點下目前 mbox 的鍵值值組集合。

  • 類型: 對應 <String, Object>

類別參考: TargetRequestObject

此類別封裝 mbox 名稱、預設內容、mbox 參數，以及用於 Target 位置要求的傳回回撥。

• mboxName

  要求位置的名稱。

  • 類型: 字串

• mboxParameters

  將針對此 mboxParameters 附加作為 TargetRequestObject 的鍵值值組集合。

  • 類型：對應<String, Object>

• orderParameters

  將附加至 order 節點下目前 mbox 的鍵值值組集合。

  • 類型: 對應 <String, Object>

• productParameters

  將附加至 product 節點下目前 mbox 的鍵值值組集合。

  • 類型: 對應 <String, Object>

• defaultContent

  如果 SDK 無法從 Target 伺服器擷取內容，在回撥中傳回的字串值。

  • 類型: 字串

• callback

  當指定的 TargetRequestObject 內容為可用狀態時，將呼叫函式指標。

  • 類型: Target.TargetCallback<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。