매크로

매크로는 URL의 서버 요청에서 동적으로 변경되는 값의 placeholder입니다. 이 매크로는 Tenjin 통합 네트워크 용으로 미리 구성되어 있지만, 매크로가 작동하는 방식을 학습하면 추가하려는 모든 커스텀 채널에 유용할 수 있습니다.

왜 우리는 매크로가 필요한가?

불변의 추적 링크 매개 변수를 통해 동적으로 변경되는 데이터를 전달하는 매크로가 필요합니다. 이것을 풀기 위해 URL, 매개 변수, 값 및 동적으로 변경되는 값이 속성 내에서 작동하는 방법을 아래에서 설명합니다.

URL과 매개 변수

https://track.tenjin.io?param1=value1

표준 URL인 https://track.tenjin.io?param1=value1을 살펴보겠습니다. 이 URL에는 서버 주소 track.tenjin.io가 있고 값 1로 설정된 단일 매개 변수 param1이 있음을 알 수 있습니다. 이 URL이 track.tenjin.io 서버에 도착하면 Tenjin 서버는 이 URL을 읽고 매개 변수와 값을 구문 분석합니다. 이 경우 param1value1로 설정됩니다.

기여 매개 변수 및 값과 관련된 좀 더 현실적인 예에서는, 이 URL은 두 개의 변수 (advertising_idcountry)와 두 개의 값, https://track.tenjin.io? advertising_id=xyz123&country=US로 가져옵니다. 이 요청이 Tenjin 서버에 있는 track.tenjin.io에 도착하면, 서버에 도달한 advertising_id는 미국 xyz123인 것을 알 수 있습니다.

동적 매개 변수 값

이제 값과 매개 변수를 서버에 전달하는 방법을 알았기 때문에, attribution 및 추적의 맥락에서 URL을 사용하는 방법을 살펴보겠습니다.

Tenjin이 사용자를 클릭 또는 노출로 분류하기 위해, Tenjin은 각 클릭 또는 노출에 대한 기기 정보 및 속성을 수집합니다. 이 속성은 장치에서 앱을 설치할 때 수집된 속성과 일치시키는데 사용됩니다.

Tenjin 추적 URL은 비 SAN 네트워크나 커스텀 채널에 대한 캠페인을 만들 때마다 생성됩니다. 이 추적 URL에는 클릭 또는 노출 주변의 변화하는 값에 동적으로 적응하는 “매크로"가 포함됩니다. 매크로는 특정 URL에서 변경되는 값의 placeholder로 사용됩니다. 비 SAN 네트워크에서 캠페인을 실행하고 싶다고 가정해보겠습니다. Tenjin 대시보드를 통해 추적 링크를 만들고 이를 광고 네트워크에 제공합니다.

Tenjin의 추적 링크는 다음과 같습니다:

https://track.tenjin.io?advertising_id={idfa}&click_id={click_id}

이 경우 {idfa}{country}는 매크로입니다. 기기에서 이 링크를 사용하면 광고 네트워크가 이러한 매크로를 기기의 실제 값으로 채웁니다. 앞의 예제를 사용하면 {idfa}{country}가 각각 xyz123US 값을 채웁니다.

입력이 완료되면, 광고 네트워크 또는 채널은 다음 URL을 사용하여 Tenjin의 서버에 도달합니다:

https://track.tenjin.io?advertising_id=xyz123&click_id=test

또는 사용자의 기기가 변경되어 advertising_idabc234이고 국가가 CA인 경우 URL은 다음으로 변경됩니다: 보시다시피, 이러한 시나리오는 동일한 URL을 사용하지만 추적 링크를 사용하는 장치/사용자를 기반으로 값을 변경합니다.

https://track.tenjin.io?advertising_id=abc234&click=test2

매크로를 사용하면 광고 네트워크에서 각 사용자의 클릭/노출 URL을 변경할 수 있습니다. 이러한 매크로는 여러 사용자가 추적 링크와 상호 작용할 때 변경되는 값의 단순한 placeholder입니다.

광고 네트워크 추적 링크용 매크로

각 광고 네트워크에는 다음 기기 속성에 대한 클릭 매크로 및 노출 매크로 세트가 있습니다:

  • Advertising ID (광고 ID)
  • IP address (IP 주소)
  • Bundle ID (번들 ID)
  • Country (국가)
  • Click ID (클릭 ID)
  • Site (주소)
  • OS Platform (OS 플랫폼)
  • Limit Ad Tracking (광고 추적 제한)
  • Creative (크레이티브)

광고 네트워크가 미리 구성되어 있고 Tenjin과 통합되어있는 경우, 각 캠페인의 각 클릭 URL 또는 노출 추적 링크에 각 광고 네트워크 매크로가 자동으로 표시됩니다.

例:

  • AppLovin advertising_id 매크로는 다음과 같이 나타납니다: {IDFA}
  • Tapjoy advertising_id 매크로는 다음과 같이 나타납니다: TAPJOY_ADVERTISING_ID

결과적으로 Applovin과 Tapjoy 클릭 url은 다음과 같이 나타날 수 있습니다:

  • AppLovin: https://track.tenjin.io/v0/id?advertising_id={IDFA}
  • Tapjoy: https://track.tenjin.io/v0/id?advertising_id=TAPJOY_ADVERTISING_ID

다시 말하자면, 각 네트워크는 자체 매크로 형식을 갖습니다. 네트워크가 이미 Tenjin과 사전 통합되어 있다면 걱정할 필요가 없습니다. 이렇게하면 클릭 수 및 노출 수 URL이 어떻게 구성되는지 알 수 있습니다.

Tenjin 콜백 및 라우팅 이벤트용 매크로

다른 서비스에 대한 Tenjin 콜백을 설정할 때 매크로를 사용하여 동적으로 변경되는 데이터 값을 다른 서버/서비스로 보낼 수 있습니다. 이것을 우리는 “라우팅"이라고 부릅니다.下記が使用可能なマクロになります。 Tenjin은 귀하가 실시간 이벤트 데이터를 실시간으로 다른 서버들로 “라우트"할 수 있게 합니다. 이것은 다른 서비스에 데이터를 보낼 때 설정할 수 있는 사용 가능한 콜백 매크로의 목록입니다.

매크로 설명
{{bundle_id}} Bundle ID of the app. (com.tenjin.wordfinder)
{{lowercase_bundle_id}} Lower case of bundle ID of the app. (com.tenjin.wordfinder)
{{platform}} Platform of the app. (ios)
{{store_id}} App Store ID of the app. (887212194)
{{time_in_ms}} Request time in milliseconds.
{{time_in_seconds}} Request time in seconds.
{{time_iso8601}} Request time in ISO 8601 format.
{{engaged_at_ms}} Timestamp for click or impression event in milliseconds
{{acquired_at_ms}} Timestamp for install event in milliseconds
{{advertising_id}} Advertising identifier of the device.
{{lowercase_advertising_id}} Lower case of advertising identifier of the device.
{{md5_advertising_id}} MD5 of the advertising identifier.
{{developer_device_id}} Identifier for Vendor (IDFV) or the developer device ID.
{{allow_ad_tracking}} Device allows ad tracking? (true, false)
{{limit_ad_tracking}} Device limits ad tracking? (true, false)
{{allow_ad_tracking_integer}} Device allows ad tracking? (1, 0)
{{limit_ad_tracking_integer}} Device limits ad tracking? (1, 0)
{{ip_address}} User's IP address.
{{country}} Country code of the user's device.
{{campaign_name}} Tenjin Campaign Name that the user is attributed to.
{{tenjin_campaign_id}} Tenjin Campaign ID that the user is attributed to.
{{remote_campaign_id}} Channel's Campaign ID that the user is attributed to.
{{click_id}} Channel's click ID if the user is attributed to paid channels.
{{referrer}} Android referrer
{{site_id}} Channel's Site ID that a user is attributed to.
{{ad_network}} Channel name that a user is attributed to.
{{revenue}} Gross revenue earned for a purchase in original currency
{{currency}} Currency code of the purchase.
{{revenue_usd_net}} Net revenue in USD for a purchase.
{{revenue_usd_gross}} Gross revenue in USD for a purchase.
{{device}} User's device.
{{os_version}} User's OS version.
{{app_version}} User's app version.
{{sdk_version}} User's Tenjin SDK version.
{{language}} User's language setting.
{{value}} Custom event value.
{{tenjin_parameter_0}} Pass through macro you can pass through from click url.
{{tenjin_parameter_1}} Pass through macro you can pass through from click url.
{{tenjin_parameter_2}} Pass through macro you can pass through from click url.
{{tenjin_parameter_3}} Pass through macro you can pass through from click url.
{{tenjin_parameter_4}} Pass through macro you can pass through from click url.
{{tenjin_parameter_5}} Pass through macro you can pass through from click url.

라우팅 혹은 라우팅 세션의 매크로를 사용하는 방법에 대해 자세히 읽을 수 있습니다.

results matching ""

    No results matching ""