{"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"}

방문에는 이후의 모든 이벤트가 의존하는 어트리뷰션 파라미터가 포함되며, 시스템은 모든 사용자 이벤트보다 먼저 방문이 전송되기를 기대합니다. 방문 전에 이벤트를 전송하면 시스템은 이를 오가닉으로 분류합니다.

웹 SDK가 afUserId 쿠키를 설정해 주지 않으므로, 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_id(쿠키 값) 또는 customer_user_id(내부 사용자 ID) 중 하나 이상이 포함된 user_id 객체가 필요합니다. 가능한 경우 두 값을 모두 전송하면 ID 식별이 향상됩니다.

다음 사항을 유념하세요. 방문은 대부분 익명이므로 항상 쿠키 값을 전송해야 합니다. 사이트 내 이벤트의 경우 사용자가 식별되면 customer_user_id를 추가하고, 쿠키도 함께 계속 전송하세요. 브라우저에서 발생하지 않은 이벤트의 경우, 앱스플라이어가 이전에 식별된 세션을 통해 해당 사용자를 이미 알고 있다면 customer_user_id만으로도 충분합니다.

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

이벤트와 방문은 앱의 시간대 기준으로 다음 날 00:30까지 수신되어야 합니다. 늦게 도착한 이벤트에는 서버 수신 시간이 적용됩니다.

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

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

• afUserId 파라미터는 사용자가 사이트를 최초 방문할 때 웹 SDK가 설정하는 고유 식별자입니다.
• afUserId가 필요하면 아래 방법 중 하나를 사용하세요.

HTTP 쿠키 헤더에서 afUserId 획득

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

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

• 문제 해결 및 디버깅을 위해 방문자 브라우저에서 afUserId를 확인할 수 있습니다.
• 이 값이 사용 가능하려면 방문자가 웹 SDK가 포함된 페이지를 최소 한 번은 방문한 적이 있어야 합니다.
• afUserId를 포함하는 쿠키는 귀사 도메인 기준의 자사 쿠키입니다.
• 다음 절차는 Chrome 81을 사용해 작성되었습니다. 브라우저와 운영 체제에 따라 차이가 있을 수 있습니다.

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

1. 브라우저에서 귀하의 웹사이트로 이동하십시오.
2. 마우스 오른쪽 버튼을 클릭한 다음 검사를 선택합니다. 브라우저의 요소 검사 창이 나타납니다.
3. (A) Application 탭으로 이동하세요.
4. 측면 메뉴에서 (B) 쿠키를 확장하세요.
5. 웹사이트를 선택하세요. 표시되지 않으면 브라우저를 새로고침하세요.
6. (C) filter 필드에 afUserId를 입력하세요. afUserID 값이 표시됩니다.

앱스플라이어에는 아직 S2S API용으로 사전 구축된 Segment 대상이 없으므로, Segment에서 각 이벤트를 S2S 엔드포인트로 전송하는 사용자 지정 대상으로 설정해야 합니다. 데이터 형식을 얼마나 세밀하게 컨트롤해야 하는지에 따라 두 가지 방법이 있습니다.

옵션 1: Webhooks(Actions) 목적지

권장되는 시작 방법입니다. 코드가 필요 없으며, 모든 설정은 Segment 사용자 인터페이스에서 이루어집니다.

설정 방법:

1. Segment에서 대상 카탈로그의 Webhooks 대상을 추가하세요.
2. 전송하려는 이벤트를 수집하는 소스에 연결하세요.
3. 각 이벤트 유형에 대해 앱스플라이어 URL을 정의하고, 메서드를 POST로 설정하고, 필요한 헤더를 추가하고, 이벤트 필드에서 JSON 페이로드를 구성하는 매핑을 생성하세요.

옵션 2: 목적지 함수

Webhooks 매핑으로 앱스플라이어에 필요한 페이로드 형식을 만들 수 없는 경우에만 이 옵션을 사용하세요. 목적지 함수는 Segment 내에서 실행되는 작은 JavaScript 함수로, 각 이벤트를 받아 fetch를 사용해 앱스플라이어 엔드포인트로 전송합니다.

다음과 같은 경우 이 옵션을 사용하세요:

• Webhooks 매핑 사용자 인터페이스로는 만들 수 없는 중첩 구조의 페이로드가 필요한 경우(예: user 객체 안에 user_id를 래핑하는 경우).
• 전송 전에 이벤트 데이터를 변환해야 하는 경우(예: 타임스탬프를 다른 형식으로 변환).

어떤 설정을 사용하든 이 엔드포인트를 사용하도록 설정하세요:

POST https://events.appsflyer.com/v2.0/s2s/inapps/app/web/website-{your_domain}

Authorization: Bearer {s2s-token}
Content-Type: application/json

앱스플라이어 토큰 관리 페이지에서 S2S API 키를 가져오세요(Authentication 참조). 경로에는 앱 설정 페이지의 웹 SDK ID UUID가 아니라 웹 앱 ID(예: website-www.your_domain)를 사용하세요.

매핑된 각 이벤트의 JSON 본문은 다음 필드로 구성하세요:

{
  "user_id": {
    "customer_user_id": "<your internal user ID>",
    "appsflyer_id": "<afUserId cookie value, when available>"
  },
  "event_name": "signup",
  "event_url": "<page URL where the event happened>",
  "ip": "<end-user IP>",
  "user_agent": "<end-user user agent>",
  "af_customer_event_id": "<Segment messageId>"
}

1. 마케팅 사이트에서 웹 SDK를 계속 실행하세요. 방문은 웹 SDK가 기록하고, 이벤트는 Segment가 전달합니다. 이 섹션의 소개에서 설명했듯이, 사용자는 이벤트 전에 방문이 있어야 합니다. 그렇지 않으면 이벤트가 오가닉으로 어트리뷰션됩니다. 대신 웹 SDK 없이 완전한 서버 사이드 설정을 원한다면 완전한 서버 사이드 연동 설정을 따르세요.
2. 모든 호출에는 적절한 식별자도 함께 필요합니다. 호출 시마다 올바른 식별자 전송하기에 설명된 것과 동일한 appsflyer_id 또는 customer_user_id 조합을 전송하세요.

목적지와 페이로드를 준비한 후에는 다음 세 단계로 배포하세요:

1. Segment에서 한두 개의 이벤트를 매핑하고(가입 이벤트가 좋은 첫 후보입니다) 매핑 테스터에서 테스트 이벤트를 전송하세요.
2. 이벤트가 로우 리포트에 올바르게 도착했는지, 그리고 마케팅 사이트 방문과 일치하는지 확인하세요.
3. 확인이 완료되면 나머지 이벤트로 매핑을 확장하세요.

대상과 페이로드가 준비되면 다음 세 단계로 롤아웃하세요:

1. Segment에서 한두 개의 이벤트를 매핑하고(가입 이벤트가 좋은 첫 후보입니다) 매핑 테스터에서 테스트 이벤트를 전송하세요.
2. 이벤트가 로우 리포트에 올바르게 도착했는지, 그리고 마케팅 사이트 방문과 일치하는지 확인하세요.
3. 확인이 완료되면 나머지 이벤트로 매핑을 확장하세요.