Conversion API

웹사이트의 전환 이벤트를 전송하려면 Conversion API를 사용하세요. AppLovin은 광고주가 AppLovin Pixel과 함께 Conversion API를 사용할 것을 권장합니다. 이를 통해 최적의 캠페인 성과를 달성할 수 있습니다.

요청 형식

Conversion API에 하나 이상의 이벤트를 제출하려면 https://b.applovin.com/v1/event로 HTTP POST 요청을 보내세요.

인증

쿼리 파라미터

응답 코드

POST 페이로드

HTTP 요청의 POST 페이로드는 제출하는 이벤트를 설명합니다:

서버 이벤트

이벤트 데이터

각 이벤트의 data 필드를 채우는 방법은 이벤트 및 오브젝트를 참조하세요. 이 링크에 문서화된 이벤트 외에도 아래에서 지원되는 추가 이벤트를 확인할 수 있습니다.

선택적 이벤트

app_open 이벤트 (모바일 앱 연동 전용)

사용자가 앱을 시작할 때 이 이벤트를 트리거합니다. 이 이벤트에 대해 전달할 데이터 객체는 없습니다.

User data

측정 데이터

aleid 전송

aleid는 사용자가 AppLovin 광고를 클릭한 후 AppLovin이 웹사이트 URL에 추가하는 쿼리 파라미터입니다.

이 파라미터의 존재 여부를 사용하여 어떤 클릭이 AppLovin에서 발생했는지 식별하세요.

aleid를 전송하려면 다음 중 하나를 수행할 수 있습니다.

• 사이트에 AppLovin Pixel이 설치되어 있는 경우, AppLovin Pixel은 aleid 쿼리 파라미터를 감지하면 자동으로 _axeid 쿠키를 설정합니다. 해당 쿠키가 있을 때마다 그 값을 읽어 aleid 쿼리 파라미터의 값으로 요청에 포함하여 전송하세요.
• aleid URL 쿼리 파라미터가 있는 것을 확인하면 해당 값을 가져옵니다. 서버에서 aleid 쿼리 파라미터를 감지하면 서버 측에서 파라미터를 읽습니다. AppLovin은 이를 사이트에 이름이 _axeid인 HTTP 쿠키로 설정할 것을 권장합니다. 이 쿠키의 만료 시간은 1년으로 설정하세요. 이전 방법과 마찬가지로, 해당 쿠키가 있을 때마다 그 값을 읽어 aleid 쿼리 파라미터의 값으로 요청에 포함하여 전송하세요.

사용자 식별자 전송

client_id

사이트에 AppLovin Pixel이 설치되어 있지 않은 경우, 방문자를 식별하기 위해 저장하는 다른 안정적인 퍼스트 파티 쿠키를 전달하세요. 이는 전역적으로 고유해야 하며 사용자의 브라우징 세션 전반에 걸쳐 동일하게 유지되어야 합니다.

axwrt

사이트에 AppLovin Pixel이 설치되어 있는 경우, AppLovin Pixel은 자동으로 _axwrt 쿠키를 설정합니다.

alart

앱 사용자의 경우, alart URL 쿼리 파라미터가 있는 것을 확인하면 해당 값을 가져옵니다.

user_id

시스템 내 고객의 고유 식별자입니다. 이는 사용자 세션 전반에 걸쳐 일관되게 유지되는 안정적인 식별자여야 합니다.

email

사용자의 이메일 주소. AppLovin은 개인정보 보호를 위해 이 값을 SHA-256을 사용하여 자동으로 해싱합니다. AppLovin의 가이드라인에 따라 식별자를 사전 처리하는 경우 자체 SHA-256 해시를 제공할 수도 있습니다.

phone

사용자의 전화번호. AppLovin은 개인정보 보호를 위해 이 값을 SHA-256을 사용하여 자동으로 해싱합니다. AppLovin의 가이드라인에 따라 식별자를 사전 처리하는 경우 자체 SHA-256 해시를 제공할 수도 있습니다.

페이로드 예시

[
  {
    "event_time": 1741784485001,
    "event_source_url": "https://applovin.com",
    "name": "purchase",
    "user_data": {
      "client_ip_address": "172.59.8.172",
      "client_user_agent": "chrome/123.456 android mobile",
      "aleid": "_aleid-query-param",
      "axwrt": "_axwrt-cookie-value",
      "email": "user@example.com",
      "phone": "+11234567890",
      "user_id": "customer_12345",
      "client_id": "_first_party_identifier",
      "sid": "sid",
      "ifa": "idfa",
      "idfv": "idfv",
      "os": "macos",
      "esi": "web",
      "zip": "12345",
      "country_code": "US"
    },
    "measurement_partner_data": {
      "is_claimable": true,
      "attribution_model": "LAST_CLICK",
      "attribution_lookback_window_hours": 24,
      "attribution_share": 0.5,
      "accounting_mode": "ACCRUAL",
      "campaign_id": "456",
      "creative_set_id": "789",
      "is_new_customer": false,
      "last_purchase_ts": null,
      "is_new_visitor": true,
      "last_visit_ts": 1
    },
    "data": {
      "user_id": "customer_12345",
      "currency": "USD",
      "value": 30,
      "transaction_id": "txn_abc123_20250120",
      "shipping": 5.99,
      "tax": 6,
      "items": [
        {
          "item_variant_id": "SKU-123-M",
          "item_id": "PROD-456",
          "item_name": "T-Shirt",
          "affiliation": "affiliation",
          "item_brand": "item_brand",
          "item_category": "item_category",
          "item_category_id": 604,
          "item_category2": "item_category2",
          "image_url": "image_url",
          "price": 15,
          "discount": 10,
          "quantity": 2
        }
      ]
    }
  }
]