포스트백 매크로 및 기능
Overview
다음 목록은 Branch가 포스트백 URL 및 웹훅에서 서포트하는 매크로 및 가용한 기능을 보여줍니다. 이러한 매크로 및 함수를 사용할 때 Branch는 지정된 포스트백 URL에 알리기 전에 동적으로 해당 값을 확인/대체합니다.
URL 매크로
수집되는 정보 유형에 따라 매크로를 카테고리로 그룹화 하였습니다.
함수를 사용하여 포스트백 매크로 수정
모든 포스트백 매크로는 다양한 포스트백 URL 기능을 사용하여 해시/암호화/수정할 수 있습니다. 다음 포스트백 매크로에 적용할 수 있는 사용 가능한 포스트백 URL 함수에 대한 정보는 아래의 URL 함수 매크로 섹션을 참조하십시오.
포스트백 데이터
다음 매크로는 포스트백 이벤트와 관련된 상위 레벨의 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
| String | The name of the postback event. The list of event names can be found here. |
| String | The alias name of the event provided by the customer; used in addition to the standard Branch names defined in the namefield. |
| Fixed64 | The ID associated with your organization for which the event occurred; assigned by Branch. |
| String | The name of your organization for which the event occurred; provided during account setup. |
| Fixed64 | The UNIX timestamp in milliseconds for the event; set automatically server side. |
| String | Where the attribution was recorded:
|
| String | 이벤트와 관련된 ID ; Branch가 할당합니다. |
| 불리안(Boolean) | 이벤트 어트리뷰션 여부; 1 (true/yes) 또는 0 (false/no) |
| Int32 | 마지막으로 어트리뷰션된 터치와 이벤트 사이의 일 수. |
| Int32 | 마지막으로 어트리뷰션된 터치와 이벤트 사이의 시간; 24로 제한. |
| Int32 | 마지막으로 어트리뷰션된 터치와 이벤트 사이의 분; 60으로 제한. |
| Int32 | 마지막으로 어트리뷰션된 터치와 이벤트 사이의 초; 60으로 제한. |
| String | The type of the attribution the event was for:
|
${(last_attributed_touch_timestamp)!} | Fixed64 | 마지막으로 어트리뷰션된 터치에 대한 UNIX 타임스탬프(밀리 초); 서버 측에서 자동으로 설정합니다. |
${(di_match_click_token)!} | Fixed64 | 설치에 클릭을 매치하기 위해 Tune, Appsflyer 및 기타가 사용하는 Branch Flow ID; 안드로이드 설치 리퍼러(Referrer) 이용; 클라이언트에서 릴레이(relay)하고 서버 측에서 설정. |
${last_cta_view_timestamp)!} | Fixed64 | 최종 Branch CTA보기에 대한 UNIX 타임스탬프 (밀리 초). 서버 측에서 자동으로 설정합니다. |
<#if deep_linked>1<#else>0</#if> | 불리안(Boolean) | 현재의 앱 또는 웹 세션이 유저의 딥링킹(Deep Linking)을 통해 발생한 경우. 서버 측에서 자동으로 설정합니다; 1 (true/yes) 또는 0 (false/no). |
<#if first_event_for_user>1<#else>0</#if> | 불리안(Boolean) | 이 디바이스에서 처음으로 이 이벤트가 트리거된 경우입니다. 서버 측에서 자동으로 설정합니다; 1 (true/yes) 또는 0 (false/no). |
${(store_install_begin_timestamp)!} | Fixed64 | Play Store/App Store에서 설치 버튼을 클릭한 시간. |
${(referrer_click_timestamp)!} | Fixed64 | Play 스토어 출시 시간 (안드로이드만 해당) |
<#if existing_user>1<#else>0</#if> | 불리안(Boolean) | 이벤트와 연관된 유저가 기존 유저인 경우 1 (true/yes) 또는 신규 유저인 경우 0 (false/no) |
${(webhook_id)!} | Fixed64 | The ID of the webhook/postback itself; assigned by Branch. |
${(webhook_partner_key)!} | String | Branch가 페이로드를 전송하는 시스템에서 읽을 수 있는 파트너 이름. 서버 측에서 자동으로 설정합니다. |
어트리뷰션 터치 데이터
다음 매크로는 광고 캠페인과 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
| Fixed64 | 최종 어트리뷰션된 터치의 ID (Quick Link만 해당). 서버 측에서 자동으로 설정합니다. |
| String | 최종 터치한 것으로 어트리뷰션된 캠페인(이름). 클라이언트가 링크에서 지정하거나 경우에 따라 서버 측에서 자동으로 설정할 수 있습니다. |
| String | 최종 어트리뷰션한 터치에 지정된 캠페인 ID. 서버 측에서 자동으로 설정합니다. |
| String | Google 캠페인 유형 Google AAP 필드. 서버 측에서 자동으로 설정합니다. |
| String | 라스트 어트리뷰션 터치에서 확인된 고객 캠페인입니다. 클라이언트가 링크에 지정할 수 있습니다. |
| String | 라스트 어트리뷰션 터치에 지정된 채널. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다. |
| String | 라스트 어트리뷰션 터치에 지정된 feature. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다. |
| String | 마지막으로 어트리뷰션 된 터치에 지정된 단계. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다. |
| String | 최종 어트리뷰션된 터치에 지정된 태그. 클라이언트가 링크에서 지정하거나 경우에 따라 서버 측에서 자동으로 설정할 수 있습니다. |
| String | 최종 어트리뷰션된 터치에 지정된 사람이 읽을 수 있는 광고 파트너 이름. 서버 측에서 자동으로 설정합니다. |
| String | The ID for the advertising partner specified for the last attributed touch. set automatically server side OR specified by the client. |
| String | 최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔 ID. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔 ID. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 어트리뷰션된 터치에 지정된 크리에이티브 이름. 서버 측에서 자동으로 설정합니다. |
| String | 최종 어트리뷰션된 터치에 지정된 크리에이티브 ID. 서버 측에서 자동으로 설정합니다. |
| String | The ad set name specified for the last attributed touch. set automatically server side. |
| String | The ad set ID specified for the last attributed touch. set automatically server side. |
| String | The customer ad set name specified for the last attributed touch. can be specified on links by the client. |
| String | The ad name specified for the last attributed touch. set automatically server side. |
| String | The ad ID specified for the last attributed touch. set automatically server side. |
| String | 라스트 어트리뷰션 터치에서 확인된 고객 광고 이름입니다. 클라이언트가 링크에 지정할 수 있습니다. |
| String | The keyword specified for the last attributed touch. set automatically server side. |
| String | The unique ID for keyword of the last touch as provided by Google. |
| String | 마지막 터치의 고객 키워드입니다. 클라이언트가 링크에 지정할 수 있습니다. |
| String | 최종 터치의 광고 형식. Branch Link 생성 시 선택한 Ad Format이 분석 태그로 설정됩니다. 예: Search, Display, Product Ad, App only. |
| String | 분석 태그로 설정된 마지막 터치의 기술 파트너입니다. 에이전시를 제외하고 캠페인을 개선시키는 데 사용되는 모든 써드파티 (예 : 제공되는 오디언스, 크리에이티브 최적화). |
| String | 분석 태그로 설정된 마지막 터치의 디스플레이 배너 크기 |
| String | 분석 태그로 설정된 마지막 터치의 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다. |
| String | 분석 태그로 설정된 마지막 터치의 게재 위치 ID입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다. |
| String | The customer specified placement of the last touch, as set with an analytics tag. Actual app or website the ad appears on display campaigns. |
| String | 광고가 표시된 사이트에 대한 참조. 애드 네트워크에 의해 전달됩니다. |
| String | 광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다. |
| String | The agency of the last touch, as set with an analytics tag. Agency that runs ad campaigns on behalf of advertiser. |
| String | The ID of agency of the last touch, as set with an analytics tag. Agency that runs ad campaigns on behalf of advertiser. |
| String | 분석 태그로 설정된 마지막 터치의 최적화 모델. 캠페인이 최적화하는 이벤트 (예 : 설치, 클릭, 이벤트)를 자세히 설명하는 모델입니다. |
| String | 분석 태그 또는 대시보드의 Ad Link 생성 과정에서 설정된 최종 터치의 보조 광고 형식. Google 디스플레이 인게이지먼트 광고와 같은 광고 파트너별 광고 형식. |
| String | 써드파티가 Branch로 보낸 클릭 또는 임프레션(광고 노출)의 ID. 어트리뷰션된 이벤트를 기존 터치에 연결하는 데 사용됩니다. 어트리뷰션 파트너가 Google SAN 인 경우 이는 gclid 값이 됩니다. 자세한 내용은 이 시트의 gclid를 참조하세요. |
| String | Journeys 오디언스 규칙에 대한 "캠페인 이름" 또는 "제목"입니다. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다. |
| String | Journey의 오디언스 규칙 ID. 서버 측에서 자동으로 설정합니다. |
| String | Branch Journeys View 템플릿의 "View Name" 또는 "제목"입니다. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다. |
| String | Journey의 Branch View ID. 서버 측에서 자동으로 설정합니다. |
| String | 유저가 Journey가 있는 페이지에 오기 전 방문한 URL의 도메인. "came directly from a URL" 오디언스 필터링에 사용하는 것과 동일한 데이터 source를 사용합니다. 클라이언트가 지정합니다. |
| String | 이벤트가 Google AMP 또는 Facebook Instant Article을 터치하여 시작된 경우 설정합니다. 클라이언트가 지정합니다. |
| String | The format of the webside:
|
| String | Branch feature (determined by Branch) of the current touch. set automatically server side;
|
| String | All Branch features (determined by Branch) which were determined, via attribution, to have led to this event. For example, if an email link click leads to a Journey which leads to the app, the published eo_open will have +via_features:
or set server side:
|
<#if last_attributed_touch_data.dollar_fb_data_terms_not_signed> 1 <#else> 0 </#if> | 불리안(Boolean) | 모바일 데이터 용어가 Facebook에서 서명되지 않은 경우. 즉, 외부 이벤트에서 어트리뷰션과 관련된 모든 것을 숨겨야 합니다. 서버 측 자동 설정; 1 (true/yes) 또는 0 (false/no) |
${(last_attributed_touch_data.+touch_id)!} | String | 어트리뷰션 터치의 (임프레션, 클릭 등) ID입니다. |
${(last_attributed_touch_data.custom_fields)!} | String | Any deep link data specified for the last touch not captured by the above fields e.g. {foo:true, deeplink_path: id/12}. "custom_fields" should not be surfaced as an independent object. The values should be included in last_attributed_touch_data. specified by the client. |
${(last_attributed_touch_data.user_data_ip)!} | String | 유저 디바이스의 IP 주소. |
${(last_attributed_touch_data.user_data_user_agent)!} | String | The User-Agent string format including product name and version and system (e.g. “Mozilla/5.0 (iPad)”). |
${(last_attributed_touch_data.+device_brand_name)!} | String | 유저 디바이스의 브랜드 또는 제조사 (예 : "Apple"또는 "Samsung"); HTTP 헤더를 통해 전송된 유저 에이전트를 구문 분석하여 결정됩니다. |
${(last_attributed_touch_data.+device_brand_model)!} | String | 유저 디바이스 모델 (예 : "Droid Pro") HTTP 헤더를 통해 전송된 유저 에이전트를 구문 분석하여 결정됩니다. |
User Data
다음 매크로는 전환시 수집된 유저/디바이스 관련 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
| String | The operating system of the device on which the event was registered: |
| String | The version of the operating system of the device on which the event was registered; specified by client. |
| String | 이벤트가 발생한 디바이스의 운영 체제 버전(안드로이드); 클라이언트가 지정합니다. |
| String | The runtime environment where the event occurred:
|
${(user_data.platform)!} | String | A convenience dimension that allows users to easily see web vs app, desktop vs mobile, and iOS vs Android vs other |
${(user_data.aaid)!} | String | Android/Google advertising id of the device where the event occurred. specified by the client. |
${(user_data.android_id)!} | String | Android hardware id. Can only be reset by wiping the device. specified by the client. |
${(user_data.idfa)!} | String | iOS advertising id of the device where the event occurred. specified by the client. |
${(user_data.idfv)!} | String | OS vendor id of the device where the event occurred. Scoped to a vendor e.g. Facebook: idfv is the same for Facebook and Messenger but different Twitter. specified by the client. |
${(user_data.kindle_aid)!} | String | The ID associated with a Kindle device. |
${(user_data.windows_aid)!} | String | The Windows Advertising ID. |
<#if user_data.limit_ad_tracking>1<#else>0</#if> | 불리안(Boolean) | If the partner has opted to not be tracked by advertisers. on iOS 10+, accompanied by idfa of 0s; 1 (true/yes) OR 0 (false/no). |
<#if user_data.is_jailbroken>1<#else>0</#if> | 불리안(Boolean) | If true, then the phone that sent this event was jailbroken; 1 (true/yes) OR 0 (false/no). |
${(user_data.user_agent)!} | String | 이벤트가 발생한 브라우저 또는 앱의 유저 에이전트입니다. 일반적으로 웹 뷰와 연결됩니다. |
${(user_data.ip)!} | String | The IP address from which the API call tracking the event originated; set automatically server side. |
${(user_data.developer_identity)!} | String | The developer-specified identity for a user; specified by the client. |
${(user_data.language)!} | String | The ISO 639-1 Code of the language. |
${(user_data.sdk_version)!} | String | 이 이벤트를 트래킹하는 데 사용되는 Branch SDK 버전 ; 클라이언트가 지정합니다. |
${(user_data.http_referrer)!} | String | Web SDK가 포함된 페이지에 대한 유입을 이끌어 낸 리퍼럴 URL ; 클라이언트가 지정합니다. |
${(user_data.referral_source)!} | String | Android: activity.getCallingPackage() . iOS: Web referrer, safari referrer, or bundle_id. |
${(user_data.app_version)!} | String | The app version where the event occurred; specified by the client. |
${(user_data.device_type)!} | String | The type of device |
${(user_data.carrier_name)!} | String | Which carrier covers the device where the event occurred. specified by the client. |
${(user_data.brand)!} | String | Brand or make of user device (such as “Apple” or “Samsung”). |
${(user_data.model)!} | String | The model of the device where the event occurred. specified by the client. |
${(user_data.geo_continent_code)!} | String | IP 주소 (위)에서 파생된 대륙 코드. 서버 측에서 자동으로 설정합니다. |
${(user_data.geo_region_code)!} | String | IP 주소 (위)에서 파생된 지역 코드. 서버 측에서 자동으로 설정합니다. |
${(user_data.geo_region_en)!} | String | The human-readable region, derived from IP address (above), set automatically server side. |
${(user_data.geo_dma_code)!} | UInt32 | The DMA Code, derived from IP address (above), set automatically server side. |
${(user_data.geo_city_code)!} | UInt32 | IP 주소 (위)에서 파생된 도시 코드. 서버 측에서 자동으로 설정합니다. |
${(user_data.geo_city_en)!} | String | IP 주소 (위)에서 파생된 사람이 읽을 수 있는 도시명. 서버 측에서 자동으로 설정합니다. |
${(user_data.geo_lat)!} | Float | Latitude, derived from IP address (above), set automatically server side. |
${(user_data.geo_lon)!} | Float | Longitude, derived from IP address (above), set automatically server side. |
${(user_data.geo_country_code)!} | String | The ISO 3166 code of the country. |
${(user_data.geo_country_en)!} | String | IP 주소 (위)에서 파생된 영어로 된 국가 이름. 서버 측에서 자동으로 설정합니다. |
${(user_data.geo_postal_code)!} | String | IP 주소 (위)에서 파생된 우편 번호. 서버 측에서 자동으로 설정합니다. |
${(user_data.browser)!} | String | 웹 이벤트가 시작된 브라우저의 사람이 읽을 수 있는 이름. 유저 에이전트 string에서 파생됩니다. 클라이언트가 지정합니다. |
${(user_data.cross_platform_id)!} | String | 이벤트가 발생한 Branch 페르소나에 대한 유니크 식별자. 서버 측에서 자동으로 설정합니다. |
${(user_data.installer_package_name)!} | String | 앱을 설치한 앱의 패키지 이름; 서버 측에서 자동으로 설정합니다. |
${(user_data.cpu_type)!} | String | 디바이스에서 사용하는 CPU 유형 ; 서버 측에서 자동으로 설정합니다. |
${(user_data.build)!} | String | 디바이스의 빌드 버전 ; 서버 측에서 자동으로 설정합니다. |
${(user_data.internet_connection_type)!} | String | 디바이스에서 사용하는 인터넷 (예 : Wifi) 연결 유형; 서버 측에서 자동으로 설정합니다. |
${(user_data.screen_width)!} | String | 디바이스 화면의 너비 ; 서버 측에서 자동으로 설정합니다. |
${(user_data.screen_height)!} | String | The height of the screen of the device; set automatically server side. |
${(user_data.carrier_name)!} | String | 디바이스의 이동 통신사 (예 : Verizon) 이름 ; 서버 측에서 자동으로 설정합니다. |
이벤트 데이터
다음 매크로는 전환시 수집된 유저 / 디바이스가 완료한 이벤트와 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
| String | The partner-specified transaction id for their internal use. specified by the client. |
| String | ISO 4217 Code for currency. |
| Double | The partner-specified revenue for the event. specified by the client. |
| Double | Revenue in USD, based off of revenue, currency, and exchange rate. set automatically server side. |
| Double | 이벤트가 발생한 시점의 환율 (최대 24 시간까지일 수 있으나 일반적으로 1시간 내에 업데이트됨). 클라이언트가 지정합니다. |
| Double | Transaction과 관련된 배송 비용. 클라이언트가 지정합니다. |
| Double | Transaction과 관련된 총 세금. 클라이언트가 지정합니다. |
| String | Transaction과 함께 사용한 Transaction 쿠폰 (예 : "SPRING2017"). 클라이언트가 지정합니다. |
| String | 이 Transaction이 발생한 상점 또는 제휴처 (예 : Google Store). 클라이언트가 지정합니다. |
| String | Search query associated with the event. specified by the client. |
| String | Ad type that the user saw or clicked on. Defined by Facebook. specified by the client:
|
${(event_data.description)!} | String | 이벤트와 관련된 설명으로, 개별 콘텐츠 항목에 한정되지 않을 수도 있습니다. 클라이언트가 지정합니다. |
콘텐츠 항목 데이터
다음 매크로는 전환 시점에 수집되며 유저/디바이스가 완료한 이벤트 내 콘텐츠와 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
${(content_items[0].$content_schema)!} | String | The category / schema for a piece of content. specified by the client:commerce_auction / commerce_business / commerce_other / commerce_product / commerce_restaurant / commerce_service / commerce_travel_flight / commerce_travel_hotel / commerce_travel_other / game_state / media_image / media_mixed / media_music / media_other / media_video / other / text_article / text_blog / text_other / text_recipe / text_review / text_search_results / text_story / text_technical_doc | |
<#if content_items[0].$publicly_indexable> 1 <#else> 0 </#if> | 불리안(Boolean) | true: 로컬 (디바이스) 사용을 위해 콘텐츠를 인덱싱할 수 있음 또는 false : 로컬 사용을 위해 인덱싱할 수 없음; 클라이언트 지정; 1 (true/yes) 또는 0 (false/no) |
<#if content_items[0].$locally_indexable> 1 <#else> 0 </#if> | 불리안(Boolean) | true : 모든 사람이 콘텐츠를 볼 수 있음 또는 false : 공용으로 인덱스를 생성할 수 없음; 클라이언트 지정. 1 (true/yes) OR 0 (false/no) |
${(content_items[0].$exp_date!} | Fixed64 | 이 시간 이후에는 이 콘텐츠가 더 이상 유효하지 않음. null / 0은 제한 없음을 의미합니다. 클라이언트가 지정합니다. |
${(content_items[0].$canonical_identifier)!} | String | Branch가 콘텐츠 / 메시지를 통합하는 데 사용됩니다. 클라이언트가 지정합니다. |
${(content_items[0].$og_title)!} | String | 렌더링된 문서 제목 (검색용) - 컬렉션인 경우 개별 항목이 아닌 컬렉션의 제목. 클라이언트가 지정합니다. |
${(content_items[0].$canonical_url)!} | String | 공개 웹(모바일 또는 데스크톱)의 콘텐츠와 연결된 웹 URL. 가급적 퍼머링크로 설정해야 하며, 메인 웹사이트나 AMP 페이지 등 다른 곳에서 표준 URL로 사용됩니다. 클라이언트가 지정합니다. |
${(content_items[0].$og_description)!} | String | 설명(개별 항목에 대한). 클라이언트가 지정합니다. |
${(content_items[0].$og_image_url)!} | String | 이미지 URL. 클라이언트가 지정합니다. |
${(content_items[0].$keywords)!} | String | 모든 키워드. 클라이언트가 지정합니다. |
${(content_items[0].$price)!} | Double | 제품 / 콘텐츠의 단가. 클라이언트가 지정합니다. |
${(content_items[0].$price_in_usd)!} | Double | 가격, 통화 및 환율을 기준으로 한 유닛 당 가격(USD). 클라이언트가 지정하거나 서버 측에서 자동으로 설정합니다. |
${(content_items[0].$quantity)!} | Double | The quantity of the item to be ordered (for PURCHASE, ADD_TO_CART, etc). specified by the client. |
${(content_items[0].$value)!} | Double | The value is the product of $price multiplied by $quantity . specified by the client OR set automatically server side. |
${(content_items[0].$value_in_usd)!} | Double | The value in USD (see $value above), based off of price, currency, and exchange rate. specified by the client OR set automatically server side. |
${(content_items[0].$sku)!} | String | 제품 SKU 또는 제품 ID. 클라이언트가 지정합니다. |
${(content_items[0].$product_name)!} | String | The product's name. specified by the client. |
${(content_items[0].$product_brand)!} | String | 제품의 브랜드. 클라이언트가 지정합니다. |
${(content_items[0].$product_variant)!} | String | 제품 변형 (예 : XL). 클라이언트 지정; animals_and_pets_supplies / apparel_and_accessories / arts_and_entertainment / baby_and_toddler / business_and_industrial / cameras_and_optics / electronics / food_beverage_and_tobacco / furniture / hardware / health_and_beauty / home_and_garden / luggage_and_bags / mature / media / office_supplies / religious_and_ceremonial / software / sporting_goods / toys_and_games / vehicles_and_parts |
${(content_items[0].$rating)!} | Double | The rating given by the user on a RATE event. specified by the client. |
${(content_items[0].$rating_average)!} | Double | 항목의 평균 등급. 클라이언트가 지정합니다. |
${(content_items[0].$rating_count)!} | Int64 | 항목의 등급 수. 클라이언트가 지정합니다. |
${(content_items[0].$rating_max)!} | Double | 항목에 대해 가능한 최대 등급 (예 : 별 5개가 가장 높은 등급 ). 클라이언트가 지정합니다. |
${(content_items[0].$address_street)!} | String | 고객이 지정한 레스토랑, 업체, 객실 (호텔) 등의 주소. |
${(content_items[0].$address_city)!} | String | 고객이 지정한 레스토랑, 비즈니스, 객실 (호텔) 등의 도시. |
${(content_items[0].$address_country)!} | String | 고객이 지정한 레스토랑, 비즈니스, 객실 (호텔) 등에 대한 국가 코드. |
${(content_items[0].$address_postal_code)!} | String | 고객이 지정한 레스토랑, 비즈니스, 객실 (호텔) 등에 대한 우편 번호. |
${(content_items[0].$latitude)!} | Float | 클라이언트가 지정한 레스토랑, 비즈니스, 객실 (호텔) 등에 대한 위도. |
${(content_items[0].$longitude)!} | Float | The longitude for a restaurant, business, room (hotel), etc. specified by the client. |
${(content_items[0].$condition)!} | String | 경매의 경우, 해당 품목이 새 상품인지, 좋은 상품인지, 수용 가능한지 등의 여부. 클라이언트 지정; 신품 / 우수 / 좋음 / 보통 / 나쁨 / 중고품 / 리퍼브 상품 / 기타 |
${(content_items[0].$image_captions)!} | String | 이미지와 관련된 캡션. 클라이언트가 지정합니다. |
${(content_items[0].$creation_timestamp)!} | Fixed64 | 콘텐츠가 생성된 시간. 클라이언트가 지정합니다. |
${(content_items[0].$currency)!} | String | The ISO 4217 code of currency. |
${(content_items[0].custom_fields)!} | String | BUO와 관련된 파트너 지정 커스텀 key-value페어. 클라이언트가 지정합니다. |
코호트 관련 데이터
다음 매크로는 설치 또는 리인게이지먼트 활동을 기반으로 코호트 유저와 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
${(install_activity.event_name)!} 또는 ${(reengagement_activity.event_name)!} | String | 코호트 이벤트의 이름. |
<#if install_activity.attributed> 1 <#else> 0 </#if> 또는<#if reengagement_activity.attributed> 1 <#else> 0 </#if> | 불리안(Boolean) | 설치 / 리인게이지먼트 이벤트 어트리뷰션 여부 1 (true/yes) OR 0 (false/no) |
${(install_activity.timestamp)!} 또는 ${(reengagement_activity.timestamp)!} | Fixed64 | 설치 / 리인게이지먼트 시간에 대한 epoch 타임스탬프 (밀리 초) |
${(install_activity.touch_data.tilde_advertising_partner_name)!} 또는 ${(reengagement_activity.touch_data.tilde_advertising_partner_name)!} | String | 최종 어트리뷰션된 터치에 지정된 사람이 읽을 수 있는 광고 파트너 이름. 서버 측에서 자동으로 설정합니다. |
${(install_activity.touch_data.dollar_3p)!} 또는 ${(reengagement_activity.touch_data.dollar_3p)!} | String | 이벤트가 Google AMP 또는 Facebook Instant Article을 터치하여 시작된 경우 설정합니다. 클라이언트가 지정합니다. |
${(install_activity.touch_data.tilde_tune_publisher_id)!} 또는 ${(reengagement_activity.touch_data.tilde_tune_publisher_id)!} | Fixed64 | The publisher ID of the last touch. |
CTA View Data
다음 매크로는 링크 클릭이 없는 Journeys 솔루션 또는 Deepview 데이터와 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
| Fixed64 | 최종 CTA 뷰의 ID. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 캠페인(이름). 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 캠페인 ID. 서버 측에서 자동으로 설정합니다. |
| String | Google 캠페인 유형 Google AAP 필드. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 고객 캠페인. 클라이언트가 링크에 지정할 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 채널. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 feature. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 stage. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 태그. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다. |
| String | 최종 CTA 뷰에 지정된, 사람이 읽을 수 있는 광고 파트너 이름. 서버 측에서 자동으로 설정합니다. |
| String | The ID for the advertising partner specified for the last CTA view. set automatically server side OR specified by the client. |
| String | 최종 CTA 뷰에 지정된 서브 퍼블리셔. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 CTA 뷰에 지정된 서브 퍼블리셔의 ID. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 CTA 뷰에 지정된 서브 퍼블리셔의 ID. 애드 네트워크에 의해 전달됩니다. |
| String | 최종 CTA 뷰에 지정된 크리에이티브 이름. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 크리에이티브 ID. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 광고 세트 이름. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 광고 세트 ID. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 고객 광고 세트 이름. 클라이언트가 링크에 지정할 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 광고 이름. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 광고 ID. 서버 측에서 자동으로 설정합니다. |
| String | 최종 CTA 뷰에 지정된 고객 광고 이름. 클라이언트가 링크에서 지정할 수 있습니다. |
| String | 최종 CTA 뷰에 지정된 키워드. 서버 측에서 자동으로 설정합니다. |
| String | Google에서 제공한 라스트 뷰 키워드의 유니크 ID. |
| String | 라스트 뷰의 고객 키워드 클라이언트가 링크에 지정할 수 있습니다. |
| String | 라스트 뷰의 광고 형식. Branch 링크 생성시 선택한 Ad Format이 분석 태그로 설정됩니다. 예 : Search, Display, Product Ad, App only. |
| String | 분석 태그로 설정된 라스트 뷰의 기술 파트너. 캠페인을 개선하는 데 이용되는 모든 제 3자 (예. 오디언스에 크리에이티브 최적화 제공), 에이전시 제외 |
| String | 분석 태그로 설정된 라스트 뷰의 디스플레이 배너 dimension. |
| String | 분석 태그로 설정된 라스트 뷰의 게재 위치. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트 |
| String | 분석 태그로 설정된 라스트 뷰의 게재 위치 ID . 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트 |
| String | 분석 태그로 설정된 고객 지정 라스트 뷰의 게재 위치. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트 |
| String | 광고가 표시된 사이트에 대한 참조. 애드 네트워크에 의해 전달됩니다. |
| String | 광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다. |
| String | 분석 태그로 설정된 라스트 뷰의 에이전시 . 광고주를 대신하여 광고 캠페인을 실행하는 에이전시 . |
| String | 분석 태그로 설정된 라스트 뷰의 에이전시 ID . 광고주를 대신하여 광고 캠페인을 실행하는 에이전시 . |
| String | 분석 태그로 설정된 라스트 뷰의 최적화 모델 . 캠페인이 최적화하는 이벤트(예 : 설치, 클릭, 이벤트)를 자세히 설명하는 모델 |
| String | 분석 태그 또는 대시보드의 Ad Link 생성 과정에서 설정된 라스트 뷰의 보조 광고 형식 . Google 디스플레이 인게이지먼트 광고와 같은 광고 파트너 별 광고 형식 . |
| String | The ID of click or impression (view) sent to Branch from a third party. Used to tie an attributed event back to the original touch. Where the attributed partner is Google SAN, this will be the gclid value. See |
| String | Journey 오디언스 규칙에 대한 "캠페인 이름" 또는 "제목". 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 설정할 수 있습니다. |
| String | Journey의 오디언스 규칙 ID. 서버 측에서 자동으로 설정합니다. |
| String | Branch View 템플릿의 "View Name" 또는 "제목" 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 사이드를 미리 채울 수 있습니다. |
| String | Journey의 Branch View ID. 서버 측에서 자동으로 설정합니다. |
| String | 유저가 Journey가 있는 페이지에 오기 전 방문한 URL의 도메인. "came directly from a URL" 오디언스 필터링에 사용하는 것과 동일한 데이터 source를 사용합니다. 클라이언트가 지정합니다. |
| String | 이벤트가 Google AMP 또는 Facebook Instant Article을 터치하여 시작된 경우 설정합니다. 클라이언트가 지정합니다. |
| String | The format of the website;
|
${(last_cta_view_data.+via_features)!} | String | 현재 터치의 Branch에 의해 정의된 Branch feature 값. 자동으로 서버 측 설정; desktop_deepviews / desktop_journeys / mobile_deepviews / mobile_journeys / ads / email / social / quick_links |
${(last_cta_view_data.+touch_id)!} | String | 어트리뷰션 터치의 (임프레션, 클릭 등) ID |
${(last_cta_view_data.custom_fields)!} | String | Any deep link data specified for the last view not captured by the above fields e.g. {foo:true, deeplink_path: 'id/12'}. "custom_fields" should not be surfaced as an independent object. The values should be included in last_attributed_touch_data. specified by the client. |
커스텀 데이터
다음 매크로는 Branch에서 사전 할당한 커스텀 데이터 포인트와 관련된 데이터 포인트를 나타냅니다.
Macro | 유형 | 설명 |
---|---|---|
${(custom_data.sub1)!} | String | 클릭에서 설치, 오픈 및 전환 이벤트까지 데이터를 전달하기 위한 범용 필드. |
${(custom_data.sub2)!} | String | 클릭에서 설치, 오픈 및 전환 이벤트까지 데이터를 전달하기 위한 범용 필드. |
${(custom_data.sub3)!} | String | 클릭에서 설치, 오픈 및 전환 이벤트까지 데이터를 전달하기 위한 범용 필드. |
${(custom_data.sub4)!} | String | 클릭에서 설치, 오픈 및 전환 이벤트까지 데이터를 전달하기 위한 범용 필드. |
${(custom_data.sub5)!} | String | 클릭에서 설치, 오픈 및 전환 이벤트까지 데이터를 전달하기 위한 범용 필드. |
${(custom_data.content_id)!} | String | 인앱 이벤트 중에 상호작용한 콘텐츠 ID. |
${(custom_data.content_type)!} | String | 인앱 이벤트 중에 상호작용한 콘텐츠 유형. |
${(custom_data.date1)!} | String | 인앱 이벤트 "예약" 체크인 시간. |
${(custom_data.date2)!} | String | 인앱 이벤트“예약” 체크아웃 시간. |
${(custom_data.level)!} | String | 달성한 이벤트 레벨. |
${(custom_data.quantity)!} | String | 인앱 이벤트와 관련된 수; 예 : 손님 수 또는 사용한 크레딧. |
${(custom_data.rating)!} | String | 인앱 이벤트와 관련된 등급 예 : 별 4개 등급. |
${(custom_data.transaction_id)!} | String | 전환시 기록된 Transaction ID. |
URL Function Macros & Freemarker
Along with our URL macros, we also support a variety of URL functions to be used in conjunction with our macros. Using functions gives you more control over how your data is formatted for your own internal uses.
Branch는 어떤 유형의 액션이 취해지는 지, 그리고 어떤 유형의 정보가 처리되는 지에 따라 각 기능을 카테고리화했습니다.
More information on Freemarker can be found here.
해싱/인코딩/등
Function macros that can hash, encode/decode or otherwise modify another macro’s value; e.g. the MD5 hash of a unique identifier.
해싱/인코딩/등 | 유형 | 설명 |
---|---|---|
<@alphanumeric>INPUT_MACRO_HERE</@alphanumeric> | Function | string에서 영숫자가 아닌 문자를 제거합니다. |
<@base64>INPUT_MACRO_HERE</@base64> | Base64 | Base64는 콘텐츠를 인코딩합니다. |
<@json>INPUT_MACRO_HERE</@json | JSON | JSON은 내용을 string으로 인코딩합니다. |
<@jsonmap>INPUT_MACRO_HERE</@jsonmap> | JSON | JSON은 어떤 방식으로든 데이터를 인코딩합니다 (따옴표를 사용하지 마십시오). |
<@lower>INPUT_MACRO_HERE</@lower> | Function | 콜론을 구분하여 소문자 형식으로 입력된 값을 반환합니다. |
<@md5>INPUT_MACRO_HERE</@md5> | MD5 | MD5는 내용을 인코딩합니다. |
<@sha1>INPUT_MACRO_HERE</@sha1> | SHA1 | SHA1은 내용을 인코딩합니다. |
<@sha256>INPUT_MACRO_HERE</@sha256> | SHA256 | SHA256은 내용을 인코딩합니다. |
<@upper>INPUT_MACRO_HERE</@upper> | Function | 콜론을 구분하여 대문자 형식으로 입력된 값을 반환합니다. |
<@urldecode>INPUT_MACRO_HERE</@urldecode> | Decode | URL은 내용을 해독합니다. |
<@urldecode>INPUT_MACRO_HERE</@urldecode> | Encode | URL은 내용을 인코딩합니다. |
Datetime
다른 매크로의 값에 대한 datetime 정보를 반환하는 함수 매크로;예 : 인앱 구매 이벤트 시간.
형식 | 설명 |
---|---|
<@dateformat output_date_format="yyyy-MM-dd">INPUT_MACRO_HERE</@dateformat> | 지정된 전환의 달력 날짜를 반환합니다. |
<@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">INPUT_MACRO_HERE</@dateformat> | Returns the DateTime of the specified conversion |
<@dateformat output_date_format="TIMESTAMP_SECONDS">INPUT_MACRO_HERE</@dateformat> | 지정된 전환의 현재 유닉스 타임 스탬프를 초 단위로 반환합니다. |
<@dateformat output_date_format="TIMESTAMP_MILLIS">INPUT_MACRO_HERE</@dateformat> | 지정된 전환의 현재 unix 타임스탬프(밀리 초)를 반환합니다. |
<@iso8601UTCDate>INPUT_MACRO_HERE</@iso8601UTCDate> | Format a DateTime value in ISO 8601 UTC. Returns an empty string for missing data or data that is not a DateTime . As DateTime doesn’t store millisecond precision, milliseconds are hard-coded to 000 |
일반 조치
다양한 일반 사용 작업을 수행하는 기능 매크로 예 : boolean 값을 integer로 수정.
Action | 설명 | |
---|---|---|
<@countryCodeIso3166>INPUT_MACRO_HERE</@countryCodeIso3166> | Returns the ISO 3166-1 two-letter country code. | |
<@firstNotEmpty>INPUT_MACRO_HERE</@firstNotEmpty> | Gets the first value that isn’t empty in a ` | ` delimited string. |
<@languageIso639>INPUT_MACRO_HERE</@languageIso639> | Returns the ISO 639-1 two-character language code. | |
<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID"><@break/><#elseif bundle.os == "IOS">${(bundle.ios.itunes_id?substring(2))!}</#if><@break/></#if></@loop> | Return the store_app_id for an iOS site and a package_name for an Android site. | |
<@loop>INPUT_MACRO_HERE</@loop> , <@break> , <@sep> | 데이터에 지정된 변수 주위를 Loop하여 각각의 연속 변수를 val에 지정된 이름에 할당합니다. 데이터를 따옴표로 묶지 않도록 유의하세요. | |
<@rand>INPUT_MACRO_HERE</@rand> | 0에서 2^31 사이의 임의 값을 반환합니다. | |
<@ternary>INPUT_MACRO_HERE</@ternary> | A basic implementation of ternary functionality that uses | to separate parameters This function must receive 4 parameters or nothing will be returned. Given parameter 0 matches parameter 1, parameter 2 will be returned. Given parameter 0 does not match parameter 1, parameter 3 will be returned. | |
<@truncate>INPUT_MACRO_HERE</@truncate> | 길이가 40자로 단축된 값을 반환합니다. | |
<#assign captured>%s</#assign><#if captured>1<#else>0</#if> | Casts a boolean string to its integer counter part. | |
<#if (last_attributed_touch_data["~tune_publisher_id"])! == %s>1<#else>0</#if> | Return whether or not the install or event is attributed to the same partner as the postback partner; returns 1 = true or 0 = false. | |
<#if user_data.os == "IOS">0<#elseif user_data.os == "ANDROID">1<#elseif user_data.os == "WINDOWS">2<#else>null</#if> | Return the platform as an integer ios = 0, android = 1, windows = 2. |
Unsupported Freemarker Expressions
보안 제한으로 인해 Branch는 아래의 Freemarker 표현식을 서포트하지 않습니다.
<#import>
<#visit>
<#include>
?eval
<#recurse>
<#setting>
<#macro>
<#function>
<#nested>
<#return>
<#list>
Updated 6 days ago