퍼스트 파티 쿠키 통합
이 문서에서는 Epsilon의 퍼스트 파티 쿠키와 귀사의 사이트 내 활동을 통합하는 단계를 설명합니다.
퍼스트 파티 쿠키는 현재 사용자가 방문 중인 웹사이트(또는 도메인)에 저장되는 작은 데이터 조각입니다. 이러한 쿠키는 웹사이트 자체에서 직접 생성 및 저장되며 해당 웹사이트에서만 액세스할 수 있습니다.
사용자가 웹사이트를 방문하면 해당 사용자의 브라우저에 고유한 사용자 식별자 또는 사이트에서의 사용자 상호 작용에 대한 데이터 등 다양한 정보가 포함될 수 있는 퍼스트 파티 쿠키가 설정됩니다. 이 쿠키는 다중 세션 및 방문에도 남아 있어 웹사이트가 재방문 사용자를 인식하고 시간 경과에 따른 사용자의 행동을 추적할 수 있습니다. 이러한 ID는 시스템에서 약 13개월 동안 사용할 수 있습니다.
Epsilon은 이 쿠키를 활용하여 보다 심층적인 옴니 채널 보고 및 어트리뷰션을 지원합니다.
사전 필수 조건
사이트에서 퍼스트 파티 쿠키(FPC) 기반 어트리뷰션을 성공적으로 구현하려면 사이트 활동을 Epsilon의 퍼스트 파티 쿠키와 통합하기 전에 다음 데이터가 준비되어 있어야 합니다.
필수 데이터 준비
고객 데이터, 전환 데이터, Epsilon 사이트 태그가 준비되어 있는지 확인하세요.
- 전환 데이터: 전환 데이터는 정확한 속성 파악, 타기팅 강화, 성과 최적화, 데이터 일관성 보장, 포괄적인 고객 인사이트 제공에 도움이 됩니다.
- 캠페인 전환 데이터: 매장, 온라인, 카탈로그 등 모든 구매 채널에 대한 전환 수 데이터를 포함합니다.
- 모든 전환 수: 식별된 고객과 식별되지 않은 고객의 모든 전환 수를 포함합니다.
- 총 판매액만: 주문 업데이트 또는 취소를 제외한 총 판매액만 제공합니다.
- 일관된 주문 ID: 전환 파일에 제공된 주문 ID와 웹사이트 태그에 제공된 주문 ID가 일치하는지 확인합니다.
- Epsilon 사이트 태그: 사이트 태그에는 웹 페이지에 퍼스트 파티 쿠키를 설정하고 읽는 수 있는 추적 코드를 삽입하는 것이 포함됩니다. 이 프로세스는 사용자 상호 작용을 수집하고 시간 경과에 따른 행동을 정확하게 어트리뷰션하는 데 필수적입니다.
원활한 통합을 위해 고객 통합 엔지니어(CIE) 및 통합 프로그램 관리자(IPM) 팀과 협력해야 합니다. 담당자가 다음을 포함한 필요한 단계를 안내해 드립니다.
• 태그 전략: 모든 관련 사용자 상호 작용을 수집하기 위한 전략을 개발합니다.
• 구현: 추적 코드를 웹 페이지에 올바르게 삽입합니다.
• 테스트: 쿠키가 올바르게 설정되고 읽히는지 확인하기 위해 철저히 테스트합니다.
일치하는 속성 제공
클라이언트는 다음 데이터 포인트에서 일치하는 속성을 제공해야 합니다.
필드 설명 | RMN 오프사이트 - 필드 이름(위치) | RMN 온사이트 - 필드 이름(위치) |
---|---|---|
고객 식별자 | mk_cust_id ( mk_file_id )입니다. | Customer_Id (Bigquery) |
주문 식별자 | order_id ( mk_file_id )입니다. | Retailer_Order_Id (Bigquery) |
제품 식별자 | mk_sku_id 또는 web_sku_id ( mk_file_id )입니다. | product_code (Product_catalog) |
퍼스트 파티 쿠키 ID | dtm_id ( raw_text_form_submission_log )입니다. | dtm_cookie_id (2H release) |
퍼스트 파티 쿠키 구현
이 섹션에서는 Epsilon의 퍼스트 파티 쿠키(FPC)를 귀사의 사이트 활동에 성공적으로 통합하여 정확한 추적 및 어트리뷰션을 수행하는 데 필요한 순차적 단계를 설명합니다.
1단계: 퍼스트 파티 쿠키 식별 및 수집
-
클라이언트 브라우저에서 FPC가 설정되는 시점을 확인합니다.
-
찾기 및 식별: 쿠키 데이터에서
dtm_token
값을 찾아 식별합니다.
새로운 사용자가 사이트에 첫 방문 시 FPC가 설정되지 않습니다. 사용자가 사이트에서 처음으로 탐색을 시작하면 퍼스트 파티 쿠키 값이 나타납니다 .
dtm_token
이 식별되면 사용을 시작할 수 있습니다.
2단계: 온사이트 광고 요청 API 호출에서 dtm_token
전달
dtm_token
전달-
온사이트 광고 요청 호출 시
dtm_token
값을dtmCookieId
필드에 포함시킵니다. 이를 통해 사용자 상호 작용을 정확하게 추적 및 어트리뷰션할 수 있습니다. -
또한
CustomerId
값을CustomerId
필드에 CustomerId 값을 전달하여 쿠키를 특정 고객과 연결하면 추적 정확도가 향상됩니다 .CustomerId
값은 고객이 소매업체 사이트에 로그인하면 사용할 수 있습니다.요청 예시
{ "sessionid": "{SESSION_ID}", // Set to value advised by your CIE. "customerid": "{CUSTOMER_ID}", // Set to CustomerId value when available. "dtmCookieId": "{DTM_TOKEN_VALUE}" // Set to dtm_token value. }
응답 예시
{ "sessionid": "SESSION_1", // Set to value advised by your CIE. "customerid": "CUSTOMER_1", // Set to CustomerId value when available. "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE" // Set to dtm_token value. }
광고 요청 API 호출에 대한 자세한 내용은 제품 광고 생성을 참조하세요.
시스템에서 성능을 개선하기 위해 캐싱을 사용하여 데이터 또는 콘텐츠를 임시로 저장하는 경우 모든 노출 및 클릭 호출에
dtm_token
값을 포함시켜야 합니다. 이를 통해 캐시에서 데이터가 제공되는 경우에도 사용자 상호 작용이 올바르게 추적됩니다.
2a단계: 캐싱 구현 처리
캐싱 기능이 통합되어 있는 경우 노출 및 클릭 이벤트 호출에 dtm_token
값을 전송하고 있는지 확인합니다.
노출 이벤트 예시
GET {integration}.citrusad.com/v1/resource/first-i/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515
클릭 이벤트 예시
GET {integration}.citrusad.com/v1/resource/second-c/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515
3단계: 온사이트 주문 API 호출에서 dtm_token
전달
dtm_token
전달- 온사이트 광고 요청 호출 시
dtm_token
값을dtmCookieId
온사이트 주문 API 호출 시 dtm_token 필드에 dtm_token 값을 포함시킵니다. 이를 통해 특정 사용자에 대한 주문 및 전환 작업을 정확하게 어트리뷰션할 수 있습니다. - 또한
CustomerId
값을CustomerId
필드에 CustomerId 값을 전달하여 주문 데이터와 고객 프로필을 연결하면 보고 및 분석 정확도가 향상됩니다. CustomerId 값은 고객이 소매업체 사이트에 로그인하면 사용할 수 있습니다.
응답 예시
{
"orders": [
{
"customerId": "npc-s243-ir",
"teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
"sessionId": "5cat7-9964-4f",
"dtmCookieId": " AAAF8xLBTA968AB6TOthAAAAAAE"
"orderDate": "2021-12-02T15:00:00Z",
"id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
"orderItems": [
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": 1.00,
"totalOrderItemPriceAfterDiscounts": 3.00,
"catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
"citrusDiscountAmount": 0.0,
"substitutedFor": null,
"sellerId": "seller_id_601_64"
}
]
}
]
}
광고 요청 API 호출에 대한 자세한 내용은 AP를 통한 주문 데이터 동기화를 참조하세요.
업데이트됨 약 2개월 전