消息格式

先决条件 — Adobe Experience Platform概念

要了解Adobe端的消息格式以及配置文件配置和转换过程，请熟悉以下Experience Platform概念：

体验数据模型(XDM). XDM概述和如何在Adobe Experience Platform中创建XDM模式.
类. 在UI中创建和编辑类.
IdentityMap. 标识映射表示Adobe Experience Platform中所有最终用户标识的映射。请参阅 xdm:identityMap 在 XDM字段字典.
区段成员资格. 的 segmentMembership XDM属性会通知配置文件是哪个区段的成员。对于 status 字段，请阅读区段成员资格详细信息架构字段组.

概述

将此页面上的内容与合作伙伴目标的配置选项. 本页介绍从Adobe Experience Platform导出到目标的数据中的消息格式和配置文件转换。其他页面将介绍有关连接到目标并进行身份验证的详情。

Adobe Experience Platform以各种数据格式将数据导出到大量目标。目标类型的一些示例包括广告平台(Google)、社交网络(Facebook)和云存储位置(Amazon S3、Azure事件中心)。

Experience Platform可以调整导出用户档案的消息格式，以匹配您方的预期格式。要了解此自定义设置，以下概念非常重要：

Adobe Experience Platform中的源(1)和目标(2)XDM模式
合作伙伴端(3)上的预期消息格式，以及
XDM架构与预期消息格式之间的转换层，您可以通过创建消息转换模板.

架构到JSON转换

Experience Platform使用XDM模式以可重用的一致方式描述数据结构。

源XDM架构(1):此项目是指客户在Experience Platform中使用的架构。在Experience Platform中，在映射步骤在激活目标工作流中，客户会将其XDM架构的字段映射到您目标的目标架构(2)。

目标XDM架构(2):根据目标预期格式的JSON标准架构(3)以及目标可以解释的属性，您可以在目标XDM架构中定义配置文件属性和标识。您可以在目标配置中(在 schemaConfig 和 identityNamespaces 对象。

目标配置文件属性的JSON标准架构(3):此示例表示 JSON架构平台支持的所有配置文件属性及其类型(例如：对象、字符串、数组)。您的目标可支持的示例字段可能包括 firstName, lastName, gender, email, phone, productId, productName，等等。您需要消息转换模板将导出的非Experience Platform数据定制为预期格式。

根据上述架构转换，以下是源XDM架构与合作伙伴端示例架构之间的配置文件配置如何更改：

转换消息示例

入门 — 转换三个基本属性

为了演示配置文件转换过程，以下示例使用了Adobe Experience Platform中的三个常用配置文件属性：名字, 姓氏和 电子邮件地址.

注意

客户将源XDM架构的属性映射到Adobe Experience Platform UI中的合作伙伴XDM架构(位于映射步骤激活目标工作流.

假设您的平台可以接收如下消息格式：

POST https://YOUR_REST_API_URL/users/
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

{
  "attributes":
    {
      "first_name": "Yours",
      "last_name": "Truly",
      "external_id": "yourstruly@adobe.com"
    }
}

考虑到报文格式，相应的转换如下：

Adobe端合作伙伴XDM架构中的属性	转换	HTTP消息中的属性
`_your_custom_schema.firstName`	`attributes.first_name`	`first_name`
`_your_custom_schema.lastName`	`attributes.last_name`	`last_name`
`personalEmail.address`	`attributes.external_id`	`external_id`

Experience Platform中的轮廓结构

要进一步了解页面上的以下示例，请务必了解Experience Platform中用户档案的结构。

用户档案有3个部分：

segmentMembership （始终显示在用户档案中）
- 此部分包含配置文件中存在的所有区段。区段可以具有以下3种状态之一： realized, existing, exited.
identityMap （始终显示在用户档案中）
- 此部分包含配置文件(电子邮件、Google GAID、Apple IDFA等)上以及在激活工作流中映射以导出的用户存在的所有身份。
属性（根据目标配置，这些属性可能存在于配置文件中）。预定义属性与自由格式属性之间还有一些细微的区别：
- 表示 自由格式属性，它们包含 .value 路径（如果配置文件中存在属性）(请参阅 lastName 属性。如果用户档案上不存在，则将不包含 .value 路径(请参阅 firstName 属性。
- 表示 预定义属性，则它们不包含 .value 路径。配置文件中存在的所有映射属性都将显示在属性映射中。没有的将不存在(见示例2 - firstName 属性)。

请参阅下面两个Experience Platform中的用户档案示例：

示例1 `segmentMembership`, `identityMap` 和自由格式属性的属性

{
  "segmentMembership": {
    "ups": {
      "11111111-1111-1111-1111-111111111111": {
        "lastQualificationTime": "2019-04-15T02:41:50.000+0000",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "mobileIds": [
      {
        "id": "e86fb215-0921-4537-bc77-969ff775752c"
      }
    ]
  },
  "attributes": {
    "firstName": {
    },
    "lastName": {
      "value": "lastName"
    }
  }
}

示例2 `segmentMembership`, `identityMap` 和属性

{
  "segmentMembership": {
    "ups": {
      "11111111-1111-1111-1111-111111111111": {
        "lastQualificationTime": "2019-04-15T02:41:50.000+0000",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "mobileIds": [
      {
        "id": "e86fb215-0921-4537-bc77-969ff775752c"
      }
    ]
  },
  "attributes": {
    "lastName": "lastName"
  }
}

对身份、属性和区段成员资格转换使用模板语言

Adobe使用卵石模板，类似于金子，以将Experience PlatformXDM架构中的字段转换为目标支持的格式。

本节提供了如何进行这些转换的几个示例 — 从输入XDM架构、模板，以及将输出为目标接受的有效负载格式。以下示例以日益复杂的方式呈现，如下所示：

简单的转换示例。了解模板如何与配置文件属性, 区段成员资格和身份字段。
组合上述字段的模板的复杂性增加了示例：创建用于发送区段和标识的模板和创建用于发送区段、身份和配置文件属性的模板.
包含聚合键的模板。使用可配置聚合在目标配置中，Experience Platform会根据区段ID、区段状态或身份命名空间等条件对导出到目标的用户档案进行分组。

配置文件属性

要转换导出到目标的配置文件属性，请参阅下面的JSON和代码示例。

重要

有关Adobe Experience Platform中所有可用的配置文件属性的列表，请参阅 XDM字段字典.

输入

用户档案1:

{
    "attributes": {
        "firstName": {
            "value": "Hermione"
    },
    "birthDate": {}
  }
}

用户档案2:

{
  "attributes": {
    "firstName": {
      "value": "Harry"
    },
    "birthDate": {
        "value": "1980/07/31"
    }
  }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

{
    "profiles": [
        {% for profile in input.profiles %}
        {
            {% for attribute in profile.attributes %}
            "{{ attribute.key }}":
                {% if attribute.value is empty %}
                    null
                {% else %}
                    "{{ attribute.value.value }}"
                {% endif %}
            {% if not loop.last %},{% endif %}
            {% endfor %}
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}

结果

{
    "profiles": [
        {
            "firstName": "Hermione",
            "birthDate": null
        },
        {
            "firstName": "Harry",
            "birthDate": "1980/07/31"
        }
    ]
}

区段成员资格

的 segmentMembership XDM属性会通知配置文件是哪个区段的成员。
对于 status 字段，请阅读区段成员资格详细信息架构字段组.

输入

用户档案1:

{
  "segmentMembership": {
    "ups": {
      "36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
        "lastQualificationTime": "2019-11-20T13:15:49Z",
        "status": "realized"
      },
      "788d8874-8007-4253-92b7-ee6b6c20c6f3": {
        "lastQualificationTime": "2019-11-20T13:15:49Z",
        "status": "existing"
      },
      "8f812592-3f06-416b-bd50-e7831848a31a": {
        "lastQualificationTime": "2019-11-20T13:15:49Z",
        "status": "exited"
      }
    }
  }
}

用户档案2:

{
  "segmentMembership": {
    "ups": {
      "32396e4b-16f6-4033-9702-fc69b5e24e7c": {
        "lastQualificationTime": "2021-08-20T17:23:04Z",
        "status": "realized"
      },
      "af854278-894a-4192-a96b-320fbf2623fd": {
        "lastQualificationTime": "2021-08-20T16:44:37Z",
        "status": "existing"
      },
      "66505bf9-bc08-4bac-afbc-8b6706650ea4": {
        "lastQualificationTime": "2019-08-20T17:23:04Z",
        "status": "realized"
      }
    }
  }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

{
    "profiles": [
        {% for profile in input.profiles %}
        {
            "AdobeExperiencePlatformSegments": {
                "add": [
                {% for segment in profile.segmentMembership.ups | added %}
                "{{ segment.key }}"{% if not loop.last %},{% endif %}
                {% endfor %}
                ],
                "remove": [
                {# Alternative syntax for filtering segments by status: #}
                {% for segment in removedSegments(profile.segmentMembership.ups) %}
                "{{ segment.key }}"{% if not loop.last %},{% endif %}
                {% endfor %}
                ]
            }
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}

结果

{
    "profiles": [
        {
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
                    "788d8874-8007-4253-92b7-ee6b6c20c6f3"
                ],
                "remove": [
                    "8f812592-3f06-416b-bd50-e7831848a31a"
                ]
            }
        },
        {
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "32396e4b-16f6-4033-9702-fc69b5e24e7c",
                    "af854278-894a-4192-a96b-320fbf2623fd",
                    "66505bf9-bc08-4bac-afbc-8b6706650ea4"
                ],
                "remove": [
                ]
            }
        }
    ]
}

标识

有关Experience Platform中标识的信息，请参阅身份命名空间概述.

输入

用户档案1:

{
    "identityMap": {
        "email": [
            {
                "id": "johndoe@example.com"
            },
            {
                "id": "jd@example.com"
            }
        ],
        "external_id": [
            {
                "id": "123456"
            }
        ]
    }
}

用户档案2:

{
    "identityMap": {
        "email": [
            {
                "id": "jane.doe@example.com"
            }
        ]
    }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

{
    "profiles": [
        {% for profile in input.profiles %}
        {
            "identities": [
                {% for email in profile.identityMap.email %}
                {
                    "type": "email",
                    "id": "{{ email.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}

                {# Add a comma only if you have both emails and external_ids. #}
                {% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
                    ,
                {% endif %}

                {% for external in profile.identityMap.external_id %}
                {
                    "type": "external_id",
                    "id": "{{ external.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}
            ]
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}

结果

{
    "profiles": [
        {
            "identities": [
                {
                    "type": "email",
                    "id": "johndoe@example.com"
                },
                {
                    "type": "email",
                    "id": "jd@example.com"
                },
                {
                    "type": "external_id",
                    "id": "123456"
                }
            ]
        },
        {
            "identities": [
                {
                    "type": "email",
                    "id": "jane.doe@example.com"
                }
            ]
        }
    ]
}

创建用于发送区段和标识的模板

本节提供了AdobeXDM架构与合作伙伴目标架构之间常用转换的示例。
以下示例向您展示了如何转换区段成员资格和标识格式，并将它们输出到您的目标。

输入

用户档案1:

{
    "identityMap": {
        "email": [
            {
                "id": "johndoe@example.com"
            },
            {
                "id": "jd@example.com"
            }
        ],
        "external_id": [
            {
                "id": "123456"
            }
        ]
    },
    "segmentMembership": {
        "ups": {
            "36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
                "lastQualificationTime": "2019-11-20T13:15:49Z",
                "status": "realized"
            },
            "788d8874-8007-4253-92b7-ee6b6c20c6f3": {
              "lastQualificationTime": "2019-11-20T13:15:49Z",
              "status": "existing"
            },
            "8f812592-3f06-416b-bd50-e7831848a31a": {
                "lastQualificationTime": "2019-11-20T13:15:49Z",
                "status": "exited"
            }
        }
    }
}

用户档案2:

{
    "identityMap": {
        "email": [
            {
                "id": "jane.doe@example.com"
            }
        ]
    },
    "segmentMembership": {
        "ups": {
            "36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
                "lastQualificationTime": "2021-08-31T10:01:42Z",
                "status": "realized"
            }
        }
    }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

{
    "profiles": [
        {% for profile in input.profiles %}
        {
            "identities": [
                {% for email in profile.identityMap.email %}
                {
                    "type": "email",
                    "id": "{{ email.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}

                {# Add a comma only if you have both emails and external_ids. #}
                {% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
                    ,
                {% endif %}

                {% for external in profile.identityMap.external_id %}
                {
                    "type": "external_id",
                    "id": "{{ external.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                    {% for segment in profile.segmentMembership.ups | added %}
                    "{{ segment.key }}"{% if not loop.last %},{% endif %}
                    {% endfor %}
                ],
                "remove": [
                    {# Alternative syntax for filtering segments by status: #}
                    {% for segment in removedSegments(profile.segmentMembership.ups) %}
                    "{{ segment.key }}"{% if not loop.last %},{% endif %}
                    {% endfor %}
                ]
            }
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}

结果

的 json 下面显示了从Adobe Experience Platform中导出的数据。

{
    "profiles": [
        {
            "identities": [
                {
                    "type": "email",
                    "id": "johndoe@example.com"
                },
                {
                    "type": "email",
                    "id": "jd@example.com"
                },
                {
                    "type": "external_id",
                    "id": "123456"
                }
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
                    "788d8874-8007-4253-92b7-ee6b6c20c6f3"
                ],
                "remove": [
                    "8f812592-3f06-416b-bd50-e7831848a31a"
                ]
            }
        },
        {
            "identities": [
                {
                    "type": "email",
                    "id": "jane.doe@example.com"
                }
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "36a51c13-9dd6-4d2c-8aa3-07d785ea5075"
                ],
                "remove": []
            }
        }
    ]
}

创建用于发送区段、身份和配置文件属性的模板

本节提供了AdobeXDM架构与合作伙伴目标架构之间常用转换的示例。

另一个常见用例是导出包含区段成员资格和标识的数据(例如：电子邮件地址、电话号码、广告ID)和配置文件属性。要以这种方式导出数据，请参阅以下示例：

输入

用户档案1:

{
    "attributes": {
        "firstName": {
            "value": "Hermione"
        },
        "birthDate": {}
    },
    "identityMap": {
        "email": [
            {
                "id": "johndoe@example.com"
            },
            {
                "id": "jd@example.com"
            }
        ],
        "external_id": [
            {
                "id": "123456"
            }
        ]
    },
    "segmentMembership": {
        "ups": {
            "36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
                "lastQualificationTime": "2019-11-20T13:15:49Z",
                "status": "realized"
            },
            "788d8874-8007-4253-92b7-ee6b6c20c6f3": {
              "lastQualificationTime": "2019-11-20T13:15:49Z",
              "status": "existing"
            },
            "8f812592-3f06-416b-bd50-e7831848a31a": {
                "lastQualificationTime": "2019-11-20T13:15:49Z",
                "status": "exited"
            }
        }
    }
}

用户档案2:

{
    "attributes": {
        "firstName": {
            "value": "Harry"
        },
        "birthDate": {
            "value": "1980/07/31"
        }
    },
    "identityMap": {
        "email": [
            {
                "id": "harry.p@example.com"
            }
        ]
    },
    "segmentMembership": {
        "ups": {
            "36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
                "lastQualificationTime": "2019-11-20T13:15:49Z",
                "status": "realized"
            }
        }
    }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

{
    "profiles": [
        {% for profile in input.profiles %}
        {
            "attributes": {
            {% for attribute in profile.attributes %}
                "{{ attribute.key }}":
                    {% if attribute.value is empty %}
                        null
                    {% else %}
                        "{{ attribute.value.value }}"
                    {% endif %}
                {% if not loop.last %},{% endif %}
            {% endfor %}
            },
            "identities": [
                {% for email in profile.identityMap.email %}
                {
                    "type": "email",
                    "id": "{{ email.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}

                {# Add a comma only if we have both emails and external_ids. #}
                {% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
                    ,
                {% endif %}

                {% for external in profile.identityMap.external_id %}
                {
                    "type": "external_id",
                    "id": "{{ external.id }}"
                }{% if not loop.last %},{% endif %}
                {% endfor %}
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                {% for segment in profile.segmentMembership.ups | added %}
                    "{{ segment.key }}"{% if not loop.last %},{% endif %}
                {% endfor %}
                ],
                "remove": [
                {# Alternative syntax for filtering segments by status: #}
                {% for segment in removedSegments(profile.segmentMembership.ups) %}
                    "{{ segment.key }}"{% if not loop.last %},{% endif %}
                {% endfor %}
                ]
            }
        }
    ]
}

结果

的 json 下面显示了从Adobe Experience Platform中导出的数据。

{
    "profiles": [
        {
            "attributes": {
                "firstName": "Hermione",
                "birthDate": null
            },
            "identities": [
                {
                    "type": "email",
                    "id": "johndoe@example.com"
                },
                {
                    "type": "email",
                    "id": "jd@example.com"
                },
                {
                    "type": "external_id",
                    "id": "123456"
                }
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
                    "788d8874-8007-4253-92b7-ee6b6c20c6f3"
                ],
                "remove": [
                    "8f812592-3f06-416b-bd50-e7831848a31a"
                ]
            }
        },
        {
            "attributes": {
                "firstName": "Harry",
                "birthDate": "1980/07/21"
            },
            "identities": [
                {
                    "type": "email",
                    "id": "harry.p@example.com"
                }
            ],
            "AdobeExperiencePlatformSegments": {
                "add": [
                    "36a51c13-9dd6-4d2c-8aa3-07d785ea5075"
                ],
                "remove": []
            }
        }
    ]
}

在模板中包含聚合键以访问按各种标准分组的导出用户档案

使用可配置聚合在目标配置中，您可以根据区段ID、区段别名、区段成员资格或身份命名空间等条件对导出到目标的配置文件进行分组。

在消息转换模板中，您可以访问上述聚合键，如以下各节的示例中所示。使用聚合键来构造导出为非Experience Platform的HTTP消息，以匹配目标所预期的格式和速率限制。

在模板中使用区段ID聚合键

如果您使用可配置聚合设置 includeSegmentId 若为true，则导出到目标的HTTP消息中的配置文件会按区段ID进行分组。请参阅下面的如何访问模板中的区段ID。

输入

请考虑以下四个用户档案，其中：

前两个是具有区段ID的区段的一部分 788d8874-8007-4253-92b7-ee6b6c20c6f3
第三个用户档案是区段ID的一部分 8f812592-3f06-416b-bd50-e7831848a31a
第四个配置文件是上述两个区段的一部分。

用户档案1:

{
   "attributes":{
      "firstName":{
         "value":"Hermione"
      }
   },
   "segmentMembership":{
      "ups":{
         "788d8874-8007-4253-92b7-ee6b6c20c6f3":{
            "lastQualificationTime":"2020-11-20T13:15:49Z",
            "status":"existing"
         }
      }
   }
}

用户档案2:

{
   "attributes":{
      "firstName":{
         "value":"Harry"
      }
   },
   "segmentMembership":{
      "ups":{
         "788d8874-8007-4253-92b7-ee6b6c20c6f3":{
            "lastQualificationTime":"2020-11-20T13:15:49Z",
            "status":"existing"
         }
      }
   }
}

资料3:

{
   "attributes":{
      "firstName":{
         "value":"Tom"
      }
   },
   "segmentMembership":{
      "ups":{
         "8f812592-3f06-416b-bd50-e7831848a31a":{
            "lastQualificationTime":"2021-02-20T12:00:00Z",
            "status":"existing"
         }
      }
   }
}

资料4:

{
   "attributes":{
      "firstName":{
         "value":"Jerry"
      }
   },
   "segmentMembership":{
      "ups":{
         "8f812592-3f06-416b-bd50-e7831848a31a":{
            "lastQualificationTime":"2021-02-20T12:00:00Z",
            "status":"existing"
         },
         "788d8874-8007-4253-92b7-ee6b6c20c6f3":{
            "lastQualificationTime":"2020-11-20T13:15:49Z",
            "status":"existing"
         }
      }
   }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

请注意 audienceId 用于访问区段ID。此示例假定您使用 audienceId 用于目标分类中的区段成员资格。您可以改用任何其他字段名称，具体取决于您自己的分类。

{
    "audienceId": "{{ input.aggregationKey.segmentId }}",
    "profiles": [
        {% for profile in input.profiles %}
        {
            "first_name": "{{ profile.attributes.firstName.value }}"
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}

结果

导出到目标后，用户档案会根据其区段ID分为两组。

{
   "audienceId":"788d8874-8007-4253-92b7-ee6b6c20c6f3",
   "profiles":[
      {
         "firstName":"Hermione"
      },
      {
         "firstName":"Harry"
      },
      {
         "firstName":"Jerry"
      }
   ]
}

{
   "audienceId":"8f812592-3f06-416b-bd50-e7831848a31a",
   "profiles":[
      {
         "firstName":"Tom"
      },
      {
         "firstName":"Jerry"
      }
   ]
}

在模板中使用区段别名聚合键

如果您使用可配置聚合设置 includeSegmentId 为true，您还可以访问模板中的区段别名。

将下面的行添加到模板中，以访问按区段别名分组的导出配置文件。

customerList={{input.aggregationKey.segmentAlias}}

在模板中使用区段状态聚合键

如果您使用可配置聚合设置 includeSegmentId 和 includeSegmentStatus 为true，您可以访问模板中的区段状态。这样，您就可以在导出到目标的HTTP消息中，根据应添加还是从区段删除配置文件来对配置文件进行分组。

可能的值包括：

实现
现有
退出

将下面的行添加到模板，以根据以上值在区段中添加或删除用户档案：

action={% if input.aggregationKey.segmentStatus == "exited" %}REMOVE{% else %}ADD{% endif%}

在模板中使用身份命名空间聚合键

以下示例显示可配置聚合在中，设置为按身份命名空间以形式聚合导出的配置文件 "namespaces": ["email", "phone"] 和 "namespaces": ["GAID", "IDFA"]. 请参阅 groups 参数目标配置API引用以了解有关此分组的详细信息。

输入

用户档案1:

{
   "identityMap":{
      "email":[
         {
            "id":"e1@example.com"
         },
         {
            "id":"e2@example.com"
         }
      ],
      "phone":[
         {
            "id":"+40744111222"
         }
      ],
      "IDFA":[
         {
            "id":"AEBE52E7-03EE-455A-B3C4-E57283966239"
         }
      ],
      "GAID":[
         {
            "id":"e4fe9bde-caa0-47b6-908d-ffba3fa184f2"
         }
      ]
   }
}

用户档案2:

{
   "identityMap":{
      "email":[
         {
            "id":"e3@example.com"
         }
      ],
      "phone":[
         {
            "id":"+40744333444"
         },
         {
            "id":"+40744555666"
         }
      ],
      "IDFA":[
         {
            "id":"134GHU45-34HH-GHJ7-K0H8-LHN665998NN0"
         }
      ],
      "GAID":[
         {
            "id":"47bh00i9-8jv6-334n-lll8-nb7f24sghg76"
         }
      ]
   }
}

模板

重要

对于您使用的所有模板，必须对非法字符进行转义，如双引号 "" 在目标服务器配置. 有关转义双引号的更多信息，请参阅 JSON标准.

请注意 input.aggregationKey.identityNamespaces 在以下模板中使用

{
            "profiles": [
            {% for profile in input.profiles %}
            {
                {% for ns in input.aggregationKey.identityNamespaces %}
                "{{ns}}": [
                    {% for id in profile.identityMap[ns] %}
                    "{{id.id}}"{% if not loop.last %},{% endif %}
                    {% endfor %}
                ]{% if not loop.last %},{% endif %}
                {% endfor %}
            }{% if not loop.last %},{% endif %}
            {% endfor %}
        ]
}

结果

导出到目标后，配置文件会根据其身份命名空间分为两个组。电子邮件和电话位于一个组中，而GAID和IDFA位于另一个组中。

{
   "profiles":[
      {
         "email":[
            "e1@example.com",
            "e2@example.com"
         ],
         "phone":[
            "+40744111222"
         ]
      },
      {
         "email":[
            "e3@example.com"
         ],
         "phone":[
            "+40744333444",
            "+40744555666"
         ]
      }
   ]
}

{
   "profiles":[
      {
         "IDFA":[
            "AEBE52E7-03EE-455A-B3C4-E57283966239"
         ],
         "GAID":[
            "e4fe9bde-caa0-47b6-908d-ffba3fa184f2"
         ]
      },
      {
         "IDFA":[
            "134GHU45-34HH-GHJ7-K0H8-LHN665998NN0"
         ],
         "GAID":[
            "47bh00i9-8jv6-334n-lll8-nb7f24sghg76"
         ]
      }
   ]
}

在URL模板中使用聚合键

根据您的用例，您还可以在URL中使用此处描述的聚合键，如下所示：

https://api.example.com/audience/{{input.aggregationKey.segmentId}}

引用：转换模板中使用的上下文和函数

提供给模板的上下文包含 input （此调用中导出的用户档案/数据）和 destination (有关Adobe将数据发送到的目标的数据，对所有用户档案均有效)。

下表提供了上述示例中函数的说明。

函数	描述
`input.profile`	用户档案，表示为 JsonNode. 遵循本页上面进一步提到的合作伙伴XDM架构。
`destination.segmentAliases`	从Adobe Experience Platform命名空间中的区段ID映射到合作伙伴系统中的区段别名。
`destination.segmentNames`	从Adobe Experience Platform命名空间中的区段名称映射到合作伙伴系统中的区段名称。
`addedSegments(listOfSegments)`	仅返回状态为 `realized` 或 `existing`.
`removedSegments(listOfSegments)`	仅返回状态为 `exited`.

后续步骤

在阅读本文档后，您现在可以了解导出的Experience Platform数据是如何转换的。接下来，阅读以下页面，以完成有关为目标创建消息转换模板的知识：

消息格式

先决条件 — Adobe Experience Platform概念

概述

入门 — 转换三个基本属性

Experience Platform中的轮廓结构

示例1 `segmentMembership`, `identityMap` 和自由格式属性的属性

示例2 `segmentMembership`, `identityMap` 和属性

对身份、属性和区段成员资格转换使用模板语言

配置文件属性

区段成员资格

标识

创建用于发送区段和标识的模板

创建用于发送区段、身份和配置文件属性的模板

在模板中包含聚合键以访问按各种标准分组的导出用户档案

在模板中使用区段ID聚合键

在模板中使用区段别名聚合键

在模板中使用区段状态聚合键

在模板中使用身份命名空间聚合键

在URL模板中使用聚合键

引用：转换模板中使用的上下文和函数

后续步骤

Business.Adobe.com 资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe

消息格式

先决条件 — Adobe Experience Platform概念

概述

入门 — 转换三个基本属性

Experience Platform中的轮廓结构

示例1 segmentMembership, identityMap 和自由格式属性的属性

示例2 segmentMembership, identityMap 和属性

对身份、属性和区段成员资格转换使用模板语言

配置文件属性

区段成员资格

标识

创建用于发送区段和标识的模板

创建用于发送区段、身份和配置文件属性的模板

在模板中包含聚合键以访问按各种标准分组的导出用户档案

在模板中使用区段ID聚合键

在模板中使用区段别名聚合键

在模板中使用区段状态聚合键

在模板中使用身份命名空间聚合键

在URL模板中使用聚合键

引用：转换模板中使用的上下文和函数

后续步骤

Business.Adobe.com 资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe

示例1 `segmentMembership`, `identityMap` 和自由格式属性的属性

示例2 `segmentMembership`, `identityMap` 和属性