開始使用Target SDK

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined

為了啟動並執行，我們鼓勵您以您選擇的語言建立您的第一個裝置上決策功能標幟活動：

Node.js
Java
.NET
Python

步驟摘要

為您的組織啟用裝置上決策
安裝SDK
初始化SDK
在Adobe Target A/B Test活動中設定功能標幟
在您的應用程式中實作及演算功能
實施應用程式中事件的追蹤
啟用您的A/B Test活動

1.為您的組織啟用裝置上決策

啟用裝置上決策可確保在幾乎零延遲的情況下執行A/B Test活動。若要啟用此功能，請瀏覽至「Administration > Implementation > Account details」並啟用「On-Device Decisioning」切換按鈕。

替代影像

NOTE

您必須擁有 Admin 或 Approver 使用者角色，才能啟用或停用 On-Device Decisioning 切換功能。

啟用 On-Device Decisioning 切換後，Adobe Target會開始為您的使用者端產生規則成品。

2.安裝SDK

對於Node.js、Java和Python，請在終端機的專案目錄中執行以下命令。針對.NET，請由從NuGet安裝以將其新增為相依性。

Node.js (NPM)

npm i @adobe/target-nodejs-sdk -P

Java (Maven)

<dependency>
   <groupId>com.adobe.target</groupId>
   <artifactId>java-sdk</artifactId>
   <version>2.0</version>
</dependency>

.NET (Bash)

dotnet add package Adobe.Target.Client

Python (pip)

pip install target-python-sdk

3.初始化SDK

規則成品會在SDK初始化步驟期間下載。您可以自訂初始化步驟，以決定如何下載及使用成品。

Node.js

const TargetClient = require("@adobe/target-nodejs-sdk");

const CONFIG = {
   client: "<your target client code>",
   organizationId: "your EC org id",
   decisioningMethod: "on-device",
   events: {
      clientReady: targetClientReady
      }
};

const tClient = TargetClient.create(CONFIG);

function targetClientReady() {
   //Adobe Target SDK has now downloaded the JSON artifact locally, which contains the activity details.
   //We will see how to use the artifact here very soon.
}

Java (Maven)

ClientConfig config = ClientConfig.builder()
   .client("testClient")
   .organizationId("ABCDEF012345677890ABCDEF0@AdobeOrg")
   .build();
TargetClient targetClient = TargetClient.create(config);

.NET (C#)

var targetClientConfig = new TargetClientConfig.Builder("testClient", "ABCDEF012345677890ABCDEF0@AdobeOrg")
   .Build();
this.targetClient.Initialize(targetClientConfig);

Python

from target_python_sdk import TargetClient

def target_client_ready():
   # Adobe Target SDK has now downloaded the JSON artifact locally, which contains the activity details.
   # We will see how to use the artifact here very soon.

CONFIG = {
   "client": "<your target client code>",
   "organization_id": "your EC org id",
   "decisioning_method": "on-device",
   "events": {
      "client_ready": target_client_ready
   }
}

target_client = TargetClient.create(CONFIG)

4.在Adobe Target A/B Test活動中設定功能標幟

在Target中，導覽至 Activities 頁面，然後選取 Create Activity > A/B test。
在 Create A/B Test Activity 強制回應視窗中，保留預設的Web選項為已選取(1)、選取 Form 作為您的體驗撰寫器(2)、選取具有 No Property Restrictions(3)的 Default Workspace，然後按一下 Next (4)。
在活動建立的 Experiences 步驟中，提供活動的名稱(1)並新增第二個體驗，體驗B，方法是按一下 Add Experience (2)。輸入您選擇的地點名稱(3)。例如，ondevice-featureflag或homepage-addtocart-featureflag是表示功能標幟測試目的地的位置名稱。在下列範例中，ondevice-featureflag是為體驗B定義的位置。您可以選擇新增對象細分(4)，以限制活動的資格。
在相同頁面的 CONTENT 區段中，選取下拉式清單(1)中的 Create JSON Offer，如圖所示。
在出現的 JSON Data 文字方塊中，使用有效的JSON物件(2)為每個體驗(1)輸入您的功能標幟變數。

輸入體驗A的功能標幟變數。

（以上體驗A的範例JSON）
{ "enabled" : true, "flag" : "expA" }
輸入體驗B的功能標幟變數。

（體驗B的範例JSON，以上）
{ "enabled" : true, "flag" : "expB" }
按一下 Next (1)以進入建立活動的 Targeting 步驟。
在下方所示的 Targeting 步驟範例中，為了簡單起見，「對象鎖定目標」(2)會維持在「所有訪客」的預設集。這表示活動未定位。不過，附註Adobe建議您一律將目標定位為生產活動的對象。按一下 Next (3)以進入建立活動的 Goals & Settings 步驟。
在 Goals & Settings 步驟中，將 Reporting Source 設為 Adobe Target (1)。將 Goal Metric 定義為 Conversion，根據您網站的轉換量度(2)指定詳細資料。按一下 Save & Close (3)以儲存活動。

5.在您的應用程式中實作及呈現功能

在Target中設定功能標幟變數後，請修改您的應用程式程式碼以使用這些變數。例如，在應用程式中取得功能標幟後，您可使用它來啟用功能並轉譯訪客符合資格的體驗。

Node.js

//... Code removed for brevity

let featureFlags = {};

function targetClientReady() {
   tClient.getAttributes(["ondevice-featureflag"]).then(function(response) {
      const featureFlags = response.asObject("ondevice-featureflag");
      if(featureFlags.enabled && featureFlags.flag !== "expA") { //Assuming "expA" is control
         console.log("Render alternate experience" + featureFlags.flag);
      }
      else {
         console.log("Render default experience");
      }
   });
}

Java (Maven)

MboxRequest mbox = new MboxRequest().name("ondevice-featureflag").index(0);
TargetDeliveryRequest request = TargetDeliveryRequest.builder()
   .context(new Context().channel(ChannelType.WEB))
   .execute(new ExecuteRequest().mboxes(Arrays.asList(mbox)))
   .build();
Attributes attributes = targetClient.getAttributes(request, "ondevice-featureflag");
String flag = attributes.getString("ondevice-featureflag", "flag");

.NET (C#)

var mbox = new MboxRequest(index: 0, name: "ondevice-featureflag");
var deliveryRequest = new TargetDeliveryRequest.Builder()
   .SetContext(new Context(ChannelType.Web))
   .SetExecute(new ExecuteRequest(mboxes: new List<MboxRequest> { mbox }))
   .Build();
var attributes = targetClient.GetAttributes(request, "ondevice-featureflag");
var flag = attributes.GetString("ondevice-featureflag", "flag");

Python

# ... Code removed for brevity

feature_flags = {}

def target_client_ready():
   attribute_provider = target_client.get_attributes(["ondevice-featureflag"])
   feature_flags = attribute_provider.as_object(mbox_name="ondevice-featureflag")
   if feature_flags.get("enabled") and feature_flags.get("flag") != "expA": # Assuming "expA" is control
      print("Render alternate experience {}".format(feature_flags.get("flag")))
   else:
      print("Render default experience")

6.針對應用程式中的事件實作其他追蹤

您可以選擇使用sendNotification()函式傳送額外的事件以追蹤轉換。

Node.js

//... Code removed for brevity

//When a conversion happens
TargetClient.sendNotifications({
   targetCookie,
   "request" : {
      "notifications" : [
      {
         type: "display",
         timestamp : Date.now(),
         id: "conversion",
         mbox : {
            name : "orderConfirm"
         },
         order : {
            id: "BR9389",
            total : 98.93,
            purchasedProductIds : ["J9393", "3DJJ3"]
         }
      }
      ]
   }
})

Java (Maven)

Notification notification = new Notification();
notification.setId("conversion");
notification.setImpressionId(UUID.randomUUID().toString());
notification.setType(MetricType.DISPLAY);
notification.setTimestamp(System.currentTimeMillis());
Order order = new Order("BR9389");
order.total(98.93);
order.purchasedProductIds(["J9393", "3DJJ3"]);
notification.setOrder(order);

TargetDeliveryRequest notificationRequest =
   TargetDeliveryRequest.builder()
      .context(new Context().channel(ChannelType.WEB))
      .notifications(Collections.singletonList(notification))
      .build();

NotificationDeliveryService notificationDeliveryService = new NotificationDeliveryService();
notificationDeliveryService.sendNotification(notificationRequest);

.NET (C#)

var order = new Order
{
   Id = "BR9389",
   Total = 98.93M,
   PurchasedProductIds = new List<string> { "J9393", "3DJJ3" },
};

var notification = new Notification
{
   Id = "conversion",
   ImpressionId = Guid.NewGuid().ToString(),
   Type = MetricType.Display,
   Timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
   Order = order,
};

var notificationRequest = new TargetDeliveryRequest.Builder()
   .SetContext(new Context(ChannelType.Web))
   .SetNotifications(new List<Notification> {notification})
   .Build();

targetClient.SendNotifications(notificationRequest);

Python

# ... Code removed for brevity

# When a conversion happens
notification_mbox = NotificationMbox(name="orderConfirm")
order = Order(id="BR9389, total=98.93, purchased_product_ids=["J9393", "3DJJ3"])
notification = Notification(
   id="conversion",
   type=MetricType.DISPLAY,
   timestamp=1621530726000,  # Epoch time in milliseconds
   mbox=notification_mbox,
   order=order
)
notification_request = DeliveryRequest(notifications=[notification])


target_client.send_notifications({
   "target_cookie": target_cookie,
   "request" : notification_request
})

7.啟用您的A/B Test活動

按一下 Activate (1)以啟用您的A/B Test活動。

NOTE
您必須有 Approver 或 Publisher 使用者角色才能執行此步驟。

recommendation-more-help