설명서TargetTarget 개발자 안내서

방문자 식별

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

Adobe Target 내에서 방문자를 식별하는 방법에는 여러 가지가 있습니다.

Target에서는 다음 세 가지 식별자를 사용합니다.

필드 이름
설명
tntId
tntId은(는) 사용자의 Target에 있는 기본 식별자입니다. 이 ID를 제공할 수 있습니다. 그렇지 않으면 Target이(가) 요청에 ID를 포함하지 않으면 자동으로 생성합니다.
thirdPartyId
thirdPartyId은(는) 모든 호출을 통해 보낼 수 있는 사용자의 회사 식별자입니다. 사용자가 회사 사이트에 로그인하면 일반적으로 회사는 방문자 계정, 로열티 카드, 멤버십 번호 또는 해당 회사에 대한 기타 적용 가능한 식별자에 연결되는 ID를 만듭니다.
marketingCloudVisitorId
marketingCloudVisitorId은(는) 다른 Adobe 솔루션 간에 데이터를 병합하고 공유하는 데 사용됩니다. Adobe Analytics 및 Adobe Audience Manager과의 통합에는 marketingCloudVisitorId이(가) 필요합니다.
customerIds
Experience Cloud 방문자 ID와 함께 각 방문자에 대해 추가 고객 ID 및 인증된 상태를 활용할 수 있습니다.

Target ID

Target ID 또는 tntId은(는) 장치 ID로 볼 수 있습니다. 이 tntId은(는) 요청에 제공되지 않는 경우 Target에 의해 자동으로 생성됩니다. 이후 후속 요청에서는 사용자가 사용하는 장치에 올바른 콘텐츠를 전달하려면 이 tntId을(를) 포함해야 합니다.

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

위의 예제 호출은 tntId을(를) 전달할 필요가 없음을 보여 줍니다. 이 시나리오에서 Target은(는) tntId을(를) 생성하여 다음과 같이 응답에 제공합니다.

{
  "status": 200,
  "requestId": "5b586f83-890c-46ae-93a2-610b1caa43ef",
  "client": "demo",
  "id": {
      "tntId": "10abf6304b2714215b1fd39a870f01afc.28_20"
  },
  "edgeHost": "mboxedge28.tt.omtrdc.net",
  ...
}

생성된 tntId은(는) 10abf6304b2714215b1fd39a870f01afc.28_20입니다. 세션 간에 동일한 사용자에 대해 Adobe Target Delivery API을(를) 호출할 때 이 tntId을(를) 사용해야 합니다.

Marketing Cloud 방문자 ID

marketingCloudVisitorId은(는) Experience Cloud의 모든 솔루션에서 방문자를 식별하는 범용 및 영구 ID입니다. 조직이 ID 서비스를 구현하면 이 ID를 사용하여 Adobe Target, Adobe Analytics 또는 Adobe Audience Manager과 같은 다른 Experience Cloud 솔루션에서 동일한 사이트 방문자와 해당 데이터를 식별할 수 있습니다. Analytics 및 Audience Manager을 활용하고 통합할 때 marketingCloudVisitorId이(가) 필요합니다.

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

위의 예제 호출은 Experience Cloud ID 서비스에서 검색된 marketingCloudVisitorId이(가) Adobe Target에 전달되는 방법을 보여 줍니다. 이 시나리오에서 Target은(는) 아래 응답에 표시된 대로 제공된 marketingCloudVisitorId에 매핑되는 원래 호출에 전달되지 않았으므로 tntId을(를) 생성합니다.

타사 ID

조직에서 ID를 사용하여 방문자를 식별하는 경우 thirdPartyID을(를) 사용하여 콘텐츠를 전달할 수 있습니다. 그러나 Adobe Target Delivery API 호출 시마다 thirdPartyID을(를) 제공해야 합니다.

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

위의 예제 호출은 웹, 모바일 또는 IoT 채널에서 비즈니스와 상호 작용하는지 여부에 관계없이 비즈니스에서 최종 사용자를 식별하는 데 사용하는 영구 ID인 thirdPartyId을(를) 보여 줍니다. 즉, thirdPartyId은(는) 여러 채널에서 사용할 수 있는 사용자 프로필 데이터를 참조합니다. 이 시나리오에서 Target은(는) 원래 호출에 전달되지 않았으므로 tntId을(를) 생성합니다. 이 호출은 아래 응답에 표시된 대로 제공된 thirdPartyId에 매핑됩니다.

{
    "status": 200,
    "requestId": "55de9886-bd14-4dee-819c-7d1633b79b90",
    "client": "demo",
    "id": {
        "tntId": "10abf6304b2714215b1fd39a870f01afc.28_20",
        "thirdPartyId": "B234A029348"
    },
    "edgeHost": "mboxedge28.tt.omtrdc.net",
    ...
}

Customer ID

고객 ID을(를) 추가하고 Experience Cloud 방문자 ID와 연결할 수 있습니다. customerIds을(를) 보낼 때마다 marketingCloudVisitorId도 제공해야 합니다. 또한 각 방문자에 대해 각 customerId과(와) 함께 인증 상태를 제공할 수 있습니다. 다음 인증 상태를 고려할 수 있습니다.

인증 상태
사용자 상태
unknown
알 수 없음 또는 인증되지 않음. 이 상태는 디스플레이 광고를 클릭하여 사이트에 도착한 방문자와 같은 시나리오에 사용할 수 있습니다.
authenticated
사용자는 현재 웹 사이트 또는 앱에서 활성 세션으로 인증됩니다.
logged_out
사용자가 인증되었지만 로그아웃되었습니다. 사용자가 인증된 상태에서 연결을 끊으려고 했습니다. 사용자가 더 이상 인증됨으로 처리되는 것을 원치 않습니다.

고객 ID가 authenticated 상태인 경우에만 Target에서 고객 ID에 저장되고 연결된 사용자 프로필 데이터를 참조합니다. 고객 ID가 unknown 또는 logged_out 상태인 경우 고객 ID는 무시되며, 고객 ID와 연결될 수 있는 모든 사용자 프로필 데이터는 대상 타깃팅에 활용되지 않습니다.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359234570e044f14e1faeeba02d6ab23439914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "context": {
        "channel": "web",
        "browser" : {
          "host" : "demo"
        },
        "address" : {
          "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
        },
        "screen" : {
          "width" : 1200,
          "height": 1400
        }
      },
      "id": {
        "marketingCloudVisitorId" : "2304820394812039",
        "customerIds": [{
          "id": "134325423",
          "integrationCode" : "crm_data",
          "authenticatedState" : "authenticated"
        }]
      },
      "property" : {
        "token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

위의 예제 호출에서는 authenticatedState을(를) 사용하여 customerId을(를) 보내는 방법을 보여 줍니다. customerId을(를) 보낼 때 integrationCode, id, authenticatedState 및 marketingCloudVisitorId이(가) 필요합니다. integrationCode은(는) CRS를 통해 제공한 고객 특성 파일의 별칭입니다.

병합된 프로필

동일한 요청에서 tntId, thirdPartyID 및 marketingCloudVisitorId을(를) 결합할 수 있습니다. 이 시나리오에서는 Adobe Target이 이러한 모든 ID의 매핑을 유지하고 방문자에게 고정합니다. 다른 식별자를 사용하여 프로필이 실시간으로 병합 및 동기화되는 방법을 알아봅니다.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359234570e044f14e1faeeba02d6ab23439914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "context": {
        "channel": "web",
        "browser" : {
          "host" : "demo"
        },
        "address" : {
          "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
        },
        "screen" : {
          "width" : 1200,
          "height": 1400
        }
      },
      "id": {
        "marketingCloudVisitorId" : "2304820394812039",
        "tntId": "d359234570e044f14e1faeeba02d6ab23439914e.28_78",
        "thirdPartyId":"23423432"
      },
      "property" : {
        "token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
      },
      "experienceCloud": {
        "analytics": {
          "supplementalDataId" : "23423498732598234",
          "trackingServer": "ags041.sc.omtrdc.net",
          "logging": "server_side"
        }
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

위의 예제 호출은 tntId, thirdPartyID 및 marketingCloudVisitorId을(를) 동일한 요청에서 결합하는 방법을 보여 줍니다. 세 개의 ID도 모두 응답에서 반환됩니다.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3