Skip to content

콘텐츠 카드 통합

이 참조 문서에서는 카드 표시, 카드 구문 분석 및 분석과 같은 Unity 플랫폼의 콘텐츠 카드 구현 지침을 다룹니다.

기본적으로 콘텐츠 카드 표시

다음 호출을 사용하여 콘텐츠 카드의 기본 UI를 표시할 수 있습니다:

1
Appboy.AppboyBinding.DisplayContentCards();

Unity에서 콘텐츠 카드 데이터 수신

수신 콘텐츠 카드에 대한 알림을 받도록 Unity 게임 오브젝트를 등록할 수 있습니다. Braze 설정 에디터에서 게임 오브젝트 리스너를 설정하는 것을 권장합니다.

런타임에 게임 오브젝트 리스너를 구성해야 하는 경우 AppboyBinding.ConfigureListener()를 사용하고 BrazeUnityMessageType.CONTENT_CARDS_UPDATED를 지정합니다.

iOS의 게임 오브젝트 리스너에서 데이터 수신을 시작하려면 추가적으로 AppboyBinding.RequestContentCardsRefresh()를 호출해야 합니다.

콘텐츠 카드 구문 분석

콘텐츠 카드 게임 오브젝트 콜백에서 수신되는 string 메시지는 편의를 위해 미리 제공된 ContentCard 모델 오브젝트로 파싱할 수 있습니다.

콘텐츠 카드 구문 분석에는 Json 구문 분석이 필요하며, 자세한 내용은 다음 예시를 참조하세요:

콘텐츠 카드 콜백 예시
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
void ExampleCallback(string message) {
  try {
    JSONClass json = (JSONClass)JSON.Parse(message);

    // Content Card data is contained in the `mContentCards` field of the top level object.
    if (json["mContentCards"] != null) {
      JSONArray jsonArray = (JSONArray)JSON.Parse(json["mContentCards"].ToString());
      Debug.Log(String.Format("Parsed content cards array with {0} cards", jsonArray.Count));

      // Iterate over the card array to parse individual cards.
      for (int i = 0; i < jsonArray.Count; i++) {
        JSONClass cardJson = jsonArray[i].AsObject;
        try {
          ContentCard card = new ContentCard(cardJson);
          Debug.Log(String.Format("Created card object for card: {0}", card));

          // Example of logging Content Card analytics on the ContentCard object 
          card.LogImpression();
          card.LogClick();
        } catch {
          Debug.Log(String.Format("Unable to create and log analytics for card {0}", cardJson));
        }
      }
    }
  } catch {
    throw new ArgumentException("Could not parse content card JSON message.");
  }
}

콘텐츠 카드 새로 고침

Braze에서 콘텐츠 카드를 새로 고치려면 다음 메서드 중 하나를 호출합니다.

1
2
3
4
// results in a network request to Braze
AppboyBinding.RequestContentCardsRefresh()

AppboyBinding.RequestContentCardsRefreshFromCache()

GIF 지원

기본적으로 기본 Braze Android SDK는 콘텐츠 카드에 애니메이션 GIF를 지원하지 않지만, 타사 이미지 라이브러리를 사용하여 GIF를 대신 표시할 수 있습니다. 자세한 내용은 Android 콘텐츠 카드를 참조하세요: GIF.

기본적으로 Braze Swift SDK는 콘텐츠 카드에 애니메이션 GIF 지원을 제공하지 않지만, 인스턴스의 GIFViewProvider에서 자체 보기 또는 타사 보기를 래핑할 수 있습니다. 전체 안내는 튜토리얼을 참조하세요: Swift 콘텐츠 카드에 대한 GIF 지원.

분석

Braze에서 직접 표시하지 않는 콘텐츠 카드의 경우 클릭 수와 노출 수를 수동으로 기록해야 합니다.

특정 카드의 클릭 및 노출 횟수를 기록하려면 ContentCard에서 LogClick()LogImpression()을 사용합니다.

이 페이지가 얼마나 도움이 되었나요?
New Stuff!