adobe.target.getOffer(options)

最後更新： 2024年7月20日
  • 主題：

建立對象：

  • undefined

此函式會引發要求以取得Target選件。

搭配使用 adobe.target.applyOffer() 來處理回應或使用您自己的成功處理。options 參數是強制性的，並且具有下列結構:

索引鍵類型必要說明
mbox字串是Mbox 名稱
params物件無

mbox 參數.機碼/值組的物件具有下列結構:

{ "param1": "value1", "param2": "value2"}

success函數是

收到來自伺服器的回應時要執行的回呼。success 回呼函數將接收代表選件物件陣列的單一參數。以下是success回呼範例：

function handleSuccess(response){......}

請參閱以下的「回應」以取得詳細資料。

error函數是

遇到錯誤時要執行的回呼。有一些案例會被視為錯誤:

  • HTTP 狀態代碼與 200 OK 不同
  • 無法剖析回應。例如，我們拙劣地建構了 JSON 或 HTML 而非 JSON。
  • 回應包括 "error" 索引鍵。例如，在 Edge 上擲出了例外，無法正確處理要求。當 mbox 遭到封鎖，我們無法擷取任何內容時，便可能出現錯誤，諸如此類情況。error 回呼函數將收到兩個參數: status 和 error。以下是錯誤回呼範例： function handleError(status, error){......}

請參閱以下的「錯誤回應」以取得詳細資料。

timeout數字無

逾時，以毫秒為單位。如果未指定，將使用 at.js 中的預設逾時。

可在Administration > Implementation底下的Target UI中設定預設逾時。

範例

正在使用getOffer()新增引數並使用applyOffer()進行成功處理：

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "params": {
     "a": 1,
     "b": 2
  },
  "success": function(offer) {
        adobe.target.applyOffer( {
           "mbox": "target-global-mbox",
           "offer": offer
        } );
  },
  "error": function(status, error) {
      console.log('Error', status, error);
  }
});

正在新增引數及設定檔引數與getOffer()，並使用applyOffer()進行成功處理：

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "params": {
     "a": 1,
     "b": 2,
     "profile.age": 27,
     "profile.gender": "male"
  },
  "success": function(offer) {
        adobe.target.applyOffer( {
           "mbox": "target-global-mbox",
           "offer": offer
        } );
  },
  "error": function(status, error) {
      console.log('Error', status, error);
  }
});

搭配getOffer()使用自訂逾時和自訂成功處理：

"YOUR_OWN_CUSTOM_HANDLING_FUNCTION" 客戶會定義的函數之預留位置。

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "success": function(offer) {
    YOUR_OWN_CUSTOM_HANDLING_FUNCTION(offer);
  },
  "error": function(status, error) {
    console.log('Error', status, error);
  },
  "timeout": 2000
});