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 CloudID サービスから取得された marketingCloudVisitorId をAdobe Targetに渡す方法を示しています。 このシナリオでは、Target は、元の呼び出しに渡されなかったので tntId を生成します。これは、以下の応答のように、指定された marketingCloudVisitorId にマッピングされます。
サードパーティ 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
}
]
}
}'
上記の呼び出し例では、Web、モバイル、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",
...
}
顧客 ID
顧客 ID を追加し、Experience Cloudの訪問者 ID に関連付けることができます。 送信 customerIds る場合は常に、marketingCloudVisitorId も指定する必要があります。 さらに、各訪問者毎に、各 customerId と共に認証状況を提供することができる。 次の認証ステータスが考慮されます。
| 認証状態 | ユーザーステータス |
|---|---|
unknown | 不明または認証されていません。 この状態は、ディスプレイ広告をクリックしてサイトに訪問した訪問者などのシナリオで使用できます。 |
authenticated | ユーザーは現在、Web サイトまたはアプリのアクティブセッションで認証されています。 |
logged_out | ユーザーは過去に認証されましたが、アクティブにログアウトしました。ユーザーは意図的に認証済みの状態から切断しました。ユーザーは、認証済みとして扱われることを希望していません。 |
顧客 ID が authenticated の状態にある場合にのみ、Target は、保存され、顧客 ID にリンクされているユーザープロファイルデータを参照することに注意してください。 顧客 ID が unknown または logged_out の状態の場合、その顧客 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 で指定した 顧客属性ファイルのエイリアスです。