인앱 이벤트 - 개요

구매나 항공편 예약과 같은 인앱 이벤트를 발송할 때마다 예약 관련된 수익과 함께 발송하세요. 인앱 이벤트에서 수익을 포함하는 유일한 파라미터는 바로 af_revenue입니다.

• SDK에서 수익 기록하기
• Unity에서 수익 기록하기

사용자가 구입을 취소하거나 구매 환불을 받을 경우 음의 수익을 기록할 수 있습니다. 음의 수익을 기록하려면 하기 위해 수익 값에 마이너스(-) 기호를 추가하세요. 감사합니다! af_revenue에 넘깁니다.

af_revenue는 사용자의 수익을 누적하는 유일한 파라미터입니다. 귀사의 유저 수익을 항상 인앱 이벤트와 함께 사용하세요, 비즈니스 로직에서 실제 수익을 창출하는 경우에.

af_revenue는 취소된 거래나 환불과 같은 이벤트를 기록할 필요가 있을 경우, 음의 수익 값도 가질 수 있습니다. 환불

수익 값은 숫자(소수점 포함)만 포함해야 합니다. (필수)

• 다른 문자를 포함하지 마세요. 및 다른 방식으로 수익 값을 형식화하지 마세요. 이를 위해 쉼표, 통화 기호(예: $), 특수 문자 또는 텍스트를 포함하지 마세요.
• 앱스플라이어는 수익 값을 최대 소수점 다섯 자리까지의 정밀도로 제공합니다.
• 이 값의 범위는 -1,000,000에서 1,000,000까지이며, 인도 달러 또는 해당되는 원래 통화 금액이어야 합니다. 값 이 범위를 벗어날 경우, 로데이터 리포트에는 포함되지만, 종합 리포트에는 포함되지 않습니다.
• 예시: 1234.56
• 수익이 문자열로 전송되면, 따옴표 안의 값은 그대로 전송됩니다. 점수는 유효해야 합니다. 예를 들어: "1234.56".

참고:

• SDK에서 발송된 정확한 수익을 앱스플라이어가 표시합니다. 여기에는 VAT나 애플 앱 스토어 수수료에 대한 계산이 포함되지 않으며, 개발자가 SDK에 이를 포함하지 않는 한, 해당 계산은 앱스플라이어로 전송되기 전에 이루어지지 않습니다. 사이드에서 앱스플라이어로 전송되기 전에.

af_currency 는 af_revenue(또는 af_price)에 표시된 통화를 나타냅니다. 명시 된 af_revenue(또는 af_price)에서. 이벤트의 파라미터에 af_currency가 없으면, 이벤트의 앱스플라이어는 기본값 "USD"를 사용하여 이를 발송합니다.

af_price는 수익으로 계산되지 않는 금전적 파라미터로 사용할 수 있습니다 (예: "장바구니에 담기" 이벤트). 그 은 수익으로 계산되지 않습니다(예: "장바구니에 담기" 이벤트). this); } } 파라미터는 개별 항목의 가격을 나타냅니다. 총 금액 모든 구매의 총 금액은 af_revenue 파라미터에 나타납니다.

광고주는 캠페인을 최적화하다를 위해 예상 수익을 사용합니다. 유저 수명 주기의 초기 단계에서 잠재적인 유저 가치를 예측합니다. 예상 수익은 유저의 이전 상호작용과 행동에 기반하여 계산됩니다. 유저의 이전 상호작용 및 행동. 참고: 앱스플라이어 지원 팀에 문의하여 귀사의 애드 네트워크가 예상 수익을 지원하는지 확인하세요. 예상 수익.

예상 수익은 어떻게 앱스플라이어에 리포팅되어야 합니까? 앱스플라이어?

앱스플라이어에 예상 수익을 리포팅할 때, 이를 별도로 발송해야 합니다. 인도 이벤트는 별개로 처리해야 합니다. 실제 수익이 포함된 이벤트와 구분되어야 합니다. 광고주는 다음을 확인해야 합니다.

• 실제 수익이 포함된 이벤트와 예상 수익이 포함된 이벤트는 별개로 보고되어야 합니다.
• 예상 수익 데이터는 이벤트 값에 포함됩니다, 예를 들어: 예:

      "event_value": {
          "af_projected_revenue": 0.79
      }

앱스플라이어 대시보드 및 리포팅에서의 예상 수익

• 예상 수익은 포함되지 않습니다. 총 수익 계산이나 측정 지표 는 앱스플라이어 대시보드에 표시되지 않습니다. 이렇게 하면 대시보드가 실제 수익만을 반영한다는 것을 보장합니다.
• 로데이터에서 예상 수익은 리포팅되지 않습니다. 전용 필드로 제공되지 않고 이벤트 값에 포함되어 있으며, 광고주가 발송한 수익 금액이 포함되어 있습니다.

예상 수익 포스트백 발송

예상 수익 포스트백을 애드 네트워크로 발송하는 방법은 참조하세요. 프로젝트 수익 공유.

앱스플라이어가 통화 설정과 통화 전환을 어떻게 처리하는지 이해하는 것이 중요합니다. .

앱스플라이어는 앱 설정 통화와 별개로 인앱 이벤트 통화 사이의 차이를 통화 전환을 사용하여 처리합니다.

위의 다이어그램은 다음의 과정을 보여줍니다:

1. 인앱 이벤트가 발송됩니다. 각 이벤트마다 서로 다른 통화가 사용됩니다.
2. 앱스플라이어는 모든 통화를 USD로 전환합니다.
3. 앱스플라이어가 수익 데이터를 처리합니다.
4. 대시보드의 수익 데이터는 앱 설정에서 표시됩니다. 통화
5. 앱스플라이어는 로데이터 리포트에 수익 데이터를 채웁니다. 이벤트 및 앱 설정 통화로

앱스플라이어는 Open Exchange Rates를 사용하여 통화 전환을 처리합니다. . 환율은 1시간마다 업데이트됩니다. 기본적으로 적용됩니다. 앱스플라이어는 통화 전환을 수행할 때마다 마지막 매시간 업데이트된 환율을 사용합니다.

통화 전환

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

통화 표시

통화는 앱 설정에서 설정됩니다. 앱 설정에서 귀사가 설정한 통화가 그 대시보드에 표시됩니다. 발송되는 인앱 이벤트의 통화와는 상관없이 이벤트의 수익은 항상 대시보드에서 설정한 통화로 표시됩니다. 앱 설정에서 설정한 통화로 표시됩니다.

측정할 인앱 이벤트를 판단한 후, 인앱 이벤트 생성기를 사용하여 다음과 같이 이벤트와 파라미터를 정의하세요:

1. 기록하려는 시나리오에 가장 적합한 이벤트 이름을 선택하세요.
2. 이벤트와 연관시킬 이벤트 파라미터를 선택하세요. 이벤트에 추가 정보를 제공하고 데이터를 풍부하게 할 파라미터를 선택하세요.
3. 인앱 이벤트 생성기에서 완료된 파일을 다운로드하여 개발자와 공유하세요.

다음 표는 업종별, 앱 카테고리별로 기록하기를 제안하는 일반적인 인앱 이벤트의 예와 흐름을 포함한 문서 링크를 제공합니다.

업종별, 앱 카테고리별	문서 제목
	추천 게임 앱 이벤트
	추천 이커머스 앱 이벤트
	추천 엔터테인먼트 앱 이벤트
	추천 금융 및 뱅킹 앱 이벤트
	추천 P2P 대출 앱 이벤트
	추천 온라인 교육 앱 이벤트
	추천 승차 호출 앱 이벤트
	추천 항공편 예약 앱 이벤트
	추천 호텔 예약 앱 이벤트
	추천 헬스케어 앱 이벤트
	추천 통신 앱 이벤트
	추천 eWallet 앱 이벤트
	추천 스포츠 베팅 이벤트

인앱 이벤트는 유저의 생애동안 인스톨한 미디어 소스에 속합니다. 이벤트 데이터는 유저 생애 가치 (LTV) 또는 액티비티 데이터로 표시됩니다. 

다음 장소에서 귀사의 인앱 이벤트 데이터를 확인할 수 있습니다.

• 대시보드 개요 페이지: 실시간 유저 생애 가치 (LTV) 유저 유입 (UA) 성과가 표시됩니다. 참고: 여기에는 인앱 이벤트를 통해 보고된 오가닉 및 논오가닉 사용자 간에 나뉜 수익과 이중 어트리뷰션이 적용된 리타겟팅 수익이 포함됩니다.
• 이벤트 페이지: 매체 소스 전반의 LTV 인앱 이벤트 성과를 보여줍니다.
• 활동 페이지: 선택한 기간 동안의 인앱 액티비티를 보여줍니다.

• 로데이터 인앱 이벤트 리포트: 유저 전체의 활동을 연대순으로 나열한 목록입니다. 이 리포트에는 예시로 이벤트 파라미터 값이 포함됩니다.

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  로데이터 리포팅은 프리미엄 기능입니다.

앱에서 이벤트 이름과 파라미터를 정의할 때 다음 사항에 유의하세요.

• 로데이터 리포팅의 데이터 일관성을 위해 모든 플랫폼에서 동일한 인앱 이벤트 이름과 구조를 정의하고 사용하실 것을 권장합니다.
• 다양한 소스에서 오는 사용자 품질을 쉽게 비교할 수 있도록 최소한의 이벤트만 사용하세요.
• 사용자 정보 보호를 보장하는 것이 중요합니다. 인앱 이벤트 값을 직접 식별할 수 있는 제한된 데이터로 채우지 마세요. 예를 들어, 이메일 주소, 이름, 주민등록번호, 또는 일부 지역의 우편번호입니다. 제한된 데이터에 대한 자세한 정보는 서비스 개인정보 보호정책을 참조하세요.
• 앱스플라이어는 참여 시 기기의 IP 주소를 포함합니다. 일부 관할권이나 사용 시나리오에서는 IP 주소가 PII로 간주될 수 있습니다. 광범위한 지리적 위치(도시, 지구 수준)를 알아내기 위하여 IP 주소를 사용하며, 특정 주소는 사용하지 않습니다. 필요한 경우, IP 주소를 마스킹하여 로데이터 리포트에 나타나지 않도록 선택할 수 있습니다. 
• 인앱 이벤트는 앱스플라이어의 유일한 수익 데이터 소스입니다. 각 이벤트에 특정 수익 값을 첨부하고 이를 귀사의 앱 대시보드에서 볼 수 있습니다. 수익화 파라미터에 대해 더 알아보세요. altrevenue_data.pngalt

앱에서 이벤트 이름과 파라미터를 정의할 때 다음 사항에 유의하세요.

• 인앱 이벤트 이름에 소문자 영숫자(a-z 및 0-9)만을 사용하는 것이 권장됩니다. 이벤트 이름은 대소문자를 구분합니다. 즉, af_purchase와 af_PURCHASE는 로데이터에서 서로 다른 두 이벤트입니다. 그러나 종합 리포트와 대시보드(예: 개요 또는 이벤트)에서는 소문자만 허용되므로 단일 이벤트로 표시될 수 있습니다.
• 하루에 최대 300개의 고유 이벤트 제한이 있습니다. 더 보기
• 고유 사용자는 앱을 인스톨 후 처음 100개 이벤트에서만 계산됩니다.
• 이벤트 이름은 다음 문자로 시작할 수 없습니다: " = + -
• 이벤트 값에는 인코딩된 URL이나 ASCII로 인코딩된 경우를 제외하고는 + 문자가 포함되어서는 안 됩니다.
• 이벤트 이름에는 빈 공간을 포함할 수 없습니다. 이벤트 이름 앞이나 뒤에 밑줄(낮은 대시)을 사용할 수 있습니다.
• 로데이터 리포트에서 값이 잘리는 것을 방지하려면 이벤트 값이 2,000자를 넘지 않아야 합니다. 그러나 SDK에서 발생한 이벤트라면 HTTP 요청으로 전송 시 페이로드가 잘리지 않도록 1,000자 이하로 유지하는 것이 좋습니다.
• 이벤트 값으로 참조 URL을 포함하는 경우 URL 인코딩해야 합니다.
• Meta Ads에는 이벤트 이름과 파라미터에 대한 일부 제한이 있습니다. 제한 사항에 대한 내용은 여기에서 읽어보세요.

어떤 파라미터 이름과 이벤트와 함께 수익 값을 발송할 수 있습니다. 그러나 앱스플라이어 로데이터와 데이터 집약형 데이터에 수익 (포함 음수 수익 )을 등록하기 위해서는 반드시 af_revenue 파라미터를 사용해야 합니다. 항상 귀사의 비즈니스 로직에서 실제 수익 창출을 나타내는 인앱 이벤트와 함께 사용하세요.

af_currency는 af_revenue(또는 af_price)에 명시된 통화를 나타냅니다. 이벤트 파라미터에 af_currency가 없을 경우 앱스플라이어는 이를 기본값인 "USD"와 함께 발송합니다.

af_revenue 파라미터에 대한 자세한 정보는 수익 어트리뷰션 가이드를 참조하세요.

인앱 이벤트는 앱 설치의 원래 미디어 소스에 어트리뷰션됩니다.

앱을 인스톨할 때 (첫 번째 앱 실행), 앱스플라이어는 다양한 어트리뷰션 방법을 사용하여 인스톨의 어트리뷰션을 판단합니다. 동시에 앱스플라이어 SDK가 어트리뷰션 세부 정보와 연결된 새로운 고유한 앱스플라이어 ID를 생성합니다.

앱 내 같은 디바이스에서 발생하는 모든 후속 인앱 이벤트에는 이 ID가 있습니다. 이를 통해 앱스플라이어는 이벤트를 원래 미디어 소스에 어트리뷰션할 수 있습니다. 광고주는 이를 사용하여 앱 내 유저 여정을 추적할 수 있습니다.

최근 리타겟팅된 사용자의 이벤트에는 이중 어트리뷰션이 있을 수 있습니다.

앱스플라이어는 다음과 같은 경우 인스톨 이벤트를 오가닉으로 어트리뷰션합니다.

• 인스톨 일로부터 24개월 이상 경과
• 매체 소스의 약관에 사용자 수준 데이터 삭제가 명시되어 있을 때
• 사용자가 디바이스에 저장된 앱 데이터를 삭제하면 새로운 앱스플라이어 ID가 생성됩니다.

사용자가 인터넷 연결이 없는 상태에서 이벤트를 시작하면 앱스플라이어는 여전히 이를 기록할 수 있습니다. 작동 방식은 다음과 같습니다:

1. SDK는 이벤트를 앱스플라이어 서버로 전송하고 성공적인 응답을 기다립니다.
2. SDK가 성공적인 응답을 받지 못하면 이벤트는 캐시에 저장됩니다.
3. 다음에 성공적인 응답이 오면 저장된 이벤트가 다시 서버로 전송됩니다.
4. 캐시에 여러 이벤트가 있을 경우, 이벤트는 순차적으로 서버로 전송됩니다.

복잡한 인앱 이벤트는 단일 API 호출로 여러 이벤트 발송을 가능하게 합니다.

여러 가지 밀접하게 관련된 사용자 작업을 그룹화하여 보고 싶을 때 유용합니다. 예를 들어, 단일 세션에서 여러 제품을 장바구니에 추가하는 경우가 있습니다.
예시:

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

하나의 거래에 여러 항목을 추가할 수 있습니다. 이벤트 파라미터당 단일 값을 사용하는 대신, 쉼표로 구분하여 거래를 설명하는 항목의 배열을 사용할 수 있습니다. 형식은 JSON 문자열이어야 합니다.

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

인앱 이벤트 중복 제거 메커니즘이 있습니다. 모든 인앱 이벤트를 확인하여 10초 안에 동일한 appsflyer_id에서 발생한 인앱 이벤트가 있는지 확인합니다. 이러한 이벤트가 발견되면, 중복을 제거합니다.

두 이벤트의 다음 필드가 동일한 경우, 두 이벤트는 동일한 것으로 간주됩니다.

• 이벤트 이름
• 이벤트 값
• 앱 ID
• 앱스플라이어 ID

앱스플라이어는 다른 지시, 요구 또는 법률에 따라 달리 명시되지 않는 한 24개월 동안 사용자 수준(로데이터)을 보관합니다. 일부 SRN/파트너는 앱스플라이어를 포함한 어트리뷰션 제공자에게 24개월 기간 전에 SRN/파트너 관련 사용자 수준 데이터를 삭제하도록 요구합니다.

삭제 이후에는 삭제된 사용자와 관련된 이벤트가 오가닉으로 표시됩니다. 기존 집계 데이터는 변경되지 않습니다. 자세한 내용은 데이터 보관 및 삭제 의무를 참조하세요.

• 안드로이드 SDK와 iOS SDK는 자동으로 OS(운영 체제) 매개변수를 추가합니다.
• S2S API의 경우 2021년 7월 1일부터 iOS 앱에 대해 OS(운영 체제) 매개변수를 발송해야 합니다. 이 매개변수를 발송하지 않으면, 데이터는 iOS 14.5 사용자로부터 온 것으로 간주되어 로데이터 제공 방법에 영향을 미칩니다.