訊息格式

必要條件 — Adobe Experience Platform概念

若要了解訊息格式以及Adobe端的設定檔設定和轉換程式，請熟悉下列Experience Platform概念：

Experience Data Model(XDM)。XDM概述及如何在Adobe Experience Platform中建立XDM結構。
類別。在UI中建立和編輯類。
IdentityMap。身分對應代表Adobe Experience Platform中所有一般使用者身分的對應。請參閱XDM欄位字典中的xdm:identityMap。
區段成員資格。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中，在啟動目標工作流的映射步驟中，客戶將從其源架構將欄位映射到目標的目標架構(2)。

Target 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"
    }
}

考慮到報文格式，相應的轉換如下：

合作夥伴XDM結構中的Adobe端屬性	轉換	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`

使用範本語言進行身分、屬性和區段成員資格轉換

Adobe使用類似Jinja的範本語言，將XDM結構的欄位轉換為目的地支援的格式。

本節提供幾個進行這些轉換的範例：從輸入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 standard中的第9章。

{
    "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 standard中的第9章。

{
    "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 standard中的第9章。

{
    "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 standard中的第9章。

{
    "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 standard中的第9章。

{
    "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 standard中的第9章。

請注意以下範本中如何使用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"]。如需此分組的詳細資訊，請參閱目標配置API參考中的groups參數。

輸入

配置檔案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 standard中的第9章。

請注意，以下範本中使用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`的區段。

訊息格式

必要條件 — Adobe Experience Platform概念

概覽

快速入門 — 轉換三個基本屬性

使用範本語言進行身分、屬性和區段成員資格轉換

設定檔屬性

區段成員資格

身分

建立可傳送區段和身分的範本

建立可傳送區段、身分和設定檔屬性的範本

在您的範本中包含匯總金鑰，以存取依各種准則分組的匯出設定檔

在範本中使用區段ID匯總金鑰

在範本中使用區段別名匯總金鑰

在範本中使用區段狀態匯總金鑰

在範本中使用身分命名空間匯總金鑰

在URL範本中使用匯總索引鍵

參考資料：轉換範本中使用的內容和函式

adobe.com 上的資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe