Universal Ads 캠페인 설정 테스트
요구 사항
테스트하기 전에 다음을 확인하십시오.
- The Branch SDK is implemented in your app.
- Default link behavior and attribution windows are configured.
- Universal Ads Partners are enabled.
1. 테스트 디바이스 추가
Before you complete the steps below, we highly recommend adding your test device to your Branch account. This enables you to repeatedly test installing your app without affecting real traffic and attribution.
2. Branch 링크 만들기
Please follow the Creating Ad Links instructions.
광고 링크 템플릿 자체가 테스트를 위해 제대로 작동하는지 확인하려면 생성된 광고 링크 템플릿이 사용하기 전에 초기 유효성 검사를 통과했는지 확인하세요.
Branch Ad Link는 다음과 유사해야 합니다 (선택한 광고 파트너에 따라 다름).
https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
3. 매크로를 통해 필요한 링크 데이터를 전달
광고 파트너의 라이브 캠페인에 사용하는 것이 아닌, 링크를 직접 테스트할 때는 적절한 어트리뷰션 및 포스트백을 위해 관련 값을 수동으로 전달해야 합니다.
라우팅과 어트리뷰션 모두에 대해 Branch 링크를 테스트하려면 다음을 제공했는지 확인해야 합니다.
실제 디바이스 ID-안드로이드 디바이스의 경우 AAID 및 Apple 디바이스의 경우 IDFA. 테스트 디바이스에서 디바이스 ID를 제공하지 않으면 Branch는 확률적 어트리뷰션을 위해 시점 모델링 (Point-in-Time Modeling)을 사용합니다.
내 디바이스 ID는 어떻게 찾나요?
Learn how to find your Android and/or iOS device IDs here.
위의 샘플 Branch Ad Link를 사용하여 매크로를 입력하면 다음 링크가 생성됩니다.
https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=00000000-0000-0000-0000-000000000000&trackertoken=1234&ya_reen_id=2345&~campaign=my_test_campaign&~campaign_id=9876&~click_id=1111&~secondary_publisher=45678
For a complete list of the macros that Branch supports in postbacks, please see Postback Macros & Functions.
데이터를 전달하지 않음
Leaving the macros in the link - e.g.
<IDFA>
- will result in broken links and therefore will not work. You can pass in empty values for the link to work, but the subsequent postbacks will return empty values to your partner.
일반적인 Ad Link 상태 시나리오
링크 상태 | 이유 | 샘플 테스트 Link |
---|---|---|
고객 입장에서 | ||
정상 작동 | 하나의 디바이스 ID를 입력하고 다른 하나는 비워 둡니다. | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid> |
정상 작동 | S2S가 아닌 경우, AAID 및 IDFA를 모두 지정합니다. (OS는 클라이언트에서 파악) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E
|
미작동 | UI에서 직접 발급한 그대로의 링크를 클릭 (디바이스 ID가 전달되지 않음) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
미작동 | 두 디바이스 ID 매크로를 모두 채우지 않고 그대로 둡니다. | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
미작동 | 하나의 디바이스 ID를 작성하고 다른 하나는 매크로로 남겨 둡니다. | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
서버 대 서버 ($ s2s = true) | ||
정상 작동 | 디바이스 ID와 함께 S2S 통신 (서버 투 서버의 설계 상 리디렉션하지 않음) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
미작동 | UI에서 직접 발급한 그대로의 링크 클릭 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
미작동 | $S2S 파라미터가 있지만 디바이스 ID 미제공 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
미작동 | S2S 이면서 AAID & IDFA 모두 지정 (즉 OS 파악 불가) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
4. 클릭 및 다운로드 수행
Branch Ad Link 및 적절한 라우팅을 테스트하려면 Ad Link를 이메일로 보내십시오. 디바이스에서 이메일을 열고 Link (또는 링크가 포함된 광고)를 클릭하십시오. 사무실 Wifi로 테스트하는 경우, 디바이스의 unique한 핑거프린트를 얻기 위해 wifi를 끄고 LTE/Cell을 사용할 것을 권장합니다.
이 클릭은 Branch 시스템을 통해 적절한 앱 스토어 및 / 또는 앱을 다운로드할 수 있는 대상으로 여러분을 리디렉션해야합니다.
Branch가 디바이스 정보를 캡처하고 설치 이벤트를 클릭 이벤트와 일치 시키도록 앱을 엽니다.
링크 형식 문제 해결
링크의 형식이 잘못되었거나 키 식별자가 누락된 경우 Branch에서 적절한 라우팅 및 어트리뷰션을 완료할 수 없습니다.
Please see Troubleshooting Link Formatting Issues for possible causes and solutions.
5. 관련 작업에 대한 Liveview 확인
Liveview를 사용하면 특정 이벤트 (예 : 클릭, 설치, 구매) 및 웹훅 / 포스트백 기록으로 한정하는 고급 필터링을 포함하여 설정을 검증하고 디버그할 수 있습니다.
이벤트 Liveview
- 왼쪽 탐색의 Setup & Testing 아래에서 Liveview를 클릭하십시오.
- 기본적으로 Liveview는 Events 개체를 로드합니다.
- 왼쪽 상단의 필터를 사용하여 테스트하고자 하는 이벤트 유형을 선택하십시오. 이를 통해 테스트 클릭 및/또는 그에 따른 앱 다운로드 결과를 확인할 수 있습니다.
- 테스트 중인 Ad Link를 더 빨리 식별할 수 있도록 추가 필터(디바이스 ID 및/또는 광고 파트너 및/또는 캠페인 이름)를 추가하는 것이 좋습니다.
- 새롭게 설정한 선택 결과를 보려면 Update Session을 클릭하십시오.
웹훅 / 포스트백을 위한 Liveview
- 왼쪽 탐색의 Setup & Testing 아래에서 Liveview를 클릭하십시오.
- Webhooks Record 탭을 클릭하여 Webhook/포스트백 객체를 로드합니다.
- Add Filter 버튼을 클릭하고 드롭 다운에서 Webhook Partner Key을 선택하고 파트너에 대한 관련 값을 삽입합니다.
- 열 버튼을 클릭하여 Webhook Response Code과 Webhook Response Body을 모두 열로 추가합니다.
- 필터링된 결과를 보려면 Update Session을 클릭하십시오.
유효성 검사 시 확인해야 할 사항
- 예상 매크로가 채워져 있고 응답 코드가 있는지 확인하십시오. 가장 중요한 것은 IDFA/AAID 및 Click ID가 채워져 있는지 확인하는 것입니다.
- 응답 코드가 200(성공)인 경우에도 광고 파트너와 함께 이벤트를 확인하는 것이 좋습니다. 이를 위해 이벤트 이름, 웹훅 요청 URL, 디바이스 ID, 타임스탬프, 웹훅 응답 코드 및 웹훅 응답 본문을 보내십시오.
- 원하는 웹훅을 찾을 수 없으면 Ad Link를 여러 번 테스트하여 후속 웹훅/포스트백을 트리거하는 것이 좋습니다.
파트너의 웹훅 키를 찾는 방법
파트너별로 웹훅 레코드를 필터링하여 포스트백이 올바르게 실행되는지 확인하려면 파트너의 웹훅 키를 찾아야합니다.
파트너의 웹훅 키를 찾으려면 :
- 왼쪽 탐색의 Channels & Links에서 Ads를 클릭한 다음 Partner Management를 클릭합니다.
- 해당 파트너를 검색하고 클릭하여 이를 선택합니다.
- 파트너가 선택되고 AdPartner Settings 페이지를 보고 있을 경우, 브라우저의 URL 창에서 현재 Branch 대시보드 페이지의 URL을 찾으십시오.
- The partner webhook key is the first parameter after
/partner-management/
and begins witha_
; e.g.a_youappi
.
Updated 1 day ago