Hàm gọi lại

Thời gian đọc: 10 phút

#

Các hàm macro gọi lại #

Macro là các ký hiệu đại diện cho các giá trị thay đổi động trong yêu cầu máy chủ của một URL. Các macro này đã được cấu hình sẵn cho các mạng tích hợp với Tenjin, nhưng việc tìm hiểu cách thức hoạt động của macro có thể hữu ích cho bất kỳ kênh tùy chỉnh nào mà bạn muốn thêm vào.

Tại sao chúng ta cần các macro? #

Chúng ta cần các macro để truyền dữ liệu thay đổi động qua các tham số liên kết theo dõi không thay đổi.

Để làm rõ vấn đề này, chúng tôi sẽ giải thích cách thức hoạt động của các URL, tham số, giá trị và các giá trị thay đổi động trong Attribution.

URL và tham số #

Hãy cùng xem xét một URL tiêu chuẩn: https://track.tenjin.com?param1=value1. Trong URL này, bạn có thể thấy có một địa chỉ máy chủ track.tenjin.io và một tham số duy nhất param1 được đặt thành giá trị value1. Khi URL này truy cập vào máy chủ track.tenjin.io, máy chủ của Tenjin sẽ đọc URL này và phân tích tham số và giá trị. Trong trường hợp này, param1 được đặt thành value1.

Để lấy một ví dụ thực tế hơn liên quan đến các tham số và giá trị Attribution, hãy xem URL này có hai tham số (id_quảng_cáo và quốc gia) và hai giá trị: https://track.tenjin.com?advertising_id=xyz123&country=US. Khi yêu cầu này đến máy chủ Tenjin tại track.tenjin.com, chúng ta biết rằng id_quảng_cáo thiết bị đó đã kết nối với máy chủ xyz123 với một quốc gia của Hoa Kỳ.

Giá trị tham số động #

Giờ đây, khi chúng ta đã biết cách các giá trị và tham số được truyền đến máy chủ, hãy cùng tìm hiểu cách sử dụng URL trong bối cảnh xác định nguồn gốc và theo dõi.

Để Tenjin có thể gán người dùng cho một lần nhấp hoặc một lần hiển thị, Tenjin thu thập thông tin thiết bị và các thuộc tính tại mỗi lần nhấp hoặc lần hiển thị. Các thuộc tính này được sử dụng để đối chiếu với các thuộc tính đã thu thập khi thiết bị cài đặt ứng dụng.

Một URL theo dõi Tenjin sẽ được tạo ra mỗi khi bạn tạo một chiến dịch cho một mạng lưới không thuộc SAN hoặc một kênh tùy chỉnh. URL theo dõi này chứa các “macro” có khả năng tự động điều chỉnh theo các giá trị thay đổi liên quan đến lượt nhấp hoặc lượt hiển thị. Các macro được sử dụng như các ký hiệu giữ chỗ cho các giá trị thay đổi trong một URL cụ thể.

Giả sử bạn muốn chạy một chiến dịch trên một mạng không thuộc SAN. Bạn tạo một liên kết theo dõi thông qua bảng điều khiển Tenjin và cung cấp liên kết này cho Mạng quảng cáo của mình.

Đây là ví dụ về một liên kết theo dõi từ Tenjin:

https://track.tenjin.com?advertising_id={idfa}&country={country}

Trong trường hợp này {idfa} và {quốc gia} là các trường macro. Khi một thiết bị sử dụng liên kết này, Mạng quảng cáo sẽ điền vào các trường macro này bằng các giá trị thực tế của thiết bị. Dựa trên ví dụ trước đó, {idfa} và {quốc gia} sẽ điền các giá trị bằng xyz123 và Hoa Kỳ tương ứng.

Sau khi điền xong, Mạng quảng cáo hoặc kênh sẽ gửi yêu cầu đến máy chủ của Tenjin thông qua URL sau:

https://track.tenjin.com?advertising_id=xyz123&country=US

Hoặc, nếu thiết bị của người dùng thay đổi và có advertising_id là abc234 cùng với country là CA, thì URL sẽ thay đổi thành:

https://track.tenjin.com?advertising_id=abc234&country=CA

Như bạn có thể thấy, các tình huống này đều sử dụng cùng một URL, nhưng các giá trị sẽ thay đổi tùy theo thiết bị/người dùng đang sử dụng liên kết theo dõi.

Các macro cho phép các mạng quảng cáo thay đổi URL cho mỗi lần nhấp chuột/lần hiển thị của người dùng. Các macro này chỉ đơn giản là các ký hiệu giữ chỗ cho các giá trị thay đổi khi các người dùng khác nhau tương tác với các liên kết theo dõi.

#

Các macro dành cho các hàm gọi lại của mạng quảng cáo #









 #



Các macro được hỗ trợ #

Khi thiết lập callback Tenjin đến một dịch vụ khác, bạn có thể sử dụng các macro để biểu diễn các giá trị dữ liệu thay đổi động nhằm gửi đến các máy chủ/dịch vụ khác. Đây chính là điều mà chúng ta gọi là “Routing”.



Tenjin cho phép bạn “chuyển tiếp” dữ liệu sự kiện trực tiếp đến các máy chủ khác theo thời gian thực.



Dưới đây là danh sách các macro callback có sẵn mà bạn có thể thiết lập khi gửi dữ liệu đến các dịch vụ khác.



Các macro liên quan đến ứng dụng #



Macro Giải thích
{{app_version}} Phiên bản ứng dụng. (1.0.3)
{{bundle_id}} ID gói của ứng dụng. (com.tenjin.wordfinder)
{{lowercase_bundle_id}} ID gói của ứng dụng viết thường. (com.tenjin.wordfinder)
{{platform}} Nền tảng của ứng dụng (iOS)
{{user_agent}} Trình duyệt của người dùng
{{sdk_version}} Phiên bản Tenjin SDK của người dùng
{{store_id}} ID ứng dụng trên App Store (887212194)



Các macro liên quan đến ghi nguồn #



Macro Giải thích
{{acquired_at_s}} Dấu thời gian của sự kiện Cài đặt (tính bằng giây)
{{acquired_at_ms}} Dấu thời gian cho sự kiện Cài đặt, tính bằng mili giây
{{engaged_at_s}} Dấu thời gian cho sự kiện nhấp chuột hoặc hiển thị, tính bằng giây
{{engaged_at_ms}} Dấu thời gian cho sự kiện nhấp chuột hoặc hiển thị, tính bằng mili giây
{{ad_network}} Tên kênh mà người dùng được gán vào
{{campaign_id}} Tương tự như {{remote_campaign_id}}
{{campaign_name}} Tên chiến dịch Tenjin mà người dùng được gán vào
{{campaign_name_encoded}} Tên chiến dịch Tenjin đã được mã hóa mà người dùng được gán vào
{{click_id}} ID nhấp chuột của kênh nếu người dùng được ghi nhận là đến từ các kênh trả phí
{{creative_name}} Tên sáng tạo
{{deeplink_url}} URL liên kết sâu
{{is_conversion_integer}} 1 cho lần mở ứng dụng đầu tiên, 0 cho các sự kiện khác
{{is_impression}} 1 => Ghi nhận theo lượt xem, 0 => Ghi nhận theo lượt nhấp
{{is_install_or_landing}} Lần mở đầu tiên là “Cài đặt”, các lần mở ứng dụng tiếp theo là “trang đích”
{{ip_address}} Địa chỉ IP của người dùng
{{ip_address_click}} Địa chỉ IP cho sự kiện nhấp chuột hoặc hiển thị
{{remote_campaign_id}} ID chiến dịch của kênh mà người dùng được ghi nhận là thuộc về
{{site_id}} ID trang web của kênh mà người dùng được gán vào
{{site_id_encoded}} Mã định danh trang web (Site ID) của kênh đã được mã hóa mà người dùng được gán vào
{{ad_network_short_id_match_type}} Nếu người dùng đến từ thiết bị, mô hình phân bổ xác suất hoặc nguồn giới thiệu. ad_network_short_id phần này sẽ khác nhau tùy theo từng mạng quảng cáo; vui lòng liên hệ với chúng tôi để biết thêm chi tiết.
{{is_organic}} ‘1’ -> người dùng được ghi nhận là đến từ kênh tự nhiên, ‘0’ -> người dùng được ghi nhận là đến từ kênh không tự nhiên
{{tenjin_campaign_id}} ID chiến dịch Tenjin mà người dùng được gán vào
{{tenjin_parameter_0}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
{{tenjin_parameter_1}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
{{tenjin_parameter_2}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
{{tenjin_parameter_3}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
{{tenjin_parameter_4}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
{{tenjin_parameter_5}} Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL



Các macro liên quan đến mã định danh thiết bị #



Macro Giải thích
{{advertising_id}} Mã nhận dạng quảng cáo của thiết bị
{{analytics_installation_id}} Mã định danh riêng cho quá trình cài đặt ứng dụng. Viết bằng chữ thường, không có dấu gạch ngang.
{{developer_device_id}} Mã định danh nhà cung cấp (IDFV) hoặc mã định danh thiết bị của nhà phát triển
{{formatted_advertising_id}} Định dạng mã nhận dạng quảng cáo của thiết bị, 00000000-0000-0000-0000-000000000000 nếu trường này trống
{{imei}} IMEI
{{md5_advertising_id}} Giá trị MD5 của mã định danh quảng cáo
{{lowercase_advertising_id}} Chữ thường của mã nhận dạng quảng cáo của thiết bị
{{md5_imei}} Giá trị MD5 của số IMEI
{{md5_oaid}} Giá trị MD5 của OAID
{{oaid}} OAID
{{customer_user_id}} ID người dùng từ ứng dụng, được thiết lập bằng phương thức setCustomerUserId của SDK



Các macro liên quan đến thuộc tính thiết bị #



Macro Giải thích
{{allow_ad_tracking}} Thiết bị có cho phép theo dõi quảng cáo không? (đúng, sai)
{{allow_ad_tracking_integer}} Thiết bị có cho phép theo dõi quảng cáo không? (1, 0)
{{carrier}} Khung gắn thiết bị
{{connection_type}} Loại kết nối
{{country}} Mã quốc gia của thiết bị người dùng
{{device}} Thiết bị của người dùng
{{device_brand}} Thương hiệu thiết bị
{{device_model}} Mẫu thiết bị
{{language}} Cài đặt ngôn ngữ của người dùng
{{limit_ad_tracking}} Thiết bị có hạn chế việc theo dõi quảng cáo không? (đúng, sai)
{{limit_ad_tracking_integer}} Thiết bị có hạn chế việc theo dõi quảng cáo không? (1, 0)
{{locale}} Cài đặt ngôn ngữ và vùng của thiết bị
{{os_version}} Phiên bản hệ điều hành của người dùng
{{os_version_release}} Phiên bản hệ điều hành của người dùng
{{referrer}} Nguồn giới thiệu Android
{{timezone}} Múi giờ của thiết bị
{{tracking_status}} Giá trị số nguyên biểu thị trạng thái ATT của thiết bị iOS. 0 => chưa xác định, 1 => bị hạn chế, 2 => bị từ chối, 3 => được phép



Các macro liên quan đến sự kiện #



Macro Giải thích
{{currency}} Mã tiền tệ gồm 3 chữ số của giao dịch mua hàng
{{event}} Tên sự kiện
{{time_in_seconds}} Thời gian yêu cầu (tính bằng giây)
{{time_in_ms}} Thời gian yêu cầu tính bằng mili giây
{{time_iso8601}} Thời gian yêu cầu theo định dạng ISO 8601
{{revenue}} Tổng doanh thu thu được từ một giao dịch mua bằng đồng tiền gốc
{{revenue_usd_net}} Doanh thu ròng (tính bằng USD) cho một giao dịch mua hàng
{{revenue_usd_gross}} Doanh thu gộp (tính bằng USD) cho một giao dịch mua hàng
{{value}} Giá trị sự kiện tùy chỉnh
{{value_micro}} Giá trị sự kiện tùy chỉnh chia cho 1.000.000. Macro này được sử dụng để gửi giá trị thập phân qua hàm callback bằng cách gửi giá trị thực * 1.000.000 thông qua sự kiện tùy chỉnh.



Các macro liên quan đến số lần hiển thị quảng cáo #




AppLovin




Macro Giải thích
{{ilrd::ad_unit_id}} ID đơn vị quảng cáo do mạng quảng cáo trúng thầu báo cáo
{{ilrd::currency}} Doanh thu quảng cáo tiền tệ được báo cáo bằng
{{ilrd::ad_format}} Định dạng của đơn vị quảng cáo
{{ilrd::mediation_country}} Quốc gia của nhà cung cấp dịch vụ hòa giải
{{ilrd::network_name}} Mạng lưới đã hiển thị quảng cáo đó
{{ilrd::ad_revenue}} Doanh thu do Mạng quảng cáo báo cáo
{{ilrd::network_placement}} Vị trí được xác định bởi mạng
{{ilrd::placement}} Vị trí đặt khối quảng cáo
{{ilrd::creative_id}} Mã định danh sáng tạo của đơn vị quảng cáo
{{ilrd::precision}} Độ chính xác của doanh thu




Unity LevelPlay




Macro Giải thích
{{ilrd::ab_test}} Giá trị thử nghiệm A/B
{{ilrd::ad_format}} Định dạng của đơn vị quảng cáo
{{ilrd::ad_revenue}} Doanh thu do Mạng quảng cáo báo cáo
{{ilrd::auction_id}} Mã đấu giá từ nền tảng trung gian Ironsource
{{ilrd::ecpm}} eCPM từ nền tảng trung gian Ironsource
{{ilrd::instance_id}} ID phiên bản từ hệ thống trung gian Ironsource
{{ilrd::instance_name}} Tên phiên bản từ hệ thống trung gian Ironsource
{{ilrd::mediation_country}} (chưa sử dụng, sẽ sử dụng macro vùng Tenjin)
{{ilrd::mediation_ltv}} Doanh thu tích lũy từ dịch vụ trung gian của Ironsource
{{ilrd::network_name}} Mạng lưới đã hiển thị quảng cáo đó
{{ilrd::placement}} Vị trí đặt khối quảng cáo
{{ilrd::precision}} Độ chính xác của doanh thu
{{ilrd::segment}} Tên phân khúc từ hệ thống trung gian Ironsource




AdMob




Macro Giải thích
{{ilrd::precision}} Loại độ chính xác do AdMob xác định
{{ilrd::ad_unit_id}} ID đơn vị quảng cáo do AdMob xác định
{{ilrd::currency}} Mã tiền tệ từ AdMob
{{ilrd::adapter_class}} Lớp bộ điều hợp của Mạng quảng cáo
{{ilrd::response_id}} Mã phản hồi do AdMob cung cấp
{{ilrd::ad_revenue_micro}} Doanh thu quảng cáo tính bằng micro cent do AdMob cung cấp




Topon




Macro Giải thích
{{ilrd::mediation_country}} Quốc gia của nhà cung cấp dịch vụ hòa giải
{{ilrd::ad_network_type}} Loại hình mạng lưới, quảng bá chéo hoặc trao đổi
{{ilrd::adsource_index}} Sắp xếp nguồn quảng cáo hiện tại trong mô hình Waterfall



Nguồn gốc SAN #




Meta




Macro Giải thích
{{meta::account_id}} Tài khoản quảng cáo được sử dụng để tạo quảng cáo
{{meta::ad_id}} Mã định danh duy nhất của quảng cáo đã được nhấp vào/xem trước khi chuyển đổi
{{meta::ad_objective_name}} Mục tiêu được chọn khi tạo chiến dịch (ví dụ: MOBILE_APP_INSTALLS, CONVERSIONS)
{{meta::adgroup_id}} ID của quảng cáo Meta
{{meta::adgroup_name}} Tên quảng cáo Meta
{{meta::campaign_group_id}} Mã định danh của Chiến dịch Meta
{{meta::campaign_group_name}} Tên của Chiến dịch Meta
{{meta::campaign_id}} ID của Meta AdSet
{{meta::campaign_name}} Tên của Meta AdSet
{{meta::click_time}} Dấu thời gian của lần nhấp vào quảng cáo cuối cùng trước khi xác định nguồn gốc
{{meta::engagement_type}} Loại tương tác cho việc xác định nguồn gốc (ví dụ: engaged_view)
{{meta::is_fb}} Việc cài đặt có phải từ Meta hay không
{{meta::is_modeled}} Việc xác định nguồn gốc là dựa trên mô hình hay mang tính xác định
{{meta::is_paid}} Việc cài đặt có phải đến từ một kênh trả phí trên Meta hay không
{{meta::is_view_through}} Việc xác định nguồn gốc là dựa trên lượt xem hay dựa trên lượt nhấp
{{meta::platform_position}} Định dạng quảng cáo hiển thị trên nền tảng
{{meta::publisher_platform}} Nền tảng nơi quảng cáo được hiển thị (ví dụ: AUDIENCE_NETWORK, INSTAGRAM, MESSENGER, FACEBOOK)
{{meta::view_time}} Dấu thời gian của lần xem quảng cáo cuối cùng trước khi xác định nguồn gốc



Bạn có thể tìm hiểu thêm về định tuyến và cách sử dụng các macro này trong phần thiết lập callback.

Macro	Giải thích
`{{app_version}}`	Phiên bản ứng dụng. (1.0.3)
`{{bundle_id}}`	ID gói của ứng dụng. (com.tenjin.wordfinder)
`{{lowercase_bundle_id}}`	ID gói của ứng dụng viết thường. (com.tenjin.wordfinder)
`{{platform}}`	Nền tảng của ứng dụng (iOS)
`{{user_agent}}`	Trình duyệt của người dùng
`{{sdk_version}}`	Phiên bản Tenjin SDK của người dùng
`{{store_id}}`	ID ứng dụng trên App Store (887212194)

Macro	Giải thích
`{{acquired_at_s}}`	Dấu thời gian của sự kiện Cài đặt (tính bằng giây)
`{{acquired_at_ms}}`	Dấu thời gian cho sự kiện Cài đặt, tính bằng mili giây
`{{engaged_at_s}}`	Dấu thời gian cho sự kiện nhấp chuột hoặc hiển thị, tính bằng giây
`{{engaged_at_ms}}`	Dấu thời gian cho sự kiện nhấp chuột hoặc hiển thị, tính bằng mili giây
`{{ad_network}}`	Tên kênh mà người dùng được gán vào
`{{campaign_id}}`	Tương tự như `{{remote_campaign_id}}`
`{{campaign_name}}`	Tên chiến dịch Tenjin mà người dùng được gán vào
`{{campaign_name_encoded}}`	Tên chiến dịch Tenjin đã được mã hóa mà người dùng được gán vào
`{{click_id}}`	ID nhấp chuột của kênh nếu người dùng được ghi nhận là đến từ các kênh trả phí
`{{creative_name}}`	Tên sáng tạo
`{{deeplink_url}}`	URL liên kết sâu
`{{is_conversion_integer}}`	1 cho lần mở ứng dụng đầu tiên, 0 cho các sự kiện khác
`{{is_impression}}`	`1` => Ghi nhận theo lượt xem, `0` => Ghi nhận theo lượt nhấp
`{{is_install_or_landing}}`	Lần mở đầu tiên là “Cài đặt”, các lần mở ứng dụng tiếp theo là “trang đích”
`{{ip_address}}`	Địa chỉ IP của người dùng
`{{ip_address_click}}`	Địa chỉ IP cho sự kiện nhấp chuột hoặc hiển thị
`{{remote_campaign_id}}`	ID chiến dịch của kênh mà người dùng được ghi nhận là thuộc về
`{{site_id}}`	ID trang web của kênh mà người dùng được gán vào
`{{site_id_encoded}}`	Mã định danh trang web (Site ID) của kênh đã được mã hóa mà người dùng được gán vào
`{{ad_network_short_id_match_type}}`	Nếu người dùng đến từ thiết bị, mô hình phân bổ xác suất hoặc nguồn giới thiệu. `ad_network_short_id` phần này sẽ khác nhau tùy theo từng mạng quảng cáo; vui lòng liên hệ với chúng tôi để biết thêm chi tiết.
`{{is_organic}}`	‘1’ -> người dùng được ghi nhận là đến từ kênh tự nhiên, ‘0’ -> người dùng được ghi nhận là đến từ kênh không tự nhiên
`{{tenjin_campaign_id}}`	ID chiến dịch Tenjin mà người dùng được gán vào
`{{tenjin_parameter_0}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
`{{tenjin_parameter_1}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
`{{tenjin_parameter_2}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
`{{tenjin_parameter_3}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
`{{tenjin_parameter_4}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL
`{{tenjin_parameter_5}}`	Hàm macro truyền qua cho phép bạn truyền qua từ việc nhấp vào URL

Macro	Giải thích
`{{advertising_id}}`	Mã nhận dạng quảng cáo của thiết bị
`{{analytics_installation_id}}`	Mã định danh riêng cho quá trình cài đặt ứng dụng. Viết bằng chữ thường, không có dấu gạch ngang.
`{{developer_device_id}}`	Mã định danh nhà cung cấp (IDFV) hoặc mã định danh thiết bị của nhà phát triển
`{{formatted_advertising_id}}`	Định dạng mã nhận dạng quảng cáo của thiết bị, `00000000-0000-0000-0000-000000000000` nếu trường này trống
`{{imei}}`	IMEI
`{{md5_advertising_id}}`	Giá trị MD5 của mã định danh quảng cáo
`{{lowercase_advertising_id}}`	Chữ thường của mã nhận dạng quảng cáo của thiết bị
`{{md5_imei}}`	Giá trị MD5 của số IMEI
`{{md5_oaid}}`	Giá trị MD5 của OAID
`{{oaid}}`	OAID
`{{customer_user_id}}`	ID người dùng từ ứng dụng, được thiết lập bằng phương thức setCustomerUserId của SDK

Macro	Giải thích
`{{allow_ad_tracking}}`	Thiết bị có cho phép theo dõi quảng cáo không? (đúng, sai)
`{{allow_ad_tracking_integer}}`	Thiết bị có cho phép theo dõi quảng cáo không? (1, 0)
`{{carrier}}`	Khung gắn thiết bị
`{{connection_type}}`	Loại kết nối
`{{country}}`	Mã quốc gia của thiết bị người dùng
`{{device}}`	Thiết bị của người dùng
`{{device_brand}}`	Thương hiệu thiết bị
`{{device_model}}`	Mẫu thiết bị
`{{language}}`	Cài đặt ngôn ngữ của người dùng
`{{limit_ad_tracking}}`	Thiết bị có hạn chế việc theo dõi quảng cáo không? (đúng, sai)
`{{limit_ad_tracking_integer}}`	Thiết bị có hạn chế việc theo dõi quảng cáo không? (1, 0)
`{{locale}}`	Cài đặt ngôn ngữ và vùng của thiết bị
`{{os_version}}`	Phiên bản hệ điều hành của người dùng
`{{os_version_release}}`	Phiên bản hệ điều hành của người dùng
`{{referrer}}`	Nguồn giới thiệu Android
`{{timezone}}`	Múi giờ của thiết bị
`{{tracking_status}}`	Giá trị số nguyên biểu thị trạng thái ATT của thiết bị iOS. `0` => chưa xác định, `1` => bị hạn chế, `2` => bị từ chối, `3` => được phép

Macro	Giải thích
`{{currency}}`	Mã tiền tệ gồm 3 chữ số của giao dịch mua hàng
`{{event}}`	Tên sự kiện
`{{time_in_seconds}}`	Thời gian yêu cầu (tính bằng giây)
`{{time_in_ms}}`	Thời gian yêu cầu tính bằng mili giây
`{{time_iso8601}}`	Thời gian yêu cầu theo định dạng ISO 8601
`{{revenue}}`	Tổng doanh thu thu được từ một giao dịch mua bằng đồng tiền gốc
`{{revenue_usd_net}}`	Doanh thu ròng (tính bằng USD) cho một giao dịch mua hàng
`{{revenue_usd_gross}}`	Doanh thu gộp (tính bằng USD) cho một giao dịch mua hàng
`{{value}}`	Giá trị sự kiện tùy chỉnh
`{{value_micro}}`	Giá trị sự kiện tùy chỉnh chia cho 1.000.000. Macro này được sử dụng để gửi giá trị thập phân qua hàm callback bằng cách gửi giá trị thực * 1.000.000 thông qua sự kiện tùy chỉnh.

Macro	Giải thích
`{{ilrd::ad_unit_id}}`	ID đơn vị quảng cáo do mạng quảng cáo trúng thầu báo cáo
`{{ilrd::currency}}`	Doanh thu quảng cáo tiền tệ được báo cáo bằng
`{{ilrd::ad_format}}`	Định dạng của đơn vị quảng cáo
`{{ilrd::mediation_country}}`	Quốc gia của nhà cung cấp dịch vụ hòa giải
`{{ilrd::network_name}}`	Mạng lưới đã hiển thị quảng cáo đó
`{{ilrd::ad_revenue}}`	Doanh thu do Mạng quảng cáo báo cáo
`{{ilrd::network_placement}}`	Vị trí được xác định bởi mạng
`{{ilrd::placement}}`	Vị trí đặt khối quảng cáo
`{{ilrd::creative_id}}`	Mã định danh sáng tạo của đơn vị quảng cáo
`{{ilrd::precision}}`	Độ chính xác của doanh thu

Macro	Giải thích
`{{ilrd::ab_test}}`	Giá trị thử nghiệm A/B
`{{ilrd::ad_format}}`	Định dạng của đơn vị quảng cáo
`{{ilrd::ad_revenue}}`	Doanh thu do Mạng quảng cáo báo cáo
`{{ilrd::auction_id}}`	Mã đấu giá từ nền tảng trung gian Ironsource
`{{ilrd::ecpm}}`	eCPM từ nền tảng trung gian Ironsource
`{{ilrd::instance_id}}`	ID phiên bản từ hệ thống trung gian Ironsource
`{{ilrd::instance_name}}`	Tên phiên bản từ hệ thống trung gian Ironsource
`{{ilrd::mediation_country}}`	(chưa sử dụng, sẽ sử dụng macro vùng Tenjin)
`{{ilrd::mediation_ltv}}`	Doanh thu tích lũy từ dịch vụ trung gian của Ironsource
`{{ilrd::network_name}}`	Mạng lưới đã hiển thị quảng cáo đó
`{{ilrd::placement}}`	Vị trí đặt khối quảng cáo
`{{ilrd::precision}}`	Độ chính xác của doanh thu
`{{ilrd::segment}}`	Tên phân khúc từ hệ thống trung gian Ironsource

Macro	Giải thích
`{{ilrd::precision}}`	Loại độ chính xác do AdMob xác định
`{{ilrd::ad_unit_id}}`	ID đơn vị quảng cáo do AdMob xác định
`{{ilrd::currency}}`	Mã tiền tệ từ AdMob
`{{ilrd::adapter_class}}`	Lớp bộ điều hợp của Mạng quảng cáo
`{{ilrd::response_id}}`	Mã phản hồi do AdMob cung cấp
`{{ilrd::ad_revenue_micro}}`	Doanh thu quảng cáo tính bằng micro cent do AdMob cung cấp

Macro	Giải thích
`{{ilrd::mediation_country}}`	Quốc gia của nhà cung cấp dịch vụ hòa giải
`{{ilrd::ad_network_type}}`	Loại hình mạng lưới, quảng bá chéo hoặc trao đổi
`{{ilrd::adsource_index}}`	Sắp xếp nguồn quảng cáo hiện tại trong mô hình Waterfall

Macro	Giải thích
`{{meta::account_id}}`	Tài khoản quảng cáo được sử dụng để tạo quảng cáo
`{{meta::ad_id}}`	Mã định danh duy nhất của quảng cáo đã được nhấp vào/xem trước khi chuyển đổi
`{{meta::ad_objective_name}}`	Mục tiêu được chọn khi tạo chiến dịch (ví dụ: MOBILE_APP_INSTALLS, CONVERSIONS)
`{{meta::adgroup_id}}`	ID của quảng cáo Meta
`{{meta::adgroup_name}}`	Tên quảng cáo Meta
`{{meta::campaign_group_id}}`	Mã định danh của Chiến dịch Meta
`{{meta::campaign_group_name}}`	Tên của Chiến dịch Meta
`{{meta::campaign_id}}`	ID của Meta AdSet
`{{meta::campaign_name}}`	Tên của Meta AdSet
`{{meta::click_time}}`	Dấu thời gian của lần nhấp vào quảng cáo cuối cùng trước khi xác định nguồn gốc
`{{meta::engagement_type}}`	Loại tương tác cho việc xác định nguồn gốc (ví dụ: engaged_view)
`{{meta::is_fb}}`	Việc cài đặt có phải từ Meta hay không
`{{meta::is_modeled}}`	Việc xác định nguồn gốc là dựa trên mô hình hay mang tính xác định
`{{meta::is_paid}}`	Việc cài đặt có phải đến từ một kênh trả phí trên Meta hay không
`{{meta::is_view_through}}`	Việc xác định nguồn gốc là dựa trên lượt xem hay dựa trên lượt nhấp
`{{meta::platform_position}}`	Định dạng quảng cáo hiển thị trên nền tảng
`{{meta::publisher_platform}}`	Nền tảng nơi quảng cáo được hiển thị (ví dụ: AUDIENCE_NETWORK, INSTAGRAM, MESSENGER, FACEBOOK)
`{{meta::view_time}}`	Dấu thời gian của lần xem quảng cáo cuối cùng trước khi xác định nguồn gốc



	
	Cảm xúc của bạn là gì
	
					
				
											
									
			
							
				
											
									
			
							
				
											
									
			
			


	
 


	 Liên kết sâu trì hoãnCửa hàng bên thứ ba Android

 
		
	
		

	
		Mục lục	

	Các hàm macro gọi lạiTại sao chúng ta cần các macro?
URL và tham số
Giá trị tham số động
Các macro dành cho các hàm gọi lại của mạng quảng cáo
Các macro được hỗ trợCác macro liên quan đến ứng dụng
Các macro liên quan đến ghi nguồn
Các macro liên quan đến mã định danh thiết bị
Các macro liên quan đến thuộc tính thiết bị
Các macro liên quan đến sự kiện
Các macro liên quan đến số lần hiển thị quảng cáo
Nguồn gốc SAN

Máy chủ MCP của Tenjin: Tra cứu...

Báo cáo so sánh về khai thác doanh thu từ quảng cáo năm 2025...

Bắt đầu

Cài đặt kênh

Phương pháp xác định doanh thu

Công cụ ghi nguồn

Công cụ báo cáo

Hướng dẫn tích hợp Tenjin SDK

Các công cụ SKAdNetwork

Tổng quát

Trung tâm Câu hỏi thường gặp

Hàm gọi lại

#

Các hàm macro gọi lại #

Tại sao chúng ta cần các macro? #

URL và tham số #

Giá trị tham số động #

#

Các macro dành cho các hàm gọi lại của mạng quảng cáo #

#

Các macro được hỗ trợ #

Nguồn gốc SAN #

Cảm xúc của bạn là gì

Chương trình khuyến khích ứng dụng di động của Thổ Nhĩ Kỳ: Danh sách kiểm tra hồ sơ đăng ký của bạn

Hướng dẫn về Chương trình khuyến khích phát triển ứng dụng di động của Thổ Nhĩ Kỳ (2026)

Cách sử dụng trợ lý AI để tích hợp Tenjin SDK: Hướng dẫn dành cho nhà phát triển

Chặn lưu lượng truy cập độc hại: Cách Snake.io giảm 33% yêu cầu gian lận

Sản phẩm

Tài nguyên

Công ty