Macro là các chuỗi đặc biệt trong mã mẫu quảng cáo. Sau đó, Ad Manager thay thế chuỗi này bằng một giá trị hoặc mã khác dựa trên chế độ cài đặt của mẫu quảng cáo. Macro hữu ích vì bạn không phải cập nhật trực tiếp mã tệp sáng tạo nếu cần thay đổi, mà chỉ cần cập nhật nội dung tham chiếu macro.
Đối với mỗi macro, chúng tôi đã cung cấp ý kiến đề xuất về cách bạn có thể sử dụng, nhưng bạn có thể sử dụng theo bất kỳ cách nào có giá trị nhất cho mình. Macro có thể nằm trong bất kỳ mã nào được máy chủ quảng cáo xử lý trong quá trình phân phối: mã tệp sáng tạo tùy chỉnh hoặc bên thứ ba, mã Studio, URL của trang đích khi nhấp hoặc thẻ quảng cáo.
Ghi chú quan trọng về macro
- Phân biệt chữ hoa chữ thường
Macro phân biệt chữ hoa chữ thường. Sử dụng%%CACHEBUSTER%%chứ không phải%%Cachebuster%%. - Phương thức mở rộng của phiên bản không thoát và thoát
Các phiên bản macro không thoát và thoát mở rộng theo cách riêng. Tìm hiểu cách sử dụng macro thoát và không thoát. - Chèn macro
Ad Manager sẽ tự động chèn các macro cho tệp sáng tạo của bên thứ ba hoặc URL thẻ VAST nếu Ad Manager nhận ra bên thứ ba. Đối với quảng cáo tuỳ chỉnh và mẫu quảng cáo, bạn cần thêm macro theo cách thủ công. Nếu bạn không chắc chắn về vị trí đặt macro, hãy liên hệ với nhà cung cấp mẫu quảng cáo.
Khi quản lý quảng cáo bằng mẫu quảng cáo, thông tin đầu vào là URL của trang đích khi nhấp sẽ chỉ xuất hiện khi bạn sử dụng macro nhấp chuột trong mẫu. - Ký tự đặt trước và mã hoá URL (mã hóa phần trăm)
Ad Manager đặt trước một số chữ cái viết thường sau dấu phần trăm:%a
%c
%h
%i
%n
%p
%kKhông được sử dụng các chuỗi này khi mã hoá URL vì có thể ảnh hưởng đến việc mở rộng macro.
- Macro không được hỗ trợ cho tính năng Trực tiếp theo chương trình
Hãy xem các chức năng có sẵn cho tính năng Trực tiếp theo chương trình.
Chuyển đến một macro cụ thể trong danh sách
Mở rộng tất cả Thu gọn tất cả
Macro hiển thị
Các macro này thường dùng để hiển thị tệp sáng tạo, đảm bảo tệp sáng tạo hiển thị đúng và hoạt động chính xác.
Đơn vị quảng cáo| Macro |
|---|
%%ADUNIT%% |
Macro đơn vị quảng cáo chèn đường dẫn đơn vị quảng cáo từ Thẻ nhà xuất bản của Google vào mã tệp quảng cáo khi đơn vị đó được phân phối.
Sau đây là cách bạn sẽ thêm macro ADUNIT vào đoạn mã tệp quảng cáo của bên thứ ba:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
Macro đơn vị quảng cáo mở rộng thành đường dẫn đơn vị quảng cáo đầy đủ có trong yêu cầu quảng cáo ban đầu, bao gồm cả mã mạng. Sau đây là một ví dụ về cách đường dẫn đơn vị quảng cáo sẽ mở rộng khi quảng cáo phân phát:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Macro này chỉ hoạt động cho đơn vị quảng cáo đề xuất được chấp thuận. Nếu đơn vị quảng cáo đề xuất ở cấp độ thứ ba, thì macro chỉ mở rộng đến đơn vị quảng cáo cấp độ thứ hai khi được sử dụng trong đoạn mã mẫu quảng cáo. Sau khi các đơn vị quảng cáo đề xuất được chấp thuận, macro sẽ mở rộng đến đơn vị quảng cáo cấp độ thứ ba trong đoạn mã mẫu quảng cáo
| Macro | Đang thoát |
|---|---|
%%DEST_URL_ESC%% |
Đã thoát |
%%DEST_URL_ESC_ESC%% |
Thoát kép |
%%DEST_URL_UNESC%% |
Không thoát |
Macro URL đích mở rộng tới URL nhấp qua của tệp quảng cáo, đây là URL nhấp qua của mục hàng hoặc tập hợp ghi đè cho tệp quảng cáo trong mục hàng.
Macro URL đích hữu ích trong các tệp quảng cáo tùy chỉnh và các mẫu quảng cáo. Macro này có thể đáp ứng nếu mã tệp quảng cáo cần chứa URL nhấp qua của tệp quảng cáo và URL nhấp qua thay đổi khi tệp quảng cáo hoặc mẫu được sử dụng trên các mục hàng khác nhau.
Có ba macro URL nhấp qua: đã thoát, thoát kép và không thoát. Thông thường, số lần thoát (cho dù bạn bao gồm ESC một lần, hai lần hoặc không lần nào) tùy thuộc vào công ty theo dõi nhấp chuột bên thứ ba. Một số công ty theo dõi nhấp chuột bên thứ ba yêu cầu phải thoát URL trong khi các công ty khác thì không yêu cầu. Mức độ thoát mà công ty theo dõi nhấp chuột bên thứ ba yêu cầu thường được chỉ định trong thẻ bao gồm chuỗi click= trong thẻ quảng cáo của bên thứ ba hoặc mã tệp quảng cáo tùy chỉnh trong Ad Manager:
-
click=: Thoát URL một lần (%%DEST_URL_ESC%%). -
click0=: Không thoát URL (%%DEST_URL_UNESC%%). -
click1=: Thoát URL một lần (%%DEST_URL_ESC%%). -
click2=: Thoát URL hai lần (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, hoạt động giống hệt như %%DEST_URL_ESC%%. Bạn nên sử dụng %%DEST_URL_ESC%% để có sự rõ ràng, nhưng không cần phải mã hoá lại các mẫu quảng cáo và mẫu cũ.%u hoặc %%DEST_URL%%, thì bạn sẽ được chuyển hướng đến URL xsd:string khi nhấp vào mẫu quảng cáo. Thuộc tính này có độ dài tối đa là 1024 ký tự.| Macro |
|---|
%%FILE:file_display_name%% |
Macro máy chủ tệp %%FILE:file_display_name%% mở rộng đến URL đầy đủ của tài sản sáng tạo đã được tải lên cho một tệp quảng cáo. Bạn có thể sử dụng macro này để gọi tài sản (như hình ảnh) đã tải lên, với mã tệp quảng cáo tùy chỉnh.
Để sử dụng macro này, hãy thay thế file_display_name bằng tên hiển thị của thành phần mẫu quảng cáo, như thể hiện trong Ad Manager khi bạn xem thông tin chi tiết về mẫu quảng cáo.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Các macro này chèn chiều cao và chiều rộng quảng cáo vào mã tùy chỉnh của quảng cáo trong quá trình phân phối quảng cáo. Chiều cao và rộng đã được xác định trong Ad Manager theo giá trị trường "Nhắm mục tiêu kích thước đơn vị quảng cáo" của quảng cáo.
Macro chiều cao và chiều rộng có thể đặc biệt hữu ích nếu bạn tạo một mẫu quảng cáo mà bạn muốn sử dụng lại với các quảng cáo có kích thước khác nhau. Thay vì mã hóa cứng kích thước cho mỗi quảng cáo, bạn có thể để macro chiều cao và chiều rộng tự động chèn các giá trị vào từng quảng cáo.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Sử dụng macro đối sánh mẫu để chuyển một hoặc nhiều biến tùy chỉnh chẳng hạn như giá trị nhắm mục tiêu vào quảng cáo. Bạn có thể sử dụng macro này để chuyển khóa-giá trị, thay thế toàn bộ chuỗi nhắm mục tiêu hoặc mở rộng URL liên kết giới thiệu. Phương pháp này có thể hữu ích nếu bạn muốn phân phát nhiều mẫu quảng cáo dựa trên thông tin bạn biết về người dùng, chẳng hạn như các chế độ ưu tiên của người dùng về nội dung.
Macro so khớp mẫu được giới hạn ở 100 lượt thay thế cho mỗi tệp sáng tạo.
Thoát macro so khớp mẫu
Macro đối sánh mẫu trả về giá trị như đã nhận được. Nếu bạn đang sử dụng macro tại một trong các trường URL, chẳng hạn như trường "URL thẻ VAST" hoặc "URL theo dõi của bên thứ ba" trong quảng cáo video, bạn có thể muốn giá trị mở rộng trở về trạng thái thoát. Để làm điều này, bạn cần phải thoát 3 lần giá trị trong yêu cầu.
%%PATTERN:key%%
Ví dụ: bạn có hai quảng cáo cho một mục hàng cụ thể: một được thiết kế để hấp dẫn những người dùng là nữ và một được thiết kế để hấp dẫn những người dùng là nam. "Từ khoá" được dùng macro phải là ký tự chữ số hoặc gạch dưới (_).
Dưới đây là cách quy trình hoạt động:
- Bạn đang truyền giá trị tuỳ chỉnh (trong trường hợp này là giới tính của người dùng) vào một thẻ quảng cáo trên trang của bạn, bằng cách dùng khoá-giá trị:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Trong mẫu quảng cáo tuỳ chỉnh hoặc mẫu quảng cáo của bên thứ ba, hãy truyền giá trị tuỳ chỉnh (giới tính của người dùng) theo phương thức động bằng cách sử dụng macro sau:
<tập lệnh mẫu quảng cáo nào đó ở đây>...&gender=%%PATTERN:gender%% - Toàn bộ macro của
%%PATTERN:gender%%sẽ được thay thế bằng "male". - Ad Manager sẽ gọi và phân phát tệp quảng cáo "male" cho người dùng này.
%%PATTERN:TARGETINGMAP%%
Bạn có thể sử dụng %%PATTERN:TARGETINGMAP%% để thay thế bản đồ nhắm mục tiêu toàn bộ và tự động tạo thẻ trả về.
Dưới đây là cách bạn sẽ thêm macro TARGETINGMAP vào một thẻ quảng cáo:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display():
Dưới đây là một ví dụ về chuỗi khóa-giá trị hoàn thành khi quảng cáo được phân phối:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Bạn có thể sử dụng macro này để thiết lập một thẻ trả về giữa hai mạng Ad Manager ("Mạng A" và "Mạng B").
Dưới đây là một quảng cáo mẫu được đặt trong Mạng A của Ad Manager:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Trong trường hợp Mạng B của Ad Manager không có bất kỳ chiến dịch đã bán nào để phân phát, thì mạng này có thể đưa lượt hiển thị trở lại Mạng A bằng cách sử dụng một mẫu quảng cáo trả về như sau:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // to avoid infinite loops
.display();
</script>Bạn cũng có thể sử dụng TARGETINGMAP trong thẻ trả về được gửi trong một yêu cầu đến máy chủ quảng cáo của bên thứ ba, cho phép bạn có nhiều giá trị trong một quảng cáo động.
Đây là một quảng cáo mẫu được đặt trong Ad Manager:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Khi được Ad Manager phân phát, quảng cáo này mở rộng thành:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Bên thứ ba bây giờ có quyền truy cập vào thông số dfpAdUnit và targeting được tạo động và có thể xây dựng thẻ trả về sau:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // to avoid infinite loop (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Để làm được điều đó, bên thứ ba có thể được cấp một mã mẫu giống như thế này:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Bạn cũng có thể sử dụng url khóa dành riêng để mở rộng ra URL của trang giới thiệu.
Hãy lưu ý rằng url là một khóa đặt trước; bất kỳ khóa-giá trị nào trong thẻ Campaign Manager 360 của bạn mà có url là tên khóa sẽ đều bị ghi đè bằng URL liên kết giới thiệu.
| Macro |
|---|
%%TAG_PARAM%% |
Macro thông số thẻ được sử dụng cùng với các thông số thẻ quảng cáo khác và chỉ có thể sử dụng với các thông số sau:
Khi được hỗ trợ, đối tượng này sẽ mở rộng đến giá trị của thông số.
Ví dụ: %%TAG_PARAM:identifier%% (được hỗ trợ) mở rộng đến giá trị bộ tương quan từ thẻ quảng cáo, nhưng %%TAG_PARAM:ppid%% (không được hỗ trợ) không mở rộng đến bất kỳ giá trị nào.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Nhắm mục tiêu trong macro cửa sổ mới cho biết liệu cài đặt cửa sổ nhắm mục tiêu được chỉ định cho đơn vị quảng cáo mà tại đó quảng cáo được phân phối là "_blank" (cửa sổ mới) hay giá trị khác.
-
Nếu cửa sổ mục tiêu là
_blank, thì macro sẽ mở rộng thành1. -
Nếu cửa sổ mục tiêu là bất kỳ giá trị nào khác hoặc không có cửa sổ mục tiêu nào được chỉ định, thì macro sẽ mở rộng thành
0.
Sử dụng macro %%TARGET_WINDOW%% nếu bạn muốn chèn giá trị cài đặt thời lượng nhắm mục tiêu thực tế.
| Macro |
|---|
%%TARGET_WINDOW%% |
Macro cửa sổ mục tiêu mở rộng thành cửa sổ mục tiêu được chỉ định cho đơn vị quảng cáo tại đó quảng cáo được phân phối. Bạn có thể sử dụng macro trong mã của quảng cáo để chỉ định liệu việc nhấp chuột vào quảng cáo sẽ đưa người dùng đến một cửa sổ mới hay tải trang đích trong cùng một cửa sổ, tùy theo cài đặt của từng trang web tại đó người dùng sẽ thấy quảng cáo.
Ví dụ: đơn vị quảng cáo AdManager_News.com có cửa sổ mục tiêu được đặt là _top và đơn vị quảng cáo AdManager_Fashion.com có cửa sổ mục tiêu được đặt là _new. Nếu macro %%TARGET_WINDOW%% được bao gồm trong mã của quảng cáo, thì macro này sẽ mở rộng thành _top cho người dùng tại AdManager_News.com và _new cho người dùng của AdManager_Fashion.com.
Dưới đây là ví dụ triển khai:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Sử dụng macro %%TARGET_IN_NEW_WINDOW%% nếu bạn muốn xác định liệu giá trị cài đặt cửa sổ nhắm mục tiêu là "_blank" hay giá trị khác.
| Macro |
|---|
%%TFCD%% |
Thẻ dành cho nội dung hướng tới trẻ em (TFCD) giúp bạn cho phép bên thứ ba biết yêu cầu quảng cáo đã cho đến từ một trang có nội dung hướng tới trẻ em. Mục đích của macro này là hỗ trợ việc tuân thủ Đạo luật bảo vệ quyền riêng tư của trẻ em trên mạng (COPPA).
Bạn có thể bao gồm macro trong mọi dữ liệu chuyển hướng hoặc yêu cầu đối với quảng cáo của bên thứ ba, theo định dạng coppa=%%TFCD%% hoặc định dạng tương tự. Bạn cũng có thể sử dụng macro trong JavaScript để đặt yêu cầu thẻ trả về GPT cho nội dung được dành cho trẻ em. Macro mở rộng thành 1 đối với nội dung được dành cho trẻ em hoặc thành 0 đối với nội dung khác, dựa trên thông tin về tính chất của trang, trang web hoặc ứng dụng dành cho thiết bị di động đã gửi yêu cầu đến Ad Manager.
Nếu bạn đang sử dụng các dịch vụ quảng cáo của Google và muốn triển khai nội dung hướng đến trẻ em ở cấp độ trang web hoặc ứng dụng, vui lòng xem phần Gắn thẻ trang web hoặc ứng dụng là được dành cho trẻ em.
| Macro |
|---|
[%URI_ENCODE:variable%] |
Macro mã hoá URI chuyển đổi một cách chính xác dấu cách và các ký tự đặc biệt khác trong giá trị biến trong mẫu quảng cáo để sử dụng trong các URI, còn được gọi là URL.
Ví dụ:
Giả sử mẫu quảng cáo của bạn có "danh sách" biến gọi là "Color" ("Màu sắc") với hai giá trị: "dark blue" ("xanh dương đậm") và "light green" ("xanh lục nhạt"). Theo mặc định, Ad Manager thêm [%Color%] vào đoạn mã mẫu quảng cáo của bạn:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
Khi quảng cáo được tạo, Ad Manager thay thế [%Color%] bằng chuỗi văn bản bằng chữ của mục danh sách được chọn. Trong ví dụ này, các chuỗi văn bản bằng chữ chứa các ký tự khoảng trắng và sẽ phá vỡ các URL vì các ký tự khoảng trắng cần phải được mã hóa. Bạn có thể sử dụng [%URI_ENCODE:Color%] để tránh vấn đề này.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Macro này đặc biệt hữu ích khi sử dụng biến trong mẫu tệp sáng tạo để xác định một URL của trang đích khi nhấp hoặc URL chuyển hướng. Nếu không có mã hóa chính xác, thì URL đầy đủ trong tệp sáng tạo của bạn có thể không hoạt động.
Ví dụ:
Giả sử mẫu quảng cáo của bạn có biến "URL" có tên "LandingPage". Theo mặc định, Ad Manager thêm [%LandingPage%] vào đoạn mã mẫu quảng cáo:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Nhấp vào đây!</a>
Nếu URL [%LandingPage%] chứa các thông số truy vấn , chẳng hạn ?page=home&sport=baseball, thì URL sẽ bị định dạng sai và dữ liệu chuyển hướng sẽ không hoạt động như mong muốn. Trong ví dụ này, nội dung sau dấu và (&) sẽ được gán cho URL đầy đủ chứ không phải là URL chuyển hướng. Bạn có thể sử dụng [%URI_ENCODE:LandingPage%] để tránh vấn đề này.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Nhấp vào đây!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macro theo dõi
Các macro này hầu như được sử dụng cho mục đích theo dõi và báo cáo.
Mã chặn dùng lại nội dung trong bộ nhớ đệm (số ngẫu nhiên)| Macro |
|---|
%%CACHEBUSTER%% |
Macro chặn truy xuất bộ nhớ đệm giúp đảm bảo rằng một lệnh gọi mới được thực hiện tới máy chủ quảng cáo mỗi lần mã được thực thi, do đó bạn có thể tính chính xác số lượt hiển thị. Nếu không thêm macro chặn truy xuất bộ nhớ đệm vào mã quảng cáo, thì bạn có thể thấy chênh lệch số lượt hiển thị giữa Google Ad Manager và máy chủ quảng cáo bên thứ ba. Xin lưu ý rằng không phải tất cả bên thứ ba đều đòi hỏi macro chặn truy xuất bộ nhớ đệm.
Hầu hết các nhà cung cấp dịch vụ quảng cáo sẽ cung cấp một trình giữ chỗ trong thẻ của họ để chèn macro chặn truy xuất bộ nhớ cache. Ví dụ: nếu mã tệp quảng cáo của bên thứ ba có chứa nội dung như sau:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Bạn sẽ muốn chọn [RANDOM_NUMBER] và nhấp vào nút Chèn macro chặn dùng lại nội dung trong bộ nhớ đệm để thay thế trình giữ chỗ:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER để giảm chênh lệch khi bạn sử dụng trình theo dõi lượt hiển thị của Campaign Manager 360 cho Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Macro chặn dùng lại nội dung trong bộ nhớ đệm trong phản hồi VAST
Macro %%CACHEBUSTER%% mở rộng tới cùng một số ngẫu nhiên cho tất cả các sự kiện trong một quảng cáo nhất định. Điều này đặc biệt hữu ích cho quảng cáo video vì macro mở rộng tới cùng số ngẫu nhiên cho mỗi sự kiện theo dõi video trong một phản hồi VAST.
| Macro | Thoát |
|---|---|
%%CLICK_URL_UNESC%% |
Không thoát |
%%CLICK_URL_ESC%% |
Đã thoát |
%%CLICK_URL_ESC_ESC%% |
Thoát kép |
Macro nhấp chuột mở rộng đến một URL đặc biệt để bạn có thể theo dõi các lượt nhấp trong Ad Manager dành cho quảng cáo của bên thứ ba. Macro này thường được ghép nối với URL nhấp qua của một quảng cáo trong thẻ ký tự liên kết (<a>). Không nhập macro nhấp chuột làm nguồn của hình ảnh hoặc iframe. Làm như vậy dẫn đến việc lượt nhấp sẽ được ghi lại mỗi khi hình ảnh hoặc iframe hiển thị, lượt nhấp đó là không hợp lệ và sẽ bị lọc ra là lượt nhấp không hợp lệ.
Sử dụng %%CLICK_URL_UNESC%% ở đầu đường liên kết. Sử dụng %%CLICK_URL_ESC%% khi trình theo dõi lượt nhấp là thông số của một URL khác.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
Tìm hiểu thêm về macro thoát và không thoát.
Xác thực nội dung triển khai macro nhấp chuột
Macro nhấp chuột không được đặt chính xác sẽ không theo dõi lần nhấp. Hãy thực hiện theo các bước sau để xác nhận rằng Ad Manager sẽ ghi lại các lần nhấp theo ý bạn.
- Xem trước quảng cáo.
- Nhấp vào xem trước.
Ad Manager hiển thị xác nhận rằng các nhấp chuột sẽ được ghi lại. Nếu bạn không thấy thông báo xác nhận này, nghĩa là macro nhấp chuột của bạn không được triển khai một cách chính xác.
| Macro | Macro mở rộng thành gì |
|---|---|
%eaid! |
Mã mục hàng |
%eadv! |
Mã nhà quảng cáo của mục hàng đang được phân phát |
%ebuy! |
Mã đơn hàng của mục hàng đang được phân phát |
%ecid! |
Mã tệp quảng cáo |
%eenv! |
Chỉ báo môi trường (loại thẻ): i cho iframe, j cho JavaScript |
%epid! |
Mã của đơn vị quảng cáo tại đó mục hàng đang được phân phát |
%esid! |
Mã của đơn vị quảng cáo cấp cao nhất trên đơn vị quảng cáo, tại đó mục hàng đang được phân phát
Đây là một macro cũ và có thể không hoạt động như dự tính với mạng của bạn.
|
Hãy dùng macro mở rộng trong mã mẫu quảng cáo tuỳ chỉnh hoặc trong URL nhấp qua để cho thấy các giá trị mã từ Ad Manager khi phân phát quảng cáo tới một trang. Macro này thường dùng để đối sánh mã từ Ad Manager với mã trong cơ sở dữ liệu riêng của nhà xuất bản để khắc phục sự cố hoặc cho các mục đích báo cáo khác.
Bạn có thể phân tách các macro mở rộng với nhau trong URL của trang đích khi nhấp với bất kỳ ký tự nào an toàn để dùng trong URL của trang đích khi nhấp của Ad Manager. Ví dụ: http://www.site.com/?%eaid!;%ecid! mở rộng thành http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (mã nhận dạng thiết bị) |
%%ADVERTISING_IDENTIFIER_TYPE%% (loại thiết bị) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (chế độ cài đặt Giới hạn theo dõi quảng cáo) |
Macro %%ADVERTISING_IDENTIFIER_PLAIN%% cho phép nhà xuất bản trong ứng dụng gửi một mã thiết bị đặt lại được đến đối tác quảng cáo để phân phát quảng cáo dựa trên mối quan tâm. Điều này giúp bạn dễ dàng hơn trong việc cung cấp quyền truy cập vào mã thiết bị đặt lại được cho nhà quảng cáo và đại lý.
Nhà xuất bản trong ứng dụng cũng có thể sử dụng macro %%ADVERTISING_IDENTIFIER_TYPE%% để gửi loại thiết bị và macro %%ADVERTISING_IDENTIFIER_IS_LAT%% để gửi chế độ cài đặt Giới hạn theo dõi quảng cáo (LAT) cho biết tín hiệu Giới hạn theo dõi quảng cáo trên một thiết bị.
Tìm hiểu thêm về mã thiết bị đặt lại được để nhắm đến người dùng cụ thể, bao gồm cả các loại thiết bị được hỗ trợ.
Điều kiện tiên quyết
Đặt mã hóa HTTPS cho quảng cáo. Đây là yêu cầu cho cả mẫu quảng cáo cũng như mọi pixel của bên thứ ba mà bạn dùng để theo dõi lượt chuyển đổi. Nếu mẫu quảng cáo không được mã hoá cho HTTPS hoặc nếu bạn ghi đè khả năng tương thích SSL tự động, macro sẽ không mở rộng giá trị nhưng mẫu quảng cáo vẫn sẽ được phân phối.
Cách thức hoạt động
- Trong Ad Manager, nhà xuất bản đưa macro vào mẫu quảng cáo và/hoặc URL theo dõi.
-
Macro mở rộng để có mã thiết bị của người dùng, loại thiết bị và/hoặc chế độ cài đặt LAT, mà sau đó được đưa vào mẫu quảng cáo khi thực hiện lệnh gọi đến bên thứ ba.
Macro nhận dạng sẽ không mở rộng nếu yêu cầu quảng cáo là từ ứng dụng hướng tới trẻ em (TFCD) hoặc nếu Giới hạn theo dõi quảng cáo (LAT) được kích hoạt. Trong những trường hợp này, macro này trả về một chuỗi rỗng ("").
Định dạng
Macro này gửi 32 chữ số thập lục phân viết hoa, hiển thị trong 5 nhóm và phân tách nhau bằng dấu gạch nối, ở dạng 8-4-4-4-12 cho tổng số 36 ký tự (32 ký tự chữ-số và 4 dấu gạch nối).
Ví dụ: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Xem các giá trị có thể cho loại thiết bị được hỗ trợ và Giới hạn theo dõi quảng cáo (LAT).
| Macro |
|---|
%%PREVIEW_MODE%% |
Sử dụng macro chế độ xem trước trong mã tệp quảng cáo tùy chỉnh để ngăn các hệ thống phụ trợ của bạn hoặc các hệ thống của bên thứ ba tính các lượt hiển thị xem trước. Macro mở rộng thành true nếu tệp quảng cáo hiện được xem dưới dạng quảng cáo xem trước của Ad Manager, false nếu đó là lượt hiển thị thông thường.
| Macro |
|---|
%%SCHEME%% |
Macro giao thức truy cập mở rộng thành http: hoặc https: bất cứ khi nào phù hợp với giao thức truy cập bảo mật của trang web tại đó quảng cáo đang được phân phối. Bạn có thể đặt macro này ở đầu URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Macro |
|---|
%%SITE%% |
Mở rộng thành miền của tham số URL trong thẻ quảng cáo (ví dụ: google.com). Macro có thể được sử dụng để sửa đổi tệp quảng cáo của bạn dựa trên vị trí xuất phát yêu cầu đó. Macro đó không hoạt động trên quảng cáo Ad Exchange được đánh dấu là ẩn danh.
| Macro | Đang thoát |
|---|---|
%%VIEW_URL_ESC%% |
Đã thoát |
%%VIEW_URL_UNESC%% |
Không thoát |
Macro lượt hiển thị đã xem cho phép Ad Manager tính lượt hiển thị mỗi khi tệp sáng tạo được tải xuống trên thiết bị của người dùng và đã bắt đầu quá trình tải. Chỉ sử dụng macro này trong tệp sáng tạo ngoài trang.
Có nhiều cách để gửi ping chế độ xem. Chúng tôi khuyên bạn nên sử dụng thẻ <img>:
<! - Thẻ img này là ẩn. Thẻ này làm cho trình duyệt gửi yêu cầu tới VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Thẻ img này hiển thị quảng cáo thực.-->
<img src="[%Imagefile%]" border="0">
Thẻ <img> đầu tiên truy xuất hình ảnh 1x1 từ VIEW_URL. Định kiểu thành “display:none” để thẻ này ẩn và không ảnh hưởng đến bố cục của trang.
Macro yêu cầu quảng cáo cho GDPR
Các macro này hầu như được sử dụng với yêu cầu quảng cáo tuân theo GDPR (Quy định chung về bảo vệ dữ liệu).
GDPR| Macro |
|---|
${GDPR} |
Mở rộng đến giá trị gdpr= liên kết với yêu cầu
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
Mở rộng tới Chuỗi sự minh bạch và sự đồng ý (TC) liên kết với yêu cầu. Nếu Chuỗi sự minh bạch và đồng ý (TC) trống hoặc không hợp lệ, thì macro này sẽ không mở rộng. Sử dụng macro này để chuyển chuỗi TC tới nhà cung cấp tệp sáng tạo bên thứ ba trong URL trong tệp sáng tạo không có lập trình.
Thay thế "XXXX" bằng mã IAB GVL của nhà cung cấp bên thứ ba. Nếu chuỗi TC trống hoặc không hợp lệ, thì macro này sẽ không mở rộng.
Hệ thống có thể chặn tệp sáng tạo có macro ${GDPR_CONSENT_XXXX} nếu nhà cung cấp bên thứ ba liên kết với mã IAB GVL bạn đã chèn vào không có sự đồng ý của người dùng.
Khi được sử dụng trong thẻ VAST và nhà cung cấp bên thứ ba chưa có sự đồng ý của người dùng, macro này sẽ không mở rộng.
Macro ${GDPR_CONSENT_XXXX} chỉ nên xuất hiện một lần bên trong URL. Liên hệ với nhà cung cấp tệp sáng tạo bên thứ ba của bạn để hiểu các yêu cầu của họ về việc chuyển chuỗi TC và các giới hạn về độ dài URL. Hệ thống sẽ thay thế macro trên các yêu cầu IAB TCF v2.0 liên quan bằng chuỗi đầy đủ và không sửa đổi về sự minh bạch và sự đồng ý.
Macro Khuôn khổ về tính minh bạch và sự đồng ý (TCF) không mở rộng khi được triển khai trong HTML của một mẫu quảng cáo HTML5. Chỉ các mẫu quảng cáo Chuyển hướng hiển thị và Hiển thị tuỳ chỉnh mới hỗ trợ mở rộng macro TCF qua các trường "URL của bên thứ ba" và "mã HTML" tương ứng.
| Macro |
|---|
${ADDTL_CONSENT} |
Mở rộng tới Chuỗi sự đồng ý bổ sung (AC) liên kết với yêu cầu.
| Macro |
|---|
%%TFUA%% |
Mở rộng tới giá trị 1 để gắn thẻ yêu cầu cho người dùng ở Khu vực kinh tế Châu Âu (EEA) và Vương quốc Anh chưa tới độ tuổi đồng thuận.
Macro video
Các macro này thường được sử dụng trong mẫu quảng cáo dạng video để bao gồm chi tiết về bối cảnh hoặc nội dung.
Thời lượng quảng cáo dạng video, tính bằng mili giây| Macro |
|---|
%%VIDEO_AD_DURATION%% |
Mở rộng thời lượng của quảng cáo dạng video tính bằng mili giây. Đối với trình bao bọc/chuyển hướng VAST, macro sẽ mở rộng tới thời lượng được khai báo của quảng cáo trong Ad Manager.
| Macro | Thoát |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Không thoát |
%%DESCRIPTION_URL_ESC%% |
Đã thoát |
%%DESCRIPTION_URL_ESC_ESC%% |
Thoát kép |
Sử dụng %%DESCRIPTION_URL_ESC%% (thoát đơn) khi macro nằm trong URL và sử dụng %%DESCRIPTION_URL_UNESC%% (không thoát) trong các ngữ cảnh khác. Tìm hiểu thêm về macro thoát so với macro không thoát
Trong thẻ quảng cáo chuyển hướng, các macro mở rộng đến các thông số URL mô tả từ thông số truy vấn description_url của Thẻ nhà xuất bản Google. URL mô tả thường giống với URL liên kết giới thiệu. Bạn nên chỉ định description_url trong Thẻ nhà xuất bản Google nếu có những thẻ nhúng mà IMA SDK có thể không phát hiện chính xác URL trang hoặc nếu bạn đang sử dụng video trong Ad Exchange hoặc AdSense cho video.
%%DESCRIPTION_URL%%. Macro này hoạt động theo cùng cách với %%DESCRIPTION_URL_UNESC%%, vì vậy bạn không cần phải mã hóa lại các quảng cáo và mẫu cũ hơn.| Macro | Thoát |
|---|---|
%%REFERRER_URL_UNESC%% |
Không thoát |
%%REFERRER_URL_ESC%% |
Thoát đơn |
%%REFERRER_URL_ESC_ESC%% |
Thoát kép |
Sử dụng %%REFERRER_URL_ESC%% (thoát đơn) khi macro nằm trong URL và sử dụng %%REFERRER_URL_UNESC%% (không thoát) trong các ngữ cảnh khác. Tìm hiểu thêm về macro thoát so với macro không thoát
Macro này mở rộng thành URL liên kết giới thiệu (URL của trang có trình phát video) trong các thẻ quảng cáo chuyển hướng. Macro làm như vậy theo cách sau: Ad Manager phân tích cú pháp thông số truy vấn URL của thẻ quảng cáo, tách URL liên kết giới thiệu và thay thế ký tự macro bằng URL đó. Macro chỉ hoạt động với SDK IMA của Google, với các tiêu chuẩn sau:
- Phải kích hoạt quyền truy cập tập lệnh trên trang để macro này hoạt động.
- Macro này không hoạt động bên trong iframe.
%%REFERRER_URL%%, macro này có chức năng giống như %%REFERRER_URL_UNESC%%, vì vậy bạn không cần phải mã hóa lại các quảng cáo và mẫu cũ hơn.Macro nội dung video
Những macro này được sử dụng cho quảng cáo nhắm mục tiêu nguồn nội dung video.
| Macro |
|---|
%%VIDEO_DURATION%% |
Mở rộng thời lượng của video tính bằng mili giây.
| Macro |
|---|
%%VIDEO_ID%% |
Mở rộng tới mã nội dung video hiện đang phát, là mã duy nhất trong CMS hoặc giá trị dfpvideo:ContentID từ MRSS.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
Siêu dữ liệu về video nơi quảng cáo đang được phân phát, dựa trên khóa-giá trị được liên kết với nội dung video. Bạn có thể thiết lập khoá-giá trị trong Ad Manager trong thẻ "Video".
Sau khi nhắm mục tiêu một khoá siêu dữ liệu video, bạn có thể mở rộng khoá siêu dữ liệu video đó. "Từ khoá" được dùng macro phải là ký tự chữ số hoặc gạch dưới (_).
| Macro | Thoát |
|---|---|
%%VIDEO_TITLE%% |
Thoát đơn |
Macro tiêu đề video mở rộng để hiển thị tiêu đề của video như đã xác định trong Ad Manager.
Bạn cần nhập nội dung để macro này hoạt động.
| Macro |
|---|
%%FW_CAID%% |
Mở rộng ID quảng cáo tùy chỉnh FreeWheel.
Macro này chỉ áp dụng cho các nhà xuất bản sử dụng FreeWheel để phân phát quảng cáo video.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Dùng để chuyển các danh mục quảng cáo cho các quảng cáo mà bạn đã phân loại thủ công bằng nhãn. Macro này trả về danh sách các danh mục IAB chuẩn có thể sử dụng được phân tách bằng dấu phẩy (được chuyển đổi từ các danh mục được phân loại của Google).
Các nhà xuất bản chia sẻ khoảng không quảng cáo video với FreeWheel và muốn chuyển các danh mục quảng cáo dưới dạng thông số tùy chỉnh có thể sử dụng macro này. Ví dụ: bạn có thể thêm &iab_categories=%%IAB_CATEGORIES%% vào thẻ chuyển hướng VAST.
