Lead gen용 Conversion API

Conversion API를 사용하여 웹사이트의 lead gen 이벤트를 전송하십시오. AppLovin은 광고주가 최적의 캠페인 성과를 달성할 수 있도록 AppLovin Pixel과 함께 Conversion API를 사용할 것을 권장합니다.

Request format

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

Authentication

Query parameters

AppLovin dashboard의 Keys 섹션에서 AppLovin Event Key 및 Conversion API Key를 획득하십시오.

Response codes

POST payload

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

Server event

Event data

data는 모든 이벤트에 필수입니다.

• page_view의 경우, data를 null로 설정하십시오.

• generate_lead의 경우, 항상 { "currency": "«ISO-4217»", "value": «number» }를 전송하십시오.

Optional events

app_open 이벤트는 모바일 앱 연동 전용입니다. 사용자가 앱을 시작할 때 이 이벤트를 트리거하십시오. 이 이벤트에 대해 전달할 data 객체는 없습니다.

User data

Sending aleid

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

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

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

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

Sending user identifiers

client_id

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

axwrt

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

alart

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

user_id

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

email

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

phone

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

Example payloads

Page view event

{
  "events": [
    {
      "event_time": 1741784485001,
      "event_source_url": "https://applovin.com",
      "name": "page_view",
      "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",
        "user_id": "_user_id",
        "phone": "+1123456789",
        "email": "user@example.com",
        "client_id": "_first_party_identifier",
        "sid": "sid",
        "ifa": "idfa",
        "idfv": "idfv",
        "os": "macos",
        "esi": "web",
        "zip": "12345",
        "country_code": "US"
      },
      "data": null
    }
  ]
}

Generate lead event

{
  "events": [
    {
      "event_time": 1741784485001,
      "event_source_url": "https://applovin.com",
      "name": "generate_lead",
      "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",
        "user_id": "_user_id",
        "phone": "+1123456789",
        "email": "user@example.com",
        "client_id": "_first_party_identifier",
        "sid": "sid",
        "ifa": "idfa",
        "idfv": "idfv",
        "os": "macos",
        "esi": "web",
        "zip": "12345",
        "country_code": "US"
      },
      "data": {
        "currency": "USD",
        "value": 30
      }
    }
  ]
}