🚧

Universal Ads 솔루션 연동 안내서

Please refer to our Universal Ads Basics guide before using any the advanced options below.

Setup

임프레션 픽셀을 통한 조회 후 어트리뷰션 (VTA)

조회 후 어트리뷰션을 사용하면 광고를 클릭하지 않은 경우에도 Install, Session Start 및 전환 이벤트를 광고 임프레션으로 연결하여 트래킹할 수 있습니다.

조회 후 어트리뷰션 로직은 현재 모든 이벤트에 대해 다음과 같습니다.

• 유효한 어트리뷰션 윈도우 내에 클릭이 발생하면 클릭에 크레딧을 줍니다.
• 유효한 어트리뷰션 윈도우 내에 클릭이 없으면 유효한 어트리뷰션 윈도우 내에 있었던 마지막 임프레션에 크레딧을 줍니다.

To create an impression tracking link for non-SAN networks, simply create an ad link, and grab the impression link from the final step of link creation. SAN networks support VTA without any additional links.

setDebug로 테스트

SDK를 연동할 때 setDebug를 사용하여 앱이 Branch 서버와 통신할 수 있고 딥링크(Deep Link) 데이터를 수신하는지 쉽게 확인할 수 있습니다. 그러나 Branch의 업스트림 시스템은 setDebug를 사용하여 전송된 테스트 이벤트를 등록하지 않으므로 이벤트는 Liveview 또는 Analytics에 나타나지 않으며 포스트백을 실행하지도 않습니다. Liveview를 보거나 포스트백을 테스트할 때는 setDebug를 비활성화해야합니다.

서버 투 서버 Ad Links

서버 투 서버 연동의 경우, 어트리뷰션에 대한 구체적인 요구 사항을 제공해야 합니다. 다음의 필수적인 key-value 값들을 트래킹 Ad Links에 추가하여 거부 또는 차단되지 않도록 유의하세요.

• Server to Server Parameter: 링크 끝에 서버 투 서버 클릭 매크로 URL 파라미터를 추가하면 서버 투 서버 링크임을 알 수 있습니다.

  • %24s2s=true

• Device ID Macro Value: 클릭 매크로 URL 파라미터를 통해 유저 광고 식별자 전달 :

  • %24idfa={IDFA} iOS 디바이스 용
  • %24aaid={AAID} 안드로이드 디바이스 용

🚧

Tune 마이그레이션 고객용

광고 식별자에 다음 매크로를 사용하세요.

• ios_ifa={IDFA}
• google_aid={AAID}

• IP address: 헤더에 유저 IP 정보를 전달하거나 클릭 시 오버라이드될 클릭 매크로 URL 파라미터 전달:

  • HTTP 헤더 x-ip-override: {IP_ADDRESS}
  • 클릭 매크로 URL 파라미터 : device_ip={IP_ADDRESS}

• User Agent: 헤더에 유저 에이전트 정보를 전달하거나 클릭시 오버라이드될 클릭 매크로 URL 파라미터 전달:

  • HTTP 헤더 User-Agent: {USER_AGENT}
  • 클릭 매크로 URL 파라미터 : user_agent={USER_AGENT}

🚧

파트너 별 URL 매크로 업데이트

{IDFA}, {AAID}, {IP_ADDRESS}, {USER_AGENT} 대신 자체 매크로를 정확하게 사용하고 있는지 확인하세요.

더 많은 포스트백 추가/활성화

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

포스트백을 추가하려면 :

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

모든 이벤트 보내기

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

🚧

개인 정보 보호 관련 사항

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

템플릿 편집

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

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

👍

예시

You want to send your partner the actual items a user adds to their cart so they can optimize based off those items. Their current Add to Cart postback template does not include this information. Therefore, you need to add Content Items macros to their URL. To do so, you’ll first need to get the correct field from the partner in which to pass this data; e.g. cart_items. Finally, you’d append &cart_item=${(content_items[0].$product_name)!} to the postback template.

Please refer to Postback Macros & Functions when looking to append additional macros.

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

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

👍

포스트백 재설정

우리 모두는 때때로 실수를 합니다. 포스트백과 Credential을 재설정 해야하는 경우 Account Settings 탭으로 이동하여 Reset all settings 버튼을 찾으십시오. 하지만 조심하세요! 이렇게 하면 광고 파트너가 비활성화되고 설정한 모든 Credential과 포스트백이 지워지며 광고 파트너가 기본 설정으로 돌아갑니다. 그런 다음 새로 설정을 시작할 수 있습니다.

에이전시 액세스 권한 부여

광고 파트너 액세스 권한 부여

To grant an Ad Partner access to your App's data, you need to add them as an agency in your Branch account. Doing so gives said ad partner access to your app; based on the permissions you define.

1. Account Settings 로 이동하여 Agencies 탭을 클릭하십시오.
2. Agencies 탭에서 Add New Agency 버튼을 클릭합니다.
3. Add New Agency 선택창에서 다음을 실행합니다.
   1. 드롭 다운에서 에이전시 이름을 선택합니다.
   2. 적절한 액세스 수준을 선택합니다.
      • Admin - 모든 설정에 대한 액세스 권한을 수정하고 모든 데이터에 대한 액세스 권한을 추출합니다.
      • Team Member - 채널 및 링크에 대한 액세스, 앱 설정에 대한 읽기 전용 액세스 및 합산 데이터에 대한 액세스를 편집합니다.
      • Full Read - 모든 설정에 대한 읽기 전용 액세스 및 합산 데이터에 대한 액세스.
      • Limited Read - 합산 데이터에만 액세스합니다.
      • Custom - 설정 및 데이터 액세스를 커스텀합니다.
      • No Access - 대시보드 액세스가 없습니다.
   3. "Invite"를 클릭합니다.
   4. 에이전시 계정의 모든 에이전시 어드민은 초대 이메일을 받게되며 해당 에이전시 어드민은 에이전시를 대신하여 초대를 수락할 수 있습니다.

🚧

에이전시에 민감한 정보 & 앱 레벨 설정 권한 부여

Agencies with Sensitive Data & App-Level Settings permissions to an Org or App will have access to that Org/App's API keys, which can be used to access Branch's HTTP and Data Export APIs. Agency data filters (e.g. Only Show Agency-tagged Data) will not apply to data accessed via the Daily Export API, so we recommend against granting agencies these permissions and providing them with API keys.

권한 정의

각 액세스 레벨(위에 정의된 대로)에는 원하는 경우 편집할 수있는 사전 정의된 권한이 있습니다.

👍

권한 수정

사전 정의된 액세스 수준을 수정하려면 연필 아이콘을 클릭하여 사용 가능한 옵션을 선택(취소)합니다.

• Link-level Settings - 단일 링크의 기능에 영향을 줄 수 있는 설정 또는 기능.
• Channel-level Settings - 마케팅 채널의 기능에 영향을 미칠 수 있는 설정 또는 기능.
• App-level Settings - 앱 전체의 기능에 영향을 미칠 수 있는 설정 또는 기능.
• Aggregate Data - 세분화된 데이터가 없는 요약 데이터.
• Sensitive Data - 유저 식별, 지불 관련 또는 비밀 정보를 포함할 수 있는 데이터.

추가 데이터 필터

에이전시에 귀하의 Branch 계정에 대한 액세스 권한을 부여하는 과정에서, 언제든지 에이전시가 사용할 수 있는 데이터에 대해 제한을 부과할 수 있습니다.

🚧

특정 애드 네트워크의 데이터만 표시하도록 필터링

광고 파트너에게 Branch 계정에 대한 액세스 권한을 부여할 때 Only Show Data from Specific Ad Networks 을 켜고 액세스 권한을 부여할 광고 파트너를 선택했는지 확인하십시오.

• Only Show Agency-tagged Data - 사용 설정하면 에이전시 유저는 에이전시 ID 태그가 지정된 이벤트만 볼 수 있습니다.
• Restrict Access to Revenue Data -사용 설정하면 에이전시 유저는 수익 데이터를 볼 수 없습니다.
• Only Show Data from Specific Ad Networks -사용 설정하면 에이전시 유저는 특정 애드 네트워크 목록의 이벤트만 볼 수 있습니다.
• Only Show Data from Specific Locations -사용 설정하면 에이전시 유저는 특정 국가 목록에서 발생한 이벤트만 볼 수 있습니다.

🚧

에이전시 초대

에이전시에 대한 적절한 액세스 수준을 정의하고 나면, 이제 이들을 Invite하여 Branch 대시보드에 액세스할 수 있게 해야 합니다. Organization Admins만이 에이전시를 초대하여 Branch 대시보드에 대한 액세스를 줄 수 있습니다.

트래킹 링크 파라미터

Branch 트래킹 링크를 사용하면 광고 캠페인 및 개별 광고의 실적에 대한 다양한 파라미터를 트래킹할 수 있습니다. Link Parameters 탭에서 각 파트너 별 특정 링크 파라미터를 볼 수 있습니다.

심층 분석을 위해 '?' 또는 '&' 문자 뒤에 별도의 파라미터를 링크에 덧붙여 추가적인 정보를 트래킹할 수도 있습니다.

👍

추가 파라미터가 있는 트래킹 링크의 예

에이전시 및 서브 퍼블리셔 정보를 전달하기 위한 추가 파라미터가 포함된 Branch 링크 예:https://tracking.app.link?$3p=a_partner&~agency_id=1234&~agency=myAgency&~secondary_publisher=best_publisher

사전 생성된 트래킹 링크 내에는 다음과 같은 파라미터를 사용할 수 있습니다.

캠페인 정보

디바이스 정보

지출 계산

📘

비용 데이터 가용성

이 매크로를 통해 전달된 비용 데이터는 Export에서 사용 가능하지만 Branch 대시보드에는 표시되지 않습니다.

어트리뷰션 윈도우

어트리뷰션 윈도우 변경

어트리뷰션 윈도우는 전체 계정 레벨이나 각 링크에서 지정(계정보다 우선순위로 적용)할 수 있습니다. 설정 방법은 다음 지침을 참고하세요.

고객 경험과 데이터 정확성을 위해 다른 어트리뷰션 윈도우보다 딥링킹(Deep Linking) 윈도우를 더 길게 설정하지 마십시오.

계정 레벨 어트리뷰션 윈도우

Link Settings > Attribution Windows에서 어트리뷰션 윈도우를 편집할 수 있습니다.

Learn more about account level attribution windows in People-Based Attribution.

애드 네트워크 어트리뷰션 윈도우

You can edit your attribution windows at the ad network level if your ad network requires it. This is recommended when you enable networks like Facebook and Google, which may have different windows for installs. With this, you can preserve your Account Level Attribution Windows, as well.

링크 레벨 어트리뷰션 윈도우

어트리뷰션 윈도우를 링크 레벨에서 설정하려면 다음의 파라미터를 생성한 Branch 링크에 덧붙일 수 있습니다.

🚧

표준 Branch 링크에 대한 링크 레벨 어트리뷰션 서포트

2017년 7월부터 링크 레벨 어트리뷰션 윈도우 설정은 표준 Branch Link에서만 사용할 수 있습니다. Google의 유니버설 앱 캠페인 또는 Branch link id 파라미터가 있는 Play Store link에 사용되는 것과 같은 특수 Branch 링크는 현재 지원되지 않습니다.

데이터 조회

The Ads Analytics Page on the Branch dashboard shows the performance of your ad campaigns across both web and app. You can view performance over time, including purchase and other custom events.

이벤트는 Branch의 통합된 라스트 클릭 어트리뷰션 모델을 사용하여 어트리뷰션됩니다. 즉, Branch는 채널과 플랫폼에서 라스트 클릭에 어트리뷰션합니다.

For example, if a customer clicks a Branch email link, and then clicks an ad, installs the app and purchases an item, Branch will attribute the install and the purchase to the last clicked ad link.

그런 다음 고객이 어트리뷰션 윈도우 내에서 웹에서 항목을 구매하면 Branch는 웹 구매를 동일한 광고 링크에 어트리뷰션하여 단일 사용자가 수행한 웹 및 앱 작업을 연결해 마케팅 채널과 고객 행동에 대한 보다 정확한 시각을 가질 수 있습니다.

You can read more about Branch's Attribution logic here.