포스트백 매크로 및 기능

Overview

다음 목록은 Branch가 포스트백 URL 및 웹훅에서 서포트하는 매크로 및 가용한 기능을 보여줍니다. 이러한 매크로 및 함수를 사용할 때 Branch는 지정된 포스트백 URL에 알리기 전에 동적으로 해당 값을 확인/대체합니다.

URL 매크로

수집되는 정보 유형에 따라 매크로를 카테고리로 그룹화 하였습니다.

📘

함수를 사용하여 포스트백 매크로 수정

모든 포스트백 매크로는 다양한 포스트백 URL 기능을 사용하여 해시/암호화/수정할 수 있습니다. 다음 포스트백 매크로에 적용할 수 있는 사용 가능한 포스트백 URL 함수에 대한 정보는 아래의 URL 함수 매크로 섹션을 참조하십시오.

포스트백 데이터

다음 매크로는 포스트백 이벤트와 관련된 상위 레벨의 데이터 포인트를 나타냅니다.

Macro

유형

설명

${(name)!}

String

The name of the postback event. The list of event names can be found here.

${(customer_event_alias)!}

String

The alias name of the event provided by the customer; used in addition to the standard Branch names defined in the namefield.

${(organization_id)!}

Fixed64

The ID associated with your organization for which the event occurred; assigned by Branch.

${(organization_name)!}

String

The name of your organization for which the event occurred; provided during account setup.

${(event_timestamp)!}

Fixed64

The UNIX timestamp in milliseconds for the event; set automatically server side.

${(origin)!}

String

Where the attribution was recorded:

  • branch
  • segment
  • mparticle
  • tune

${(id)!}

String

이벤트와 관련된 ID ; Branch가 할당합니다.

<#if attributed>
    1
<#else>
    0
</#if>

불리안(Boolean)

이벤트 어트리뷰션 여부; 1 (true/yes) 또는 0 (false/no)

${(days_from_last_attributed_touch_to_event)!}

Int32

마지막으로 어트리뷰션된 터치와 이벤트 사이의 일 수.

${(hours_from_last_attributed_touch_to_event)!}

Int32

마지막으로 어트리뷰션된 터치와 이벤트 사이의 시간; 24로 제한.

${(minutes_from_last_attributed_touch_to_event)!}

Int32

마지막으로 어트리뷰션된 터치와 이벤트 사이의 분; 60으로 제한.

${(seconds_from_last_attributed_touch_to_event)!}

Int32

마지막으로 어트리뷰션된 터치와 이벤트 사이의 초; 60으로 제한.

${(last_attributed_touch_type)!}

String

The type of the attribution the event was for:

  • click
  • impression
  • impression

${(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

유형

설명

${(last_attributed_touch_data.~id)!}

Fixed64

최종 어트리뷰션된 터치의 ID (Quick Link만 해당). 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~campaign)!}

String

최종 터치한 것으로 어트리뷰션된 캠페인(이름). 클라이언트가 링크에서 지정하거나 경우에 따라 서버 측에서 자동으로 설정할 수 있습니다.

${(last_attributed_touch_data.~campaign_id)!}

String

최종 어트리뷰션한 터치에 지정된 캠페인 ID. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~campaign_type)!}

String

Google 캠페인 유형 Google AAP 필드. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~customer_campaign)!}

String

라스트 어트리뷰션 터치에서 확인된 고객 캠페인입니다. 클라이언트가 링크에 지정할 수 있습니다.

${(last_attributed_touch_data.~channel)!}

String

라스트 어트리뷰션 터치에 지정된 채널. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다.

${(last_attributed_touch_data.~feature)!}

String

라스트 어트리뷰션 터치에 지정된 feature. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다.

${(last_attributed_touch_data.~stage)!}

String

마지막으로 어트리뷰션 된 터치에 지정된 단계. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다.

${(last_attributed_touch_data.~tags)!}

String

최종 어트리뷰션된 터치에 지정된 태그. 클라이언트가 링크에서 지정하거나 경우에 따라 서버 측에서 자동으로 설정할 수 있습니다.

${(last_attributed_touch_data.~advertising_partner_name)!}

String

최종 어트리뷰션된 터치에 지정된 사람이 읽을 수 있는 광고 파트너 이름. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~advertising_partner_id)!}

String

The ID for the advertising partner specified for the last attributed touch. set automatically server side OR specified by the client.

${(last_attributed_touch_data.~secondary_publisher)!}

String

최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔. 애드 네트워크에 의해 전달됩니다.

${(last_attributed_touch_data.~secondary_publisher_id)!}

String

최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔 ID. 애드 네트워크에 의해 전달됩니다.

${(last_attributed_touch_data.~customer_secondary_publisher)!}

String

최종 어트리뷰션된 터치에 지정된 서브 퍼블리셔 ID. 애드 네트워크에 의해 전달됩니다.

${(last_attributed_touch_data.~creative_name)!}

String

최종 어트리뷰션된 터치에 지정된 크리에이티브 이름. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~creative_id)!}

String

최종 어트리뷰션된 터치에 지정된 크리에이티브 ID. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~ad_set_name)!}

String

The ad set name specified for the last attributed touch. set automatically server side.

${(last_attributed_touch_data.~ad_set_id)!}

String

The ad set ID specified for the last attributed touch. set automatically server side.

${(last_attributed_touch_data.~customer_ad_set_name)!}

String

The customer ad set name specified for the last attributed touch. can be specified on links by the client.

${(last_attributed_touch_data.~ad_name)!}

String

The ad name specified for the last attributed touch. set automatically server side.

${(last_attributed_touch_data.~ad_id)!}

String

The ad ID specified for the last attributed touch. set automatically server side.

${(last_attributed_touch_data.~customer_ad_name)!}

String

라스트 어트리뷰션 터치에서 확인된 고객 광고 이름입니다. 클라이언트가 링크에 지정할 수 있습니다.

${(last_attributed_touch_data.~keyword)!}

String

The keyword specified for the last attributed touch. set automatically server side.

${(last_attributed_touch_data.~keyword_id)!}

String

The unique ID for keyword of the last touch as provided by Google.

${(last_attributed_touch_data.~customer_keyword)!}

String

마지막 터치의 고객 키워드입니다. 클라이언트가 링크에 지정할 수 있습니다.

${(last_attributed_touch_data.~branch_ad_format)!}

String

최종 터치의 광고 형식. Branch Link 생성 시 선택한 Ad Format이 분석 태그로 설정됩니다. 예: Search, Display, Product Ad, App only.

${(last_attributed_touch_data.~technology_partner)!}

String

분석 태그로 설정된 마지막 터치의 기술 파트너입니다. 에이전시를 제외하고 캠페인을 개선시키는 데 사용되는 모든 써드파티 (예 : 제공되는 오디언스, 크리에이티브 최적화).

${(last_attributed_touch_data.~banner_dimensions)!}

String

분석 태그로 설정된 마지막 터치의 디스플레이 배너 크기

${(last_attributed_touch_data.~placement)!}

String

분석 태그로 설정된 마지막 터치의 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.

${(last_attributed_touch_data.~placement_id)!}

String

분석 태그로 설정된 마지막 터치의 게재 위치 ID입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.

${(last_attributed_touch_data.~customer_placement)!}

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.

${(last_attributed_touch_data.~sub_site_name)!}

String

광고가 표시된 사이트에 대한 참조. 애드 네트워크에 의해 전달됩니다.

${(last_attributed_touch_data.~customer_sub_site_name)!}

String

광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다.

${(last_attributed_touch_data.~agency)!}

String

The agency of the last touch, as set with an analytics tag. Agency that runs ad campaigns on behalf of advertiser.

${(last_attributed_touch_data.~agency_id)!}

String

The ID of agency of the last touch, as set with an analytics tag. Agency that runs ad campaigns on behalf of advertiser.

${(last_attributed_touch_data.~optimization_model)!}

String

분석 태그로 설정된 마지막 터치의 최적화 모델. 캠페인이 최적화하는 이벤트 (예 : 설치, 클릭, 이벤트)를 자세히 설명하는 모델입니다.

${(last_attributed_touch_data.~secondary_ad_format)!}

String

분석 태그 또는 대시보드의 Ad Link 생성 과정에서 설정된 최종 터치의 보조 광고 형식. Google 디스플레이 인게이지먼트 광고와 같은 광고 파트너별 광고 형식.

${(last_attributed_touch_data.~external_touch)!}

String

써드파티가 Branch로 보낸 클릭 또는 임프레션(광고 노출)의 ID. 어트리뷰션된 이벤트를 기존 터치에 연결하는 데 사용됩니다. 어트리뷰션 파트너가 Google SAN 인 경우 이는 gclid 값이 됩니다. 자세한 내용은 이 시트의 gclid를 참조하세요.

${(last_attributed_touch_data.~journey_name)!}

String

Journeys 오디언스 규칙에 대한 "캠페인 이름" 또는 "제목"입니다. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다.

${(last_attributed_touch_data.~journey_id)!}

String

Journey의 오디언스 규칙 ID. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.~view_name)!}

String

Branch Journeys View 템플릿의 "View Name" 또는 "제목"입니다. 클라이언트가 링크에 지정하거나 경우에 따라 서버 측에서 자동으로 미리 채워질 수 있습니다.

${(last_attributed_touch_data.~view_id)!}

String

Journey의 Branch View ID. 서버 측에서 자동으로 설정합니다.

${(last_attributed_touch_data.+referring_domain)!}

String

유저가 Journey가 있는 페이지에 오기 전 방문한 URL의 도메인. "came directly from a URL" 오디언스 필터링에 사용하는 것과 동일한 데이터 source를 사용합니다. 클라이언트가 지정합니다.

${(last_attributed_touch_data.dollar_3p)!}

String

이벤트가 Google AMP 또는 Facebook Instant Article을 터치하여 시작된 경우 설정합니다. 클라이언트가 지정합니다.

${(last_attributed_touch_data.+web_format)!}

String

The format of the webside:

  • amp
  • instant_articles

${(last_attributed_touch_data.+current_features)!}

String

Branch feature (determined by Branch) of the current touch. set automatically server side;

  • desktop_deepviews
  • desktop_journeys
  • mobile_deepviews
  • mobile_journeys
  • ads
  • email
  • social
  • quick_links

${(last_attributed_touch_data.+via_features)!}

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:

  • EMAIL
  • JOURNEYS

or set server side:

  • desktop_deepviews
  • desktop_journeys
  • mobile_deepviews
  • mobile_journeys
  • ads
  • email
  • social
  • quick_links
<#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

유형

설명

${(user_data.os)!}

String

The operating system of the device on which the event was registered:

${(user_data.os_version)!}

String

The version of the operating system of the device on which the event was registered; specified by client.

${(user_data.os_version_android)!}

String

이벤트가 발생한 디바이스의 운영 체제 버전(안드로이드); 클라이언트가 지정합니다.

${(user_data.environment)!}

String

The runtime environment where the event occurred:

  • full_web
  • full_app
  • instant_app
  • imessage_app

${(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

유형

설명

${(event_data.transaction_id)!}

String

The partner-specified transaction id for their internal use. specified by the client.

${(event_data.currency)!}

String

ISO 4217 Code for currency.

${(event_data.revenue)!}

Double

The partner-specified revenue for the event. specified by the client.

${(event_data.revenue_in_usd)!}

Double

Revenue in USD, based off of revenue, currency, and exchange rate. set automatically server side.

${(event_data.exchange_rate)!}

Double

이벤트가 발생한 시점의 환율 (최대 24 시간까지일 수 있으나 일반적으로 1시간 내에 업데이트됨). 클라이언트가 지정합니다.

${(event_data.shipping)!}

Double

Transaction과 관련된 배송 비용. 클라이언트가 지정합니다.

${(event_data.tax)!}

Double

Transaction과 관련된 총 세금. 클라이언트가 지정합니다.

${(event_data.coupon)!}

String

Transaction과 함께 사용한 Transaction 쿠폰 (예 : "SPRING2017"). 클라이언트가 지정합니다.

${(event_data.affiliation)!}

String

이 Transaction이 발생한 상점 또는 제휴처 (예 : Google Store). 클라이언트가 지정합니다.

${(event_data.search_query)!}

String

Search query associated with the event. specified by the client.

${(event_data.ad_type)!}

String

Ad type that the user saw or clicked on. Defined by Facebook. specified by the client:

  • banner
  • interstitial
  • rewarded_video
  • native

${(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

유형

설명

${(last_cta_view_data.~id)!}

Fixed64

최종 CTA 뷰의 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~campaign)!}

String

최종 CTA 뷰에 지정된 캠페인(이름). 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다.

${(last_cta_view_data.~campaign_id)!}

String

최종 CTA 뷰에 지정된 캠페인 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~campaign_type)!}

String

Google 캠페인 유형 Google AAP 필드. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~customer_campaign)!}

String

최종 CTA 뷰에 지정된 고객 캠페인. 클라이언트가 링크에 지정할 수 있습니다.

${(last_cta_view_data.~channel)!}

String

최종 CTA 뷰에 지정된 채널. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다.

${(last_cta_view_data.~feature)!}

String

최종 CTA 뷰에 지정된 feature. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다.

${(last_cta_view_data.~stage)!}

String

최종 CTA 뷰에 지정된 stage. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다.

${(last_cta_view_data.~tags)!}

String

최종 CTA 뷰에 지정된 태그. 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 미리 채워질 수 있습니다.

${(last_cta_view_data.~advertising_partner_name)!}

String

최종 CTA 뷰에 지정된, 사람이 읽을 수 있는 광고 파트너 이름. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~advertising_partner_id)!}

String

The ID for the advertising partner specified for the last CTA view. set automatically server side OR specified by the client.

${(last_cta_view_data.~secondary_publisher)!}

String

최종 CTA 뷰에 지정된 서브 퍼블리셔. 애드 네트워크에 의해 전달됩니다.

${(last_cta_view_data.~secondary_publisher_id)!}

String

최종 CTA 뷰에 지정된 서브 퍼블리셔의 ID. 애드 네트워크에 의해 전달됩니다.

${(last_cta_view_data.~customer_secondary_publisher)!}

String

최종 CTA 뷰에 지정된 서브 퍼블리셔의 ID. 애드 네트워크에 의해 전달됩니다.

${(last_cta_view_data.~creative_name)!}

String

최종 CTA 뷰에 지정된 크리에이티브 이름. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~creative_id)!}

String

최종 CTA 뷰에 지정된 크리에이티브 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~ad_set_name)!}

String

최종 CTA 뷰에 지정된 광고 세트 이름. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~ad_set_id)!}

String

최종 CTA 뷰에 지정된 광고 세트 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~customer_ad_set_name)!}

String

최종 CTA 뷰에 지정된 고객 광고 세트 이름. 클라이언트가 링크에 지정할 수 있습니다.

${(last_cta_view_data.~ad_name)!}

String

최종 CTA 뷰에 지정된 광고 이름. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~ad_id)!}

String

최종 CTA 뷰에 지정된 광고 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~customer_ad_name)!}

String

최종 CTA 뷰에 지정된 고객 광고 이름. 클라이언트가 링크에서 지정할 수 있습니다.

${(last_cta_view_data.~keyword)!}

String

최종 CTA 뷰에 지정된 키워드. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~keyword_id)!}

String

Google에서 제공한 라스트 뷰 키워드의 유니크 ID.

${(last_cta_view_data.~customer_keyword)!}

String

라스트 뷰의 고객 키워드 클라이언트가 링크에 지정할 수 있습니다.

${(last_cta_view_data.~branch_ad_format)!}

String

라스트 뷰의 광고 형식. Branch 링크 생성시 선택한 Ad Format이 분석 태그로 설정됩니다. 예 : Search, Display, Product Ad, App only.

${(last_cta_view_data.~technology_partner)!}

String

분석 태그로 설정된 라스트 뷰의 기술 파트너. 캠페인을 개선하는 데 이용되는 모든 제 3자 (예. 오디언스에 크리에이티브 최적화 제공), 에이전시 제외

${(last_cta_view_data.~banner_dimensions!}

String

분석 태그로 설정된 라스트 뷰의 디스플레이 배너 dimension.

${(last_cta_view_data.~placement)!}

String

분석 태그로 설정된 라스트 뷰의 게재 위치. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트

${(last_cta_view_data.~placement_id)!}

String

분석 태그로 설정된 라스트 뷰의 게재 위치 ID . 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트

${(last_cta_view_data.~customer_placement)!}

String

분석 태그로 설정된 고객 지정 라스트 뷰의 게재 위치. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹 사이트

${(last_cta_view_data.~sub_site_name)!}

String

광고가 표시된 사이트에 대한 참조. 애드 네트워크에 의해 전달됩니다.

${(last_cta_view_data.~customer_sub_site_name)!}

String

광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다.

${(last_cta_view_data.~agency)!}

String

분석 태그로 설정된 라스트 뷰의 에이전시 . 광고주를 대신하여 광고 캠페인을 실행하는 에이전시 .

${(last_cta_view_data.~agency_id)!}

String

분석 태그로 설정된 라스트 뷰의 에이전시 ID . 광고주를 대신하여 광고 캠페인을 실행하는 에이전시 .

${(last_cta_view_data.~optimization_model)!}

String

분석 태그로 설정된 라스트 뷰의 최적화 모델 . 캠페인이 최적화하는 이벤트(예 : 설치, 클릭, 이벤트)를 자세히 설명하는 모델

${(last_cta_view_data.~secondary_ad_format)!}

String

분석 태그 또는 대시보드의 Ad Link 생성 과정에서 설정된 라스트 뷰의 보조 광고 형식 . Google 디스플레이 인게이지먼트 광고와 같은 광고 파트너 별 광고 형식 .

${(last_cta_view_data.~external_touch_id)!}

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 gclid in this sheet for more information.

${(last_cta_view_data.~journey_name)!}

String

Journey 오디언스 규칙에 대한 "캠페인 이름" 또는 "제목". 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 측에서 설정할 수 있습니다.

${(last_cta_view_data.~journey_id)!}

String

Journey의 오디언스 규칙 ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.~view_name)!}

String

Branch View 템플릿의 "View Name" 또는 "제목" 클라이언트가 링크에 지정하거나 경우에 따라 자동으로 서버 사이드를 미리 채울 수 있습니다.

${(last_cta_view_data.~view_id)!}

String

Journey의 Branch View ID. 서버 측에서 자동으로 설정합니다.

${(last_cta_view_data.plus_referring_domain)!}

String

유저가 Journey가 있는 페이지에 오기 전 방문한 URL의 도메인. "came directly from a URL" 오디언스 필터링에 사용하는 것과 동일한 데이터 source를 사용합니다. 클라이언트가 지정합니다.

${(last_cta_view_data.3p)!}

String

이벤트가 Google AMP 또는 Facebook Instant Article을 터치하여 시작된 경우 설정합니다. 클라이언트가 지정합니다.

${(last_cta_view_data.+web_format)!}

String

The format of the website;

  • amp
  • instant_articles

${(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>

비어 있지 않은 첫 번째 값을 가져옵니다. | 범위가 정해진 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>