포스트백 설정

Overview

Branch는 전환(설치 또는 기타 이벤트)을 측정할 때 액션 생성에 기여한 애드네트워크 또는 파트너를 결정한 뒤 그에 따라 적절한 파트너에게 크레딧을 어트리뷰션합니다. Universal Ads(광고 어트리뷰션) 연동 파트너를 사용하도록 설정하면 켜지는 포스트백 기능을 통해 Branch는 이러한 이벤트 데이터를 파트너에게 전송할 수 있습니다.

Branch의 포스트백 시스템은 커스터마이제이션 수준이 매우 높습니다. 링크 데이터, 유저 데이터 또는 이벤트 속성으로 필터링된 특정 이벤트 및 이벤트의 특정 하위 섹션에 대한 포스트백을 설정할 수 있습니다.

📘

포스트백 vs 웹훅

PostbacksWebhooks 라는 용어는 모두 다른 시스템으로 데이터를 보내는 동일한 프로세스를 나타내는 데 사용됩니다. Branch의 경우 Universal Ads(광고 어트리뷰션) 제품에 대해서 postback 라는 용어를 사용하고 데이터 피드 제품에 대해서는 webhook 이라는 용어를 사용합니다. 기능은 똑같습니다.

포스트백 템플릿

Universal Ads(광고 어트리뷰션) 파트너는 사전 정의된 포스트백 템플릿을 지원하여 적절한 포스트백 URL 생성을 단순화할 수 있습니다. 추가 정보(예: 이벤트별 목표 ID)가 필요한 경우 Branch는 포스트백 URL에 자동으로 추가될 해당 정보를 입력할 수 있는 빈 필드를 표시합니다.

추가/활성화

광고 파트너를 활성화하면 설치구매와 같은 이벤트에 대해 기본 포스트백이 자동으로 활성화됩니다. 그런 다음 다른 포스트백을 추가할 수 있습니다 (예 : Account Created와 같이 앱에 특정한 커스텀 이벤트에 대한 포스트백을 추가하려는 경우).

포스트백을 추가하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 화면 하단의 Add New Postback 버튼을 클릭합니다.
  4. Branch 스탠다드 이벤트 및 설정한 커머스(구매와 같은 저장된 이벤트) 또는 커스텀 이벤트와 함께 선택창이 나타날 것입니다. 이벤트를 선택하고, 매체에서 요청한 경우 포스트백 URL을 입력한 뒤 Save를 클릭합니다. 이 이벤트가 발생하면 새로운 포스트백이 트리거될 것입니다.
    1. 참고: Branch에 파트너에 대한 포스트백 템플릿이 없으면 각 파트너에게 유효한 URL을 확인하여 입력하세요.

🚧

iOS 14.5 이후 설치 이벤트 관련 변경 사항

Apple은 AppTrackingTransparency 프레임워크를 통해 디바이스 데이터 공유에 대한 유저 동의를 받도록 요구합니다. 설치가 유료 광고를 통해 발생되었을 때, 첫 번째 설치는 오가닉으로 기록되며, 유저 동의 후 두 번째 설치 이벤트가 기록되고 해당 유료 광고로 어트리뷰션 됩니다.

설치 이벤트는 옵트인 전까지 지연되므로 옵트인이 설치 이벤트에 영향을 줍니다. 옵트아웃된 유저는 data를 사용할 수 없습니다. 파트너 시스템에서 중복 설치 이벤트를 제거하려면 다른 식별자 (예: IDFV)를 사용하는 것이 좋습니다.

iOS 14.5 이후의 변경 사항에 대한 추가 정보는 FAQ 페이지를 참조하십시오

imageimage

비활성화

현재 광고 파트너에 대해 활성화된 포스트백을 비활성화하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 비활성화하려는 포스트백의 Enable 열에 있는 체크박스를 선택 취소합니다.

imageimage

📘

자동화된 포스트백 정리

Branch는 작동하지 않는 모든 포스트백을 비활성화하기 위해 매주 작업을 실행합니다. 지난 7 일 동안 지속적으로 실패한 포스트백 (400/500 오류 만 발생)은 자동으로 비활성화됩니다.

삭제

현재 광고 파트너에 대해 활성화된 포스트백을 삭제하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 포스트백 오른쪽에 있는 점 3개 아이콘에 마우스를 가져간 다음 Delete Postback를 클릭합니다.
  4. Save를 클릭합니다.

imageimage

📘

비활성화 vs. 삭제

포스트백을 완전히 삭제하는 것보다 비활성화하는 것이 좋습니다. 그러나 이전에 삭제한 포스트백을 다시 추가할 수도 있습니다. 예전에 추가했던 커스터마이제이션을 다시 추가해야 합니다.

모든 이벤트 보내기

이 파트너에게 어트리뷰션되었는지 여부에 관계없이 All Events을 보내려면 포스트백 별로 All Events 체크박스를 선택하여 이 설정을 활성화할 수 있습니다.

🚧

개인 정보 보호 관련 사항

이 설정은 이 파트너에 어트리뷰션되었는지 여부에 관계없이 이 행에 나열된 이벤트 이름 및 customer event alias와 함께 All Events을 전송합니다. 따라서 특히 에이전시가 귀하의 계정에 액세스할 수 있도록 설정한 경우에는 활성화 시 주의하는 것이 좋습니다.

🚧

iOS 14.5 이후 이벤트 변경 사항 설치

유저가 Apple의 AppTrackingTransparency 프레임워크 를 통해 자신의 디바이스 data를 공유하도록 선택한 후에는 유료 광고로 어트리뷰션된 경우 두 번째 설치 이벤트가 발생합니다.

data는 옵트아웃하는 유저에 대해 오가닉할 것이므로, 오가닉 설치가 약간 증가할 것입니다. de-dupe 설치를 권장합니다.

iOS 14.5 이후의 변경 사항에 대한 추가 정보는 FAQ 페이지를 참조하십시오

imageimage

고급 설정

템플릿 편집

대부분의 경우 선택 항목에서 생성된 기본 포스트백 URL은 이해 관계자에게 포스트백 알림을 제공하기에 충분합니다.

그러나 때때로 포스트백 URL에서 파라미터를 편집 또는 제거하거나 추가 정보를 포함하기 위해 매크로 표현식/변수를 추가해야 하거나 추가하고 싶을 수 있습니다.

👍

예시

유저가 카트에 추가한 실제 항목을 파트너에게 보내 해당 항목을 기반으로 최적화할 수 있습니다. 현재 Add to Cart 포스트백 템플릿에는이 정보가 포함되어 있지 않습니다. 따라서 URL에 콘텐츠 항목 매크로를 추가해야 합니다. 이렇게 하려면 먼저 이 데이터를 전달할 파트너로부터 올바른 필드를 가져와야 합니다. 예 : cart_items . 마지막으로 포스트백 템플릿에 &cart_item=${(content_items[0].$product_name)!} 를 추가합니다.

추가 매크로를 추가하려면 포스트백 매크로 및 기능을 참고하세요.

포스트백 템플릿을 편집하려면 :

  • 방법 1
  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. Postback URL 필드에서 필요한 key-value 페어를 추가 / 수정 / 제거합니다.
    a. 추가하는 각 key-value 페어 앞에 & 를 포함해야합니다.
  4. Save를 클릭합니다.
  • 방법 2
  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 포스트백 오른쪽에 있는 점 3개 아이콘에 마우스를 가져간 다음 Advanced Edit를 클릭합니다.
  3. Send a Webhook to 필드에서 필요한 key-value 페어를 추가 / 수정 / 제거합니다.
    a. 추가하는 각 key-value 페어 앞에 & 를 포함해야합니다.
  4. Save를 클릭합니다.

필터 추가

참고: Branch는 캡쳐된 모든 데이터 필드 값의 기존 대소문자를 유지하고 Export를 통해 추출시에는 대소문자가 유지되지만, 웹훅/포스트백의 필터링 적용 시에는 대소문자 구분이 제거됩니다. 예를 들어 user_data.os, iOS, ios, IOS로 필터를 만든 경우 모두 동일하게 인식합니다.

기본적으로 모든 포스트백에는 다음 두 가지 필터가 포함됩니다.

  • 운영 체제 = ROBOT
    • 이 필터는 Branch가 실제 트래픽을 기반으로 포스트백만 전송하도록 합니다.
  • Last Attributed Touch Data $3p = 현재 선택된 광고 파트너
    • 이 필터를 사용하면 Branch에서 현재 선택된 광고 파트너에게 어트리뷰션된 이벤트에 대해서만 포스트백을 전송합니다.
    • 참고: 이 필터를 제거하면 Branch는 어트리뷰션된 광고 파트너에 관계없이 모든 이벤트를 전송합니다. 이것은 All Events 박스를 선택하는 것과 같습니다.

👍

예시

파트너는 안드로이드 구매 이벤트와 iOS 구매 이벤트에 대해 별도의 포스트백을 요구합니다. 이를 수행하려면 두 개의 구매 포스트백을 추가하고 하나에는 Operating System - user_data.os - equals - Android 에 대한 필터를, 다른 하나에는 Operating System - user_data.os - equals - iOS 에 대한 필터를 추가해야 합니다.

필터를 생성하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 포스트백 오른쪽에 있는 점 3개 아이콘에 마우스를 가져간 다음 Advanced Edit를 클릭합니다.
  4. Add Filter 버튼을 클릭하십시오
  5. 필터링할 메타 데이터를 선택합니다. 아래의 기본 필터 목록을 참조하십시오.
    1. 다음 드롭 다운에서 equals 또는 does not equal을 선택합니다.
  6. 마지막으로 필터링 할 키 값을 설정합니다.
  7. Save를 클릭합니다.

imageimage

기본 필터

포스트백을 편집할 때 다음 필터를 사용할 수 있습니다.

  • Campaign
  • Channel
  • Country
  • Custom -자세한 내용은 고급 필터 참조
  • Feature
  • Tags
  • Last Attributed Touch ID
  • Last Attributed Touch Type
  • Operating System
  • Environment
  • Platform
  • Agency ID
  • Re-engagement Activity
  • Attributed
  • Customer Event Alias
  • First Event for User

고급 필터

위에서 언급한 기본 필터 외에도 링크 데이터, 유저 데이터 및 이벤트 데이터에 이르는 다양한 데이터 포인트를 활용하는 커스텀 필터를 만들 수도 있습니다.

고급 필터를 설정하기 전에 데이터 포맷을 확실히 살펴보세요.

필터를 생성하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 포스트백 오른쪽에 있는 점 3개 아이콘에 마우스를 가져간 다음 Advanced Edit를 클릭합니다.
  4. Add Filter 버튼을 클릭합니다.
  5. 필터링할 메타 데이터를 선택합니다. 고급 필터링의 경우 "Custom"
  6. 필터링할 키를 입력하십시오. 필터링할 키를 찾으려면 사용자 중심 어트리뷰션의 데이터 형식 에 대한 간략한 소개를 참조하여 키가 중첩될 가능성이있는 위치를 확인하세요. 키를 찾는 또 다른 안전한 방법은 필터를 설정하기 전에 데이터 전체를 살펴 보는 것입니다. CSV 추출, API 추출을 수행하거나 POST 바디가 있는 단일 포스트백을 전송하여 이 작업을 수행하고 해당 POST 바디에서 키를 찾을 수 있습니다.
  7. 키가 상위 레벨 데이터의 일부가 아닌 경우 (예: timestamp 또는 id), 한 단계 더 깊이 들어가야 할 수 있습니다. 대부분의 키는 object_name.key 형식입니다. 예를 들어, "product_deeplink_id"이라는 딥링크(Deep Link) 데이터에서 커스텀 키를 필터링하려면 last_attributed_touch_data.product_deeplink_id 형식이 필요합니다.

특정 쿠폰을 사용하여 Purchase 이벤트마다 포스트백을 받고 싶다고 가정해 보겠습니다. 앱이나 웹사이트에서 구매 이벤트를 설정할 때 "coupon"에 대한 특정 메타 데이터를 추가했습니다. Event Ontology Schema에서 "쿠폰"이 "event_data"안에 있음을 확인했습니다. couponHOLIDAYS 과 같을 때만 포스트백을 실행하도록 필터를 구성하려면 다음을 수행합니다.

  1. 필터 키 드롭 다운에서 "Custom"을 선택합니다.
  2. 키 만들기 event_data.coupon
  3. 등가 드롭 다운에서 "equals"을 선택합니다.
  4. 값을 입력하십시오. HOLIDAYS

imageimage

POST HTTP 방법 사용

기본적으로 Branch는 GET HTTP 방법을 통해 포스트백을 보냅니다. 그러나 대신 POST HTTP 메서드를 통해 포스트백을 보내도록 선택할 수 있습니다.

HTTP 메서드를 POST로 변경하려면 :

  1. Partner Management에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 해당 파트너 페이지에서 Postback Config 탭을 클릭하십시오.
  3. 포스트백 오른쪽에 있는 점 3개 아이콘에 마우스를 가져간 다음 Advanced Edit를 클릭합니다.
  4. GET 드롭 다운을 POST로 변경합니다.
  5. 기본적으로 POST에 대한 Branch의 헤더 설정은 다음과 같습니다.
    1. Content-Type : application/json
      1. 추가 Content-Type 값에는 application/x-www-form & urlencoded가 포함됩니다.

imageimage

포스트백 테스트

새 포스트백을 활성화 및/또는 설정한 후에는 Branch 대시보드의 Liveview 기능을 사용하여 제대로 작동하는지 테스트할 수 있습니다.

Liveview에서 포스트백/웹훅을 테스트하려면 :

  1. 왼쪽 탐색의 Setup & Testing 아래에서 Liveview를 클릭하십시오.
  2. Webhooks Record 탭을 클릭하여 Webhook/포스트백 객체를 로드합니다.
  3. Add Filter 버튼을 클릭하고 드롭 다운에서 Webhook Partner Key을 선택하고 파트너에 대한 관련 값을 삽입합니다.
  4. 열 버튼을 클릭하여 Webhook Response CodeWebhook Response Body을 모두 열로 추가합니다.
  5. 필터링된 결과를 보려면 Update Session을 클릭하십시오.

imageimage

파트너의 웹훅 키를 찾는 방법

파트너별로 웹훅 레코드를 필터링하여 포스트백이 올바르게 실행되는지 확인하려면 파트너의 웹훅 키를 찾아야합니다.

파트너의 웹훅 키를 찾으려면 :

  1. 파트너 관리에서 포스트백을 추가/편집할 파트너를 선택합니다.
  2. 계정 설정 탭에서 파트너의 광고 계정 정보 아래에 파트너 식별자($3p 값)를 복사하여 붙여 넣습니다.

imageimage

유효성 검사 시 확인해야 할 사항

  • 예상 매크로가 채워져 있고 응답 코드가 있는지 확인하십시오. 가장 중요한 것은 IDFA/AAID 및 Click ID가 채워져 있는지 확인하는 것입니다.
  • 응답 코드가 200(성공)인 경우에도 광고 파트너와 함께 이벤트를 확인하는 것이 좋습니다. 이를 위해 이벤트 이름, 웹훅 요청 URL, 디바이스 ID, 타임스탬프, 웹훅 응답 코드 및 웹훅 응답 본문을 보내십시오.
  • 원하는 웹훅을 찾을 수 없으면 Ad Link를 여러 번 테스트하여 후속 웹훅/포스트백을 트리거하는 것이 좋습니다.

포스트백 서버 IP 주소 화이트 리스트

  • 보안을 위해 포스트백 서버 IP 주소를 화이트 리스트에 추가해야 하는 경우, 그 주소는 다음과 같습니다:
    • 52.9.159.121/32
    • 52.9.176.205/32
    • 52.9.188.221/32
    • 52.9.188.236/32

부록

포스트백 매크로 및 기능

사용 가능한 포스트백 매크로 및 기능의 전체 목록은 포스트백 매크로 및 함수 문서를 참고하세요.

이벤트 온톨로지 데이터 형식

Branch의 데이터 형식에 대한 자세한 설명과 사용 가능한 필드의 전체 목록은 이Event Ontology Data Schema 문서를 참고하세요.

Freemarker 표현식 사용

또한 Branch의 Event Ontology Data Schema에 Freemarker를 적용하여 고급 필터를 추가할 수도 있습니다.

위 링크에서 언급한 표현식 외에도 Branch는 사용할 수있는 Branch에 특정한 freemarker 표현식을 만들었습니다.

태그

파라미터

설명

예시

<@json>

JSON은 내용을 string으로 인코딩합니다.

입력:

<@json> And then they said, "Hello, ${name}"/@json

산출:

"그리고 그들은 "안녕하세요, 드미트리"라고 말했습니다."

<@sha1>

SHA1은 내용을 인코딩합니다.

입력:

sha1=<@sha1>${user_data.idfv}/@sha1

산출:

sha1 = d0b486885d4f2270ee6b4217ae95ee737b7b8975

<@ sha256>

SHA256은 내용을 인코딩합니다.

입력:

sha256=<@sha256>${user_data.idfv}/@sha256

산출:
sha1=1bb12f133f50a6a63a02c8f0ce33c5f0a61f7cbecc667acc82d3efa4c2965c26

<@ md5>

MD5는 내용을 인코딩합니다.

입력:

sha1=<@sha1>${user_data.idfv}/@sha1

산출:
sha1 = d0b486885d4f2270ee6b4217ae95ee737b7b8975

<@ base64>

Base64는 콘텐츠를 인코딩합니다.

<@loop>

<@break>

<@sep>

data = foo (필수)

val = "bar"(필수)

데이터에 지정된 변수 주위를 Loop하여 각각의 연속 변수를 val에 지정된 이름에 할당합니다. 데이터를 따옴표로 묶지 않도록 유의하세요.

입력:

sha1=<@sha1>${user_data.idfv}/@sha1

산출:

sha1 = d0b486885d4f2270ee6b4217ae95ee737b7b8975

<@jsonmap>

data = foo (필수)

JSON은 어떤 방식으로든 데이터를 인코딩합니다 (따옴표를 사용하지 마십시오).

입력:

sha1=<@sha1>${user_data.idfv}/@sha1

산출:

sha1 = d0b486885d4f2270ee6b4217ae95ee737b7b8975

<@urlencode>

URL은 내용을 인코딩합니다.

입력:

sha1=<@sha1>${user_data.idfv}/@sha1

산출:

sha1 = d0b486885d4f2270ee6b4217ae95ee737b7b8975

보안 제한으로 인해 Branch는 아래의 Freemarker 표현식을 서포트하지 않습니다.

  • "<#import>"
  • "<#visit>"
  • "<#include>"
  • "?eval"
  • "<#recurse>"
  • "<#setting>"
  • "<#macro>"
  • "<#function>"
  • "<#nested>"
  • "<#return>"
  • "<#list>"

Updated 4 months ago


포스트백 설정


제안된 편집은 API 참조 페이지에서 제한됩니다.

Markdown 본문 콘텐츠에 대한 편집만 제안할 수 있지만 API 사양에는 제안할 수 없습니다.