데이터 피드

• 사용자의 현재 보상 잔액
• 최신 주문 상태
• 개인화된 제품 추천

​

Data Feeds 작동 방식

1. Data Feed 만들기 – OneSignal이 API에 연결하는 방법을 구성합니다.
2. 메시지 템플릿에 Data Feed 첨부.
3. Liquid 구문을 사용하여 메시지에 응답 필드 삽입.
4. 전송 시, OneSignal은 각 수신자에 대해 API 호출을 수행하고 응답을 파싱한 다음 데이터를 메시지에 삽입합니다.

​

예시: 보상 포인트 표시

Hi {{ first_name }},

You have {{ data_feed.rewards.points }} points!
Your membership status is {{ data_feed.rewards.status_level }}.

Keep shopping to earn more points!

​

Data Feed 만들기 및 사용

​

1. Data Feed 구성 설정

• Name: 피드 목록에서 구별하는 데 도움이 되는 “Customer Rewards API”와 같은 설명 이름. 고유한 것을 권장하지만 필수는 아닙니다.
• Alias: Liquid 구문에서 사용할 rewards와 같은 짧은 이름. 고유해야 하며 공백이 없어야 하고 특수 기호 없이 소문자 영숫자만 포함할 수 있습니다.
• Method: API에 연결하는 방법. 일반적으로 GET이지만 POST도 지원됩니다.
• URL: API의 주소. Liquid 구문을 포함할 수 있어 사용자별 데이터를 가져오기 위해 API를 호출할 수 있습니다.

https://acme.com/customers/user_id={{ external_id }}/rewards

• Headers: API 사양에 필요한 대로 헤더 키-값 쌍을 입력합니다. 일반적으로 중요한 용도는 인증 정보를 포함하는 것입니다. 이러한 필드는 필요한 경우 Liquid 구문도 지원합니다.
• Body: API에서 필요한 경우 JSON 형식의 요청에 본문을 포함할 수 있습니다. 이 편집기는 Journey Webhooks와 마찬가지로 Liquid 구문을 지원합니다.

{
	"customer_id": "{{ external_id }}"
}

Data Feed 구성 예시

​

2. 메시지 템플릿에 Data Feed 첨부

1. Messages > Templates로 이동
2. Message 섹션에서 Personalization 버튼 선택

Personalization 버튼 옵션

3. Data Feeds를 켜고 피드 선택

메시지 작성기의 Data Feeds 섹션

4. 템플릿 저장

​

3. 메시지에서 데이터 사용

{
	"external_id": a1-b2c3,
	"points": 193,
	"status_level": "Gold"
}

You have {{ data_feed.rewards.points }} points!
Your membership status is {{ data_feed.rewards.status_level }}.

• Data Feed 사용
• rewards Data Feed 사용
  • 참고: rewards 피드는 수신자의 external_id로 API를 호출하는 방법을 알고 있습니다
• 응답에서 points 항목(193)과 status_level 항목(Gold)의 값을 삽입

​

요구 사항 및 제한 사항

• 헤더의 인증 토큰으로 단일 단계 인증 수락
• 빠르게 응답. 250ms 미만 권장(전송 속도에 직접 영향을 미침)
• JSON 반환. 현재 다른 형식은 지원되지 않습니다.
  • 대체 형식에 의존하는 사용 사례가 있는 경우 알려주세요! 여기에서 짧은 설문조사를 작성하세요.
• 메시지 전송 볼륨 및 속도 처리. API에 낮은 속도 제한이 있으면 메시지를 빠르게 전달하지 못합니다.
• 적절한 크기의 페이로드 반환. 최상의 성능을 위해 응답을 50kb 미만으로 유지하는 것이 좋습니다.

• 템플릿당 하나의 Data Feed. 향후 이 제한을 늘릴 예정입니다. 이것이 필요하다면 여기에서 짧은 설문조사를 작성하세요.
• 메시지당 Data Feed당 하나의 API 호출. 한 번의 호출로 필요한 모든 것을 가져옵니다.
• Journeys만 해당. 아직 다른 전송 방법에는 사용할 수 없습니다. 이것이 필요하다면 여기에서 짧은 설문조사를 작성하세요.
• 연쇄 호출 없음. 한 Data Feed의 페이로드를 사용하여 다른 Data Feed를 호출할 수 없습니다.

​

API 설정

​

인증

Authorization: Bearer YOUR_TOKEN

X-API-Key: YOUR_KEY

​

JSON 요청 본문

​

JSON 응답

​

개인화 매개변수

https://api.example.com/users/{{external_id}}/data
https://api.example.com/rewards?email={{email | url_encode}}

{
	"customer_id": "{{ external_id }}",
	"email": "{{ subscription.email }}"
}

​

속도 제한

​

오류 처리

​

시작 체크리스트

• 메시지에 어떤 데이터를 표시하고 싶습니까? API에서 채울 항목이 식별된 간단한 개요에서 역으로 작업하면 생각을 정리하는 데 도움이 됩니다.
• 이 데이터는 단일 API 엔드포인트를 통해 사용할 수 있습니까?
• API 요청을 어떻게 인증합니까?
• 개인화된 데이터를 가져오는 데 어떤 식별자 또는 다른 데이터 항목을 사용합니까?
• 해당 식별자가 이미 OneSignal에 저장되어 있습니까? 그렇지 않은 경우 어떻게 채워집니까?
• API가 생성할 요청 볼륨을 처리할 수 있습니까?
• API에 사용자에 대한 데이터가 없으면 어떻게 됩니까?

​

예제 및 고급 사용 사례

​

루프로 반복: 장바구니 포기

{
  "items": [
    {
      "name": "Blue Running Shoes",
      "price": 84.00,
      "image_url": "https://acme.com/blue-running-shoes.png"
    },
    {
      "name": "Protein Bar",
      "price": 5.99,
      "image_url": "https://acme.com/protein-bar.png"
    }
  ],
  "total": 89.99
}

<ul>
  {% for item in data_feed.cart.items %}
    <li>
      <strong>{{ item.name }}</strong><br>
      ${{ item.price }}<br>
      <img src="{{ item.image_url }}" alt="{{ item.name }}">
    </li>
  {% endfor %}
</ul>

<p>Cart total: ${{ data_feed.cart.total }}</p>

- Blue Running Shoes
- $84.00
- <running shoes image>
- Protein Bar
- $5.99
- <protein bar image>
Cart total: $89.99

​

사용자 지정 이벤트 속성

curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Accept: application/json' \
  --data '{
  "events": [
    {
      "name": "cart_abandoned",
      "external_id": "user_12345",
      "properties": {
        "cart_id": 98765
      }
    }
  ]
}'

Journey 진입을 위한 사용자 지정 이벤트

https://acme.com/carts/{{ journey.event.cart_abandoned.data.cart_id }}

1. 98765의 cart_id 값이 Journey에 저장됩니다
2. 이메일 단계에 도달하면 cart Data Feed가 해당 cart_id 값을 참조하고 이를 사용하여 장바구니 API를 호출합니다
3. 반환된 JSON 속성이 파싱되어 위의 이전 예제와 같이 이메일에 삽입됩니다

​

조건부 표시: 주문 상태

Your order is {{data_feed.order.status}}!

{% if data_feed.order.tracking_number != empty %}
Track it here: {{data_feed.order.tracking_url}}
{% endif %}

​

개인화 없는 자동화

https://acme.com/assets/email-banner

{
	"banner_url": "https://acme.com/assets/email-banner/2025july.png"
}

​

문제 해결

​

내 데이터가 표시되지 않습니다

1. Data Feed가 템플릿에 첨부되어 있는지 확인
2. Liquid 구문이 JSON 구조와 정확히 일치하는지 확인
3. API 엔드포인트를 수동으로 테스트하여 데이터를 반환하는지 확인
4. 사용자에게 필요한 데이터 태그(external_id 등)가 있는지 확인

​

메시지가 천천히 전송됩니다

1. API 응답 시간 확인
2. API가 동시 요청을 처리할 수 있는지 확인

​

일부 수신자가 메시지를 받지 못합니다

1. API에 해당 사용자에 대한 데이터가 없을 수 있습니다
2. Data Feed 구성에서 404 또는 오류에 대한 오류 로그 확인
3. API 로그에서 404 또는 오류 확인
4. 해당 사용자가 OneSignal에 필요한 식별자를 가지고 있는지 확인