미리 가져오기

2025년 5월 5일

주제:
APIs/SDKs

작성 대상:

개발자

미리 가져오기를 사용하면 모바일 앱 및 서버와 같은 클라이언트가 한 요청에서 여러 mbox 또는 보기에 대한 콘텐츠를 가져오고, 로컬 캐시에 저장하고, 나중에 방문자가 해당 mbox 또는 보기에 방문할 때 Target에 알릴 수 있습니다.

미리 가져오기를 사용할 때는 다음 용어를 숙지해야 합니다.

필드 이름

설명

prefetch

가져와야 하지만 방문한 것으로 표시해서는 안 되는 mbox 및 보기 목록. Target Edge은 미리 가져오기 배열에 있는 각 mbox 또는 보기에 대해 eventToken을(를) 반환합니다.

notifications

이전에 미리 가져온 mbox 및 보기 목록은 방문한 것으로 표시해야 합니다.

eventToken

콘텐츠를 미리 가져올 때 반환되는 해시된 암호화 토큰. 이 토큰을 notifications 배열의 Target (으)로 다시 보내야 합니다.

Mbox 미리 가져오기

모바일 앱 및 서버와 같은 클라이언트는 세션 내의 특정 방문자에 대해 여러 mbox를 미리 가져오고 캐시하여 Adobe Target Delivery API에 대한 여러 호출을 방지할 수 있습니다.

curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=7abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '
{
  "id": {
    "tntId": "abcdefghijkl00023.1_1"
  },
  "context": {
    "channel": "web",
    "browser" : {
      "host" : "demo"
    },
    "address" : {
      "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
    },
    "screen" : {
      "width" : 1200,
      "height": 1400
    }
  },
    "prefetch": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      },
      {
        "name" : "SummerShoesOffer",
        "index" : 2
      },
      {
        "name" : "SummerDressOffer",
        "index" : 3
      }
    ]
  }
}'

prefetch 필드 내에서 세션 내의 방문자에 대해 미리 가져올 mboxes을(를) 한 번 이상 추가합니다. 해당 mboxes에 대해 미리 가져오면 다음 응답을 받게 됩니다.

{
    "status": 200,
    "requestId": "5efee0d8-3779-4b12-a74e-e04848faf191",
    "client": "demo",
    "id": {
        "tntId": "abcdefghijkl00023.1_1"
    },
    "edgeHost": "mboxedge28.tt.omtrdc.net",
    "prefetch": {
        "mboxes": [
            {
                "index": 1,
                "name": "SummerOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next purchase</b></p>",
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            },
            {
                "index": 2,
                "name": "SummerShoesOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next shoe purchase</b></p>"
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            },
            {
                "index": 3,
                "name": "SummerDressOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next dress purchase</b></p>"
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            }
        ]
    }
}

응답 내에 특정 mbox의 방문자에게 표시할 경험이 포함된 content 필드가 표시됩니다. 이 기능은 서버에 캐시된 경우 매우 유용합니다. 방문자가 세션 내에서 웹 또는 모바일 응용 프로그램과 상호 작용하고 응용 프로그램의 특정 페이지에서 mbox을(를) 방문할 때 다른 Adobe Target Delivery API 호출을 수행하는 대신 캐시에서 경험을 전달할 수 있습니다. 그러나 경험이 mbox에서 방문자에게 전달되면 노출 로깅이 수행되도록 배달 API 호출을 통해 notification이(가) 전송됩니다. 이는 prefetch 호출의 응답이 캐시되기 때문입니다. 즉, 방문자는 prefetch 호출이 발생할 때 경험을 보지 못했습니다. notification 프로세스에 대한 자세한 내용은 알림을 참조하세요.

Analytics for Target 사용 시 `clickTrack` 지표로 mbox 미리 가져오기(A4T)

Adobe Analytics for Target(A4T)은(는) Analytics 전환 지표 및 대상 세그먼트를 기반으로 활동을 만들 수 있는 솔루션 간 통합입니다.

다음 코드 조각은 clickTrack 지표가 포함된 mbox 미리 가져오기의 응답으로서, 오퍼를 클릭했음을 Analytics에 알립니다.

{
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "<mboxName>",
        "options": [
           ...
        ],
        "metrics": [
          {
            "type": "click",
            "eventToken": "<eventToken>",
             "analytics": {
               "payload": {
                 "pe": "tnt",
                 "tnta": "..."
               }
             }
          },
          }
        ],
        "analytics": {
          "payload": {
            "pe": "tnt",
            "tnta": "347565:1:0|2,347565:1:0|1"
          }
        }
      }
    ]
  }
}

NOTE

mbox에 대한 미리 가져오기에 정규화된 활동에 대한 Analytics 페이로드만 포함되어 있습니다. 아직 정규화되지 않은 활동에 대한 성공 지표를 미리 가져오면 보고가 일치하지 않습니다.