設定標籤規則以支援 Adobe Campaign Standard 使用案例 configuring-rules-launch
在資料收集UI中,建立資料元素和規則,以將PII和其他資料從行動應用程式傳送至Adobe Campaign Standard。
為確保資料收集UI中的所有設定變更生效,您必須發佈這些變更。 如需詳細資訊,請參閱發佈。
若要在資料收集UI中建立規則,請遵循下列步驟:
建立資料元素 create-data-elements
以下是建議您在資料收集UI中建立的資料元素。
您可以視需要建立其他資料元素。
- Experience Cloud ID
- Pkey
- Campaign server
若要建立這些資料元素:
-
在資料收集UI中,從您的行動應用程式儀表板,按一下「Data Elements」標籤。
-
若要建立 Experience Cloud ID 資料元素,請按一下 Create New Data Element。
-
在 Name 欄位中,例如,輸入 mcid。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後 Data element 型別下拉式清單中的 Experience Cloud ID。
-
若要建立Pkey資料元素,請按一下 Add data element。
-
在 Name 欄位中,例如,輸入 pkey。
-
從 Extension 下拉式清單中選取 Adobe Campaign Standard。 然後 Data element 型別下拉式清單中的 pkey。
-
若要建立Campaign伺服器資料元素,請按一下 Add data element。
-
在 Name 欄位中輸入名稱,例如 camp-server。
-
從 Extension 下拉式清單中選取 Adobe Campaign Standard。 然後,Data element 型別下拉式清單中的 Campaign Server。
建立規則 creating-rules
您必須針對下列專案建立規則:
PII回傳 pii-postback
若要將PII資料傳送至Adobe Campaign Standard,請在資料收集UI中建立規則:
-
在資料收集UI中,從您的行動應用程式儀表板,按一下「Rules」標籤,然後按一下「Create New Rule」。
-
輸入名稱,例如 行動核心 — 收集PII。
-
在 Events 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,Event type 下拉式清單中的 Collect PII。
-
按一下 Keep changes。
-
在 Actions 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,Action type 下拉式清單中的 Send PII。
-
在 URL 中,輸入下列URL:
code language-none https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
-
選取 Add Post Body 核取方塊。
-
在 Post Body 中,輸入下列內容:
code language-none { "marketingCloudId": "{%%mcid%%}", "pushPlatform": "{%contextdata.pushPlatform%}", "cusEmail": "{%contextdata.email%}", "cusFirstName": "{%contextdata.firstName%}", "cusLastName": "{%contextdata.lastName%}" }
marketingCloudId可讓您調解應用程式訂閱者與資料庫中的收件者,因此是必要專案。 您可以根據業務需求指定其他索引鍵值配對。 在上述範例中,電子郵件、名字和姓氏是從應用程式傳遞。
金鑰(例如cusEmail、cusFirstName和cusLastName)應符合Adobe Campaign Standard執行個體的自訂資源中所定義的欄位ID。 值變數(例如電子郵件、firstName和LastName)應與從應用程式程式碼呼叫AMS collectPII API時,從行動應用程式傳送的JSON資料中的金鑰相符。
您也可以在「收集PII」回傳或不同的回傳中傳遞生命週期資料(視您的事件觸發程式而定)。 以下是生命週期資料JSON的範例:
code language-none { "marketingCloudId":"{%%mcid%%}", "pushPlatform":"{%contextdata.pushPlatform%}", "cusDayslastlaunch": "{%%DaysSinceLastUse%%}", "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}", "cusLaunches": "{%%Launches%%}" }
資料收集UI中定義的資料元素應以雙百分比括住,例如
%%mcid%%
,而應用程式中的內容變數應以單百分比括住,例如%contextdata.email%。 -
在 Content Type 中,輸入 application/json。
-
在 Timeout 中,選取0。
您的使用者資料現在已設定為傳送至Campaign。
應用程式內追蹤回傳 inapp-tracking-postback
若要傳送追蹤資料給Adobe Campaign Standard,以報告您的使用者在您的行動應用程式中與應用程式內訊息互動的方式,請在資料收集UI中建立下列規則:
-
在資料收集UI中,從您的行動應用程式儀表板中,選取「Rules」標籤,然後按一下「Add Rule」。
-
輸入名稱,例如 Adobe Campaign — 應用程式內點選追蹤。
-
在 Events 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Adobe Campaign Standard。 然後,Event type 下拉式清單中的 In-App click tracking。
-
按一下 Keep changes。
-
在 Actions 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,Event type 下拉式清單中的 Send postback。
-
在 URL 中,輸入下列URL:
code language-none https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
-
選取 Add post body 核取方塊。
-
在 Post Body 中,輸入 {}。
-
在 Content Type 中,輸入 application/json。
-
在 Timeout 中,選取0。
推播通知追蹤回傳 push-tracking-postback
若要將追蹤資料傳送至Adobe Campaign Standard (有助於追蹤您的推播通知傳遞內容,以及您的使用者與行動應用程式的互動),您必須在資料收集UI中建立規則。
如需推送追蹤的詳細資訊,請參閱推送追蹤。
若要追蹤應用程式動作,請使用trackAction API。 如需詳細資訊,請參閱追蹤應用程式動作。
-
在資料收集UI中,從您的行動應用程式儀表板,按一下 Rules 索引標籤,然後按一下 Add Rule。
-
輸入名稱,例如 Adobe Campaign — 推播點選追蹤。
-
在 Events 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,Event type 下拉式清單中的 Track Action。
-
從 Action 下拉式清單中,選取 Action,選取 equals,然後輸入 追蹤。
-
按一下 Keep changes。然後,在 Actions 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,Action type 下拉式清單中的 Send postback。
-
在 URL 中,輸入下列URL:
code language-none https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}
-
選取 Add post body 核取方塊。
-
新增您的貼文內文,例如{ }。
-
在 Content Type 中,輸入 application/json。
-
在 Timeout 中,選取0。
位置回傳 location-postback
-
在資料收集UI中,從您的行動應用程式儀表板,按一下 Rules 索引標籤,然後按一下 Add Rule。
-
輸入名稱,例如 位置回傳。
-
在 Events 區段中,按一下 Add。
-
建立事件,例如,輸入POI或退出POI。 從 Extension 下拉式清單中選取 地標 — Beta。 然後,在 Event type 下拉式清單中 輸入POI 或 結束POI。
-
輸入名稱,例如,地點 — Beta — 輸入POI 或 結束POI。
-
在 Actions 區段中,按一下 Add。
-
從 Extension 下拉式清單中選取 Mobile Core。 然後,從 Action type 下拉式清單中 Send postback。
-
輸入名稱,例如 行動核心 — 傳送位置回傳。
-
在 URL 中,輸入下列URL:
code language-none https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
-
選取 Add post body 核取方塊並新增您的貼文內文,例如:
code language-none { "locationData": { "distances": "{%%Distance%%}", "poiLabel": "{%%POILabel%%}", "latitude": "{%%Latitude%%}", "longitude": "{%%Longitude%%}", "appId": "{%%AppId%%}", "marketingCloudId": "{%%ECID%%}" } }
note note NOTE 在上述範例中,您必須運用建立資料元素中的步驟,在資料收集UI中設定右側的資料元素。 Adobe Campaign Standard支援左側的資料元素,不需要任何設定。 如果您需要其他資料,您必須在Adobe Campaign Standard中執行自訂資源延伸。 -
在 Content Type 中,輸入 application/json。
-
在 Timeout 中,選取5。