{"user_id":{"customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_name":"af_purchase","event_revenue":49.99,"event_revenue_currency":"USD","af_customer_event_id": "550e8400-e29b-41d4-a716-446655440000","event_value":{"af_content_id":"SKU-001","af_quantity":2,"custom_parameters":{"promo_code":"SUMMER10"}},"event_url":"https://example.com/checkout/success","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

{"user_id":{"appsflyer_id":"1234567890abcdef","customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_url":"https://example.com/products/sneakers","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...","http_referrer":"https://www.google.com/","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

방문은 그 이후의 모든 이벤트가 의존하는 기여 매개변수를 포함하며, 시스템은 사용자로부터 발생하는 모든 이벤트 이전에 방문이 있을 것으로 예상합니다. 방문 전에 이벤트를 전송하면 시스템은 이를 오가닉으로 분류합니다.

afUserId 쿠키를 설정해 주는 Web SDK가 없으므로, JavaScript로 작성된 클라이언트 측 쿠키가 아닌 Set-Cookie 응답 헤더에 설정된 HTTP 쿠키로서 직접 할당하고 관리해야 합니다.

이것이 중요한 이유는 document.cookie을 통해 설정된 클라이언트 측 쿠키는 Safari에서는 7일, ITP 적용 도메인에서는 24시간 이내로 빠르게 만료되기 때문입니다. 만료되면 식별자가 재설정되어 재방문자가 신규 방문자로 보입니다. 서버에서 설정한 쿠키는 이러한 제한을 받지 않으며 브라우저 최대 기간(Chrome은 최대 400일 허용)까지 유지될 수 있습니다. 또한 HttpOnly로 표시할 수 있으므로 페이지 스크립트와 광고 차단기가 이를 읽거나 제거할 수 없으며, 페이지에서 실행되는 스크립트에 전혀 의존하지 않습니다.

설정 및 읽기 방법:

1. 쿠키가 없는 방문자의 첫 번째 요청 시, 서버에서 안정적인 고유 ID(예: UUID)를 생성하십시오.

2. 자사 쿠키로 반환하십시오:

   Set-Cookie: af_web_id=<generated-id>; Max-Age=34128000; Path=/; Secure; HttpOnly; SameSite=Lax

3. 이후의 모든 요청에서 들어오는 Cookie 헤더의 값을 읽고 재사용하십시오. 다시 생성하지 마십시오.
4. 요청의 user_id 객체 내부에 appsflyer_id로 모든 호출 시 해당 값을 AppsFlyer로 전송하십시오.

쿠키 이름은 원하는 대로 지정할 수 있습니다. AppsFlyer는 쿠키 이름이 아닌 전송한 값을 읽습니다. 자신의 자사 도메인에서 설정해야 합니다.

모든 호출에는 appsflyer_id(쿠키 값) 또는 customer_user_id(내부 사용자 ID) 중 하나 이상을 포함하는 user_id 객체가 필요합니다. 두 가지를 모두 가지고 있을 때 함께 전송하면 ID 식별이 향상됩니다.

기억해야 할 점은 방문은 대부분 익명이므로 항상 쿠키 값을 전송해야 한다는 것입니다. 현장 이벤트의 경우, 사용자가 식별되면 customer_user_id을(를) 추가하고 쿠키를 함께 계속 전송하십시오. 브라우저에서 시작되지 않는 이벤트의 경우, AppsFlyer가 이전에 식별된 세션을 통해 해당 사용자를 이미 알고 있다면 customer_user_id만으로도 충분합니다.

user_id 객체는 모든 요청에 필수입니다. 다음 식별자 중 하나 이상을 제공해야 합니다.

이벤트와 방문은 앱 시간대 기준으로 다음 날 00:30 이전까지 수신되어야 합니다. 지연된 이벤트는 서버 수신 시간으로 대체됩니다.

모든 개인 데이터 필드는 전송하기 전에 SHA256으로 해시되어야 합니다. 해싱하기 전에 텍스트를 정규화(소문자 변환, 공백 제거)하십시오. 각 해시는 정확히 64자의 16진수 문자(대소문자 구분 없음)여야 합니다.

• 모든 해시된 필드에 대한 패턴: ^[a-fA-F0-9]{64}$
• phone_number_e164_hashed 필드를 사용하는 전화번호는 해싱하기 전에 E.164 형식(예: +14155552671)을 준수해야 합니다.

• afUserID는 귀하의 웹사이트를 사용자가 첫 방문했을 때 웹 SDK에 의해 부여되는 고유 식별자입니다.
• 필요한 경우 아래 방법 중 하나를 사용하세요.

HTTP 쿠키 헤더에서 afUserId 획득

• afUserId방문자의 브라우저가 귀하의 사이트로 요청을 보낼 때 이(가) 전송됩니다.afUserId
• 필요하다면 HTTP 쿠키 헤더에서 추출하십시오.

방문자 브라우저에서 afUserId 확인

• 방문자의 브라우저에서 afUserID를 확인하여 문제를 해결하거나 디버깅할 수 있습니다.
• 이를 확인하기 위해 방문자는 최소 한 번 웹 SDK가 있는 페이지를 방문해야 합니다.
• afUserId을(를) 포함하는 쿠키는 귀사의 도메인과 관련된 자사 쿠키입니다.afUserId
• 이 절차는 크롬 버전 81을 기반으로 준비되었습니다. 브라우저와 운영 체제에 따라 차이가 있을 수 있습니다.

방문자 브라우저에서 afUserId 가져오는 방법:

1. 브라우저에서 귀하의 웹사이트로 이동하십시오.
2. '검사'를 선택하기 위해 마우스 오른쪽 버튼을 클릭하세요 브라우저의 요소 검사 창이 나타납니다.
3. '애플리케이션(Application)' 탭으로 이동하세요.
4. 측면 메뉴에서 '쿠키(Cookies)'를 확장하세요.
5. 귀하의 웹사이트를 선택하세요. 보이지 않는다면 브라우저를 새로고침하세요.
6. (C) 필터 필드에 afUserIdafUserId을(를)}입력하세요. afUserID의 값이 나타납니다.