사용자 프로필 데이터 가져오기

이 페이지에서는 사용자 프로필을 커넥티드 콘텐츠 호출로 가져오는 방법과 Liquid 템플릿과 관련된 모범 사례를 다룹니다.

Prerequisites

If a Connected Content response contains user profile fields (within a Liquid personalization tag), these values must be defined earlier in the message with Liquid, before the Connected Content call in order to render the Liquid passback properly. 마찬가지로 :rerender 플래그도 요청에 포함되어야 합니다. :rerender 플래그는 한 단계 깊이에 불과하므로 중첩된 연결된 콘텐츠 태그에는 적용되지 않습니다.

커넥티드 콘텐츠 호출의 리퀴드 템플릿

개인화를 위해 Braze는 사용자 프로필 필드를 가져온 다음 해당 필드를 Liquid에 전달하므로, 커넥티드 콘텐츠의 응답에 사용자 프로필 필드가 있는 경우 미리 정의해야 합니다.

예를 들어 연결된 콘텐츠 호출인 경우입니다.

1
2
Hi ${first_name},
{% connected_content https://examplewebsite.com :rerender %}

연결된 콘텐츠 응답은 Your language is ${language} 입니다. 이 예제에서 표시되는 콘텐츠는 Hi Jon, your language is 입니다.

언어 자체는 템플릿화되지 않습니다. 이는 Braze가 연결된 콘텐츠 호출을 수행하기 전에 사용자로부터 어떤 필드를 검색할지 알아야 하기 때문입니다.

Liquid 패스백을 올바르게 렌더링하려면 다음 코드 스니펫에 표시된 것처럼 요청의 아무 곳에나 ${language} 태그를 포함해야 합니다. Liquid 전처리기는 사용자로부터 “언어” 속성을 가져와 응답 템플릿을 준비할 수 있도록 합니다.

1
"Hi ${first_name}, {% connected_content https://examplewebsite.com?language=${language} :rerender %}

Best practices

Use json_escape with Liquid tags that could break the JSON format

When using :rerender, add the json_escape filter to any Liquid tag that could potentially break the JSON format. If your Liquid tags contain characters that break the JSON format, the entire Connected Content response will be interpreted as text and be templated into the message, and none of the variables will be saved.

For example, if the message event property in the example below contains characters that could break the JSON format, add the json_escape filter like in this example:

1
2
3
[{
"message":"{{event_properties.${message} | json_escape}}"
}]