Show Menu
主題×

建立 JSON 選件

在選件資料庫中建立 JSON 選件,以用於表單式體驗撰寫器。
JSON 選件可用於表單式活動中,藉以啟用使用案例,此時 Target 需要決定以 JSON 格式傳送選件,供 SPA 架構或伺服器端整合取用。
使用 JSON 選件時,請考量下列資訊:
  • JSON 選件目前只可用於 AB 和 XT 活動。
  • JSON 選件只能用在表單式活動中。
  • 當您使用「伺服器端 API」、「行動裝置 SDK」或 NodeJS SDK 時,可直接擷取 JSON 選件。
  • 在瀏覽器中,「只能」透過 at.js 1.2.3 (或更新版) 和以下方法擷取 JSON 選項: 使用  getOffer() ,需利用 setJson 動作來篩選動作。
  • JSON 選件是以原生 JSON 物件提供,而不是字串。這些物件的取用者不再需要將物件當作字串來處理,再轉換成 JSON 物件。
  • 不同於其他選件 (例如 HTML 選件),JSON 選件不會自動套用,因為 JSON 選件不是視覺化選件。開發人員必須撰寫程式碼來明確利用此方法取得選件:  getOffer()
  • 使用 mbox.js 時不支援 JSON 選件。

建立 JSON 選件

  1. 按一下​ 「選件」 ,然後選取​**「代碼選件」]索引標籤。[**
  2. 按一下​ 「建立 > JSON 選件 」。
  3. 輸入選件名稱。
  4. 在​ 「程式碼」方塊中,輸入或貼上 JSON 程式碼。
  5. 按一下​ 「儲存」

範例

只有在使用表單式體驗撰寫器建立的活動中才支援 JSON 選件。目前只有透過直接呼叫 API 才能使用 JSON 選件。
其範例如下:
adobe.target.getOffer({ 
  mbox: "some-mbox", 
  success: function(actions) { 
    console.log('Success', actions); 
  }, 
  error: function(status, error) { 
    console.log('Error', status, error); 
  } 
});

傳給成功回呼的動作是物件陣列。假設有單一 JSON 選件,其內容為:
{ 
  "demo": {"a": 1, "b": 2} 
}

動作陣列會有此結構:
[ 
 { 
   action: "setJson", 
   content: [{ 
     "demo": {"a": 1, "b": 2} 
   }] 
 }  
]

若要擷取 JSON 選件,請逐一查看動作,尋找含有 setJson 動作的動作,然後查一查看內容陣列。

使用案例

假設下列 JSON 選件傳送至您的網頁:
{ 
    "_id": "5a65d24d8fafc966921e9169", 
    "index": 0, 
    "guid": "7c006504-c6f7-468d-a46f-f72531ea454c", 
    "isActive": true, 
    "balance": "$2,075.06", 
    "picture": "https://placehold.it/32x32", 
    "tags": [ 
      "esse", 
      "commodo", 
      "excepteur", 
    ], 
    "friends": [ 
      { 
        "id": 0, 
        "name": "Carla Lyons" 
      }, 
      { 
        "id": 1, 
        "name": "Ollie Mooney" 
      }, 
    ], 
    "greeting": "Hello, Stephenson Fernandez! You have 4 unread messages.", 
    "favoriteFruit": "strawberry" 
} 
  

下列程式碼顯示如何存取「greeting」屬性:
adobe.target.getOffer({   
  "mbox": "name_of_mbox", 
  "params": {}, 
  "success": function(offer) {           
        console.log(offer[0].content[0].greeting); 
  },   
  "error": function(status, error) {           
      console.log('Error', status, error); 
  } 
});

依 JSON 選件類型來篩選選件

您可以按一下​ 「類型」 ​下拉式清單,然後選取 **JSON]核取方塊,依 JSON 選件類型來篩選「選件資料庫」。[**