配置标记规则以支持 Adobe Campaign Standard 用例 configuring-rules-launch

在数据收集UI中,创建数据元素和规则以将PII和其他数据从移动应用程序发送到 Adobe Campaign Standard.

要确保数据收集UI中的所有配置更改生效,您必须发布这些更改。 有关更多信息,请参阅 发布.

要在数据收集UI中创建规则,请执行以下步骤:

创建数据元素 create-data-elements

以下是我们建议您在数据收集UI中创建的数据元素。
您可以根据需要创建其他数据元素。

  • Experience Cloud ID
  • Pkey
  • Campaign server

要创建这些数据元素,请执行以下操作:

  1. 在数据收集UI中,从移动设备应用程序仪表板中,单击 Data Elements 选项卡。

  2. 要创建 Experience Cloud ID 数据元素,单击 Create New Data Element.

  3. Name 字段,例如,键入 mcid.

  4. Extension 下拉列表,选择 Mobile Core. 则 Experience Cloud IDData element 类型下拉列表。

  5. 要创建Pkey数据元素,请单击 Add data element.

  6. Name 字段,例如,键入 pkey.

  7. Extension 下拉列表,选择 Adobe Campaign Standard. 则 pkeyData element 类型下拉列表。

  8. 要创建Campaign服务器数据元素,请单击 Add data element.

  9. Name 字段中,键入名称,例如, camp-server.

  10. Extension 下拉列表,选择 Adobe Campaign Standard. 然后, Campaign ServerData element 类型下拉列表。

创建规则 creating-rules

您必须为以下内容创建规则:

PII回发 pii-postback

NOTE
要将PII信息从移动应用程序发送到Adobe Campaign,您必须实施SDK API。 有关详细信息,请访问 CollectPII.

要将PII数据发送到 Adobe Campaign Standard,在数据收集UI中创建规则:

  1. 在数据收集UI中,从移动设备应用程序仪表板中,单击 Rules 选项卡,然后 Create New Rule.

  2. 键入名称,例如, 移动核心 — 收集PII.

  3. Events 部分,单击 Add.

  4. Extension 下拉列表,选择 Mobile Core. 然后, Collect PIIEvent type 下拉菜单。

  5. 单击 Keep changes

  6. Actions 部分,单击 Add.

  7. Extension 下拉列表,选择 Mobile Core. 然后, Send PIIAction type 下拉菜单。

  8. URL,输入以下URL:

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
    
  9. 选择 Add Post Body 复选框。

  10. 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数据中的键匹配。

    您还可以在Collect PII回发或其他回发中传递生命周期数据,具体取决于您的事件触发器。 以下是生命周期数据JSON的示例:

    code language-none
    {
    "marketingCloudId":"{%%mcid%%}",
    "pushPlatform":"{%contextdata.pushPlatform%}",
    "cusDayslastlaunch": "{%%DaysSinceLastUse%%}",
    "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}",
    "cusLaunches": "{%%Launches%%}"
    }
    

    例如,数据收集UI中定义的数据元素应包含于双百分比中 %%mcid%%、和应用程序中的上下文变量应以单个百分比括起来,例如%contextdata.email%。

  11. Content Type,类型 application/json.

  12. Timeout,选择0。

您的用户数据现在已配置为发送到Campaign。

应用程序内跟踪回发 inapp-tracking-postback

NOTE
如果您使用的是Android ACPCore v1.4.0或更高版本/ iOS ACPCore v2.3.0或更高版本,则不需要配置跟踪回发。

要将跟踪数据发送至 Adobe Campaign Standard 要报告用户如何与移动应用程序中的应用程序内消息进行交互,请在数据收集UI中创建以下规则:

  1. 在数据收集UI中,从移动应用程序仪表板中,选择 Rules 选项卡,然后单击 Add Rule.

  2. 键入名称,例如, Adobe Campaign — 应用程序内点击跟踪.

  3. Events 部分,单击 Add.

  4. Extension 下拉列表,选择 Adobe Campaign Standard. 然后, In-App click trackingEvent type 下拉菜单。

  5. 单击 Keep changes

  6. Actions 部分,单击 Add.

  7. Extension 下拉列表,选择 Mobile Core. 然后, Send postbackEvent type 下拉菜单。

  8. URL,键入以下URL:

    code language-none
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
    
  9. 选择 Add post body 复选框。

  10. Post Body,类型 {}.

  11. Content Type,类型 application/json.

  12. Timeout,选择0。

推送通知跟踪回发 push-tracking-postback

NOTE
如果您使用的是Android ACPCore v1.4.0或更高版本/ iOS ACPCore v2.3.0或更高版本,则不需要配置跟踪回发。

要将跟踪数据发送至 Adobe Campaign Standard,有助于跟踪您的推送通知投放以及用户与移动应用程序的交互,您必须在数据收集UI中创建规则。

有关推送跟踪的详细信息,请参阅 推送跟踪.

要跟踪应用程序操作,请使用trackAction API。 有关更多信息,请参阅 跟踪应用程序操作.

  1. 在数据收集UI中,从移动设备应用程序仪表板中,单击 Rules 选项卡,然后单击 Add Rule.

  2. 键入名称,例如, Adobe Campaign — 推送点击跟踪.

  3. Events 部分,单击 Add.

  4. Extension 下拉列表,选择 Mobile Core. 然后, Track ActionEvent type 下拉菜单。

  5. Action 下拉列表,选择 Action,选择 equals,并键入 跟踪.

  6. 单击 Keep changes。然后,在 Actions 部分,单击 Add.

  7. Extension 下拉列表,选择 Mobile Core. 然后, Send postbackAction type 下拉菜单。

  8. URL,输入以下URL:

    code language-none
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}
    
  9. 选择 Add post body 复选框。

  10. 添加您的帖子正文,例如,{ }。

  11. Content Type,类型 application/json.

  12. Timeout,选择0。

位置回发 location-postback

  1. 在数据收集UI中,从移动设备应用程序仪表板中,单击 Rules 选项卡,然后单击 Add Rule.

  2. 键入名称,例如, 位置回发.

  3. Events 部分,单击 Add.

  4. 创建事件,例如,输入POI或退出POI。 从 Extension 下拉列表,选择 地点 — Beta版. 然后, 输入POI退出POIEvent type 下拉菜单。

  5. 输入名称,例如, Places - Beta — 输入POI退出POI.

  6. Actions 部分,单击 Add.

  7. Extension 下拉列表,选择 Mobile Core. 然后, Send postbackAction type 下拉菜单。

  8. 输入名称,例如, 移动核心 — 发送位置回发.

  9. URL,输入以下URL:

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
    
  10. 选择 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.
  11. Content Type,类型 application/json.

  12. Timeout,选择5。

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff