인앱 이벤트 포스트백 설정

앱스플라이어의 인앱 이벤트 기록은 광고주와 애드 네트워크 모두에게 유익한 강력한 기능입니다.

이벤트를 기록함으로써, 광고주는 서로 다른 소스에서 유입된 사용자의 전반적인 퀄리티를 측정하고 그에 따라 유저 유입 전략을 수립할 수 있습니다.

애드 네트워크는 인앱 이벤트 정보를 사용하여 자체 광고 기능을 최적화하고, cost-per-action/event 캠페인을 운영할 수 있습니다.

애드 네트워크는 포스트백을 통해 인앱 이벤트에 대한 데이터를 수신합니다. 포스트백은 모든 성공적인 또는 실패한 전환에 대해, 앱스플라이어가 네트워크에 전송하는 URL입니다. 이 안내에서는 인앱 이벤트 포스트백과 앱스플라이어 대시보드에서 어떻게 이를 설정하는지에 중점을 두고 있습니다.

인앱 이벤트 관련 더 깊은 정보나 사용 가능한 이벤트의 전체 목록에 대해서는 여기를 클릭하십시오.

인앱이벤트 포스트백 윈도우

인앱 이벤트 포스트백 윈도우를 통해 CPA (cost-per-action) 기반 네트워크와 협업하는 광고주가 전환 이후 윈도우를 설정하여, 그 이후에는 포스트백이 더 이상 발송되지 않도록 할 수 있습니다.

예를 들어, 광고주가 앱을 설치한 후 15일 이내에 발생한 이벤트에 대해서만 청구된다면, 이런 윈도우 설정은 다음과 같습니다.

15 day in-app event postback window

이 기간 이후에는 포스트백이 전송되지 않고, 네트워크에는 알림이 전달되지 않습니다. 하지만 이벤트는 여전히 앱스플라이어에 기록되고 해당 네트워크로 어트리뷰션 됩니다.

포트스백은 항상 현재의 윈도우 설정을 기반으로 전송됩니다. 다음 예시를 참조하십시오.

1월 1일

윈도우는 15일 입니다.

한 사용자가 앱을 설치했습니다.

1월 2일 윈도우가 10일로 변경되었습니다.
1월 14일

해당 사용자가 구매를 합니다.

포스트백은 애드 네트워크로 발송되지 않습니다.
왜냐하면 이벤트가 현재의 윈도우 설정(10일)에 속하지 않기 때문입니다.

1월 15일

윈도우가 20일로 변경되었습니다.

1월 18일

해당 사용자가 또다른 구매를 합니다.

포스트백이 발송되었습니다. 왜냐하면 이벤트가 현재의 윈도우 설정(20일)에 속하기 때문입니다.

기본 설정

특정 파트너와 인앱 이벤트 포스트백을 2019년 7월 30일 이전에 시작했다면, 윈도우 값 기본 설정은 Lifetime 입니다. 즉, 인앱 이벤트 포스트백이 항상 전송되는 것을 의미합니다.

막 포스트백을 설정했다면, 기본 윈도우는 자동으로 180일로 설정됩니다.

누가 포스트백 윈도우를 설정할 수 있습니까?

윈도우는 다음과 같은 방법으로 설정될 수 있습니다.

  • 광고주
  • 에이전시. Allow to configure in-app event postbacks 권한을 부여받은 경우.
    참고: 광고주와 에이전시가 동일한 애드 네트워크와 협업한다면, 각각은 해당 네트워크와의 각자 계약에 따라, 포스트백 윈도우를 서로 별도로 설정할 수 있습니다.
  • 애드 네트워크. Allow to configure in-app event postbacks 권한을 부여받은 경우.

이벤트 설계

코드에서는 동일한 유형의 이벤트이지만, 서로 다른 광고주들은 각기 다른 이름을 붙일 수 있습니다. 광고주에 의해 사용되는 이벤트 이름은 또한 미디어 소스들에 의해 주어진 이름과 상이할 수 있습니다. 예를 들어, 사용자가 앱을 통해 무엇인가를 구매하는 경우, 한 광고주는 이를 purchase 라고 부르고, 다른 광고주는 purchase_event 라고 부를 수 있습니다. 애드 네트워크는 표시가 덜 나는 ID를 사용할 수도 있습니다. 예, event5.

이런 경우, 대부분의 애드 네트워크는 purchaseevent5 와 동일한 이벤트가 맞는지 확실히 확인하고 싶어합니다. 이것이 왜 앱스플라이어 대시보드에서 협업하는 각 미디어 소스별로 반드시 이름이 매핑되어야 하는지 이유입니다.

 참고

이벤트 이름은 대소문자를 구분합니다. 수치 차이를 피하려면, 모든 미디어 소스 및 앱 버전에서 정확한 이벤트 이름을 사용하십시오.

매핑 방법

이벤트를 매핑할 수 있는 세 가지 방법이 있습니다. 각 애드 네트워크는 각자의 선호 방식이 있으며, 애드 네트워크와 상의해보십시오. 또한 애드 네트워크가 자사 네트워크에 스스로 매핑할 수 있도록 권한을 부여할 수도 있습니다. 다음 섹션에서 권한 부여 방법에 대해 참고하십시오.

텍스트 필드에 이벤트 ID 입력하기

  • 이벤트 이름(SDK event name): 목록의 앱 이벤트 중에서 이벤트를 선택합니다.
  • 파트너 이벤트 이름(Partner event identifier): 파트너로부터 수신한 해당 ID를 입력합니다.

in-app-postback_type-in.png

목록에서 이벤트 ID 선택하기

애드 네트워크는 수신하고자 하는 이벤트 목록을 앱스플라이어에 사전 정의했습니다.

  • 이벤트 이름(SDK event name): 목록의 앱 이벤트 중에서 이벤트를 선택합니다.
  • 파트너 이벤트 이름(Partner event identifier): 파트너 이벤트 드롭 다운 목록에서 가장 적합한 이벤트를 선택합니다.

in-app-postback_dropdown.png

이벤트 있는 그대로 전송하기

어떤 네트워크는 이벤트를 있는 그대로 수신하는 것을 선호합니다. 다시 말해, 이벤트가 purchaseacquisition 또는 event5 어떻게 불리어도 상관하지 않습니다.

이 경우, 다음 두 옵션 중 하나를 선택할 수 있습니다.

  • 모든 이벤트 리포트하기
  • 전송을 원하는 이벤트를 수동으로 선택하기

참고: 모든 이벤트를 리포트 하기로 선택했더라도, af_app_opened 이벤트는 리포트 되지 않습니다.

in-app-postback_as-is-send-all.png

만약 수동으로 이벤트를 추가하도록 선택했다면, 이벤트 추가 를 클릭하고, 전송을 원하는 이벤트를 선택합니다. 더 많은 이벤트를 추가하려면, 과정을 반복합니다.

in-app-postback_as-is.png

인앱 이벤트 매핑 관련 상세 내용은, 여기를 클릭하십시오.

 

보내기 옵션

각 이벤트에 대해, 어떤 경우에 포스트백을 보낼지 선택할 수 있습니다.

  • This partner only: 이벤트가 해당 파트너로 어트리뷰션된 경우에만 포스트백을 전송합니다.
  • Send all events: 오가닉 이벤트를 포함하여 모든 파트너로 어트리뷰션된 이벤트의 포스트백을 전송합니다.

만약 모든 이벤트를 "있는 그대로" 전송하기로 선택했다면, 여기에서 선택한 보내기 옵션이 모든 이벤트에 적용됩니다.

이벤트 데이터 보내기

어떤 종류의 이벤트 데이터를 애드 네트워크에 포스트백으로 공유할지 선택할 수 있습니다. 다음 옵션 중 하나를 선택하십시오.

  • No values & no revenue: 이벤트 값(event value)를 제외하고 이벤트만 전송합니다.
  • Values & no revenue: 매출 값을 제외한 모든 파라미터를 전송합니다.
  • Values & revenue: 매출 값(이벤트에 존재하는 경우)을 포함하여 모든 이벤트 파라미터를 전송합니다.

포스트백에서, af_revenue 와 af_currency 는 event_value json 파일 외부에 monetary 와 currency로 기록되므로, 별도로 전송될 수 있습니다.

참고: 옵션을 no value 또는 no revenue 중 하나로 선택했을 때, 해당하는 파라미터는 N/A로 가려집니다.

 예시

어떤 광고주가 다음 event_value를 포함하여 구매 이벤트를 전송합니다: {af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}

각 데이터 보내기 옵션에 따라, 파라미터를 전송하는 방법입니다.

  • No values & no revenue
    • event_value: N/A
    • monetary: N/A
    • currency: N/A
  • Values & no revenue

    • event_value: {af_revenue: N/A, af_currency: N/A, af_level=2, af_receipt_id=57601333}
    • monetary: N/A
    • currency: N/A
  • Values & revenue

    • event_value: {af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}
    • monetary: 50.87
    • currency: USD

커스텀 이벤트

매핑할 수 있는 이벤트 목록은 SDK에 의해 앱스플라이어에 리포트된 경우에만 표시됩니다. 매핑을 원하는 이벤트가 드롭 다운 목록에 표시되지 않는다면, 다음 원인일 수 있습니다.

  • 아직 이벤트를 수행한 사용자가 없습니다.
  • 마지막으로 이벤트가 수행된 시점이 2주보다 더 이전입니다.
  • 활성 이벤트 목록이 너무 많은 경우입니다.

이런 경우에는 애드 네트워크 ID에 이벤트를 매핑하려면, 다음처럼 진행합니다.

  1. 이벤트 이름을 타이핑하여 입력합니다.
  2. 커스텀 생성 을 클릭합니다.

    in-app-postback_custom.png

  3. 이벤트를 파트너 이벤트 이름에 매핑합니다.
  4. 저장을 클릭하여 매핑이 기록되었는지 확인합니다.

참고. 특정 파트너 아래에서 이벤트를 이 방식으로 추가한 경우, 이 이벤트는 사용자가 연동한 다른 모든 파트너의 이벤트 목록에도 추가됩니다. 즉, 다른 파트너와의 연동에는 드롭 다운 목록에서 이 이벤트를 볼 수 있고, 보통 때처럼 매핑하면 됩니다.

에이전시 및 애드 네트워크는 커스텀 이벤트를 추가할 수 없으며, 광고주가 커스텀 이벤트를 추가하고 에이전시 또는 애드 네트워크에 관련 권한을 부여한 경우에만 이 이벤트를 확인하고, 매핑할 수 있습니다.

애드 네트워크에 의한 이벤트 매핑

광고주는 또한 애드 네트워크가 직접 이벤트를 매핑하고, 스스로 포스트백을 비활성화하도록 허용할 수 있습니다. 이를 위해, 광고주는 애드 네트워크에 관련된 권한을 부여해야합니다.

  1. 파트너 연동 페이지에서 권한을 부여하려는 파트너를 찾습니다.
  2. 권한 탭에서 Allow to configure in-app event postbacks 토글을 ON으로 켭니다.

adnetwork-permissions-postbacks.png

애드 네트워크가 권한을 받고나면, 애드 네트워크는 텍스트 필드에 이벤트 ID 입력하기 항목에 설명된 안내에 따라 이벤트를 매핑할 수 있습니다.

에이전시에 의한 이벤트 매핑

에이전시에게 인앱 이벤트 포스트백을 설정할 수 있는 권한을 부여하려면:

  1. 연동 파트너 목록에서 에이전시를 찾습니다.
  2. 에이전시가 모든 이벤트를 공유할 수 있을지 특정 파트너에 어트리뷰션된 이벤트만 공유할 수 있을지 선택합니다.
  3. 에이전시가 이벤트 매출을 보낼 수 있는지 여부를 선택합니다.
  4. 에이전시가 공유할 수 있도록 허가된 특정 이벤트를 선택합니다.

agency-events.png

도움이 되었습니까?