มาโคร

มาโครหน่วยโฆษณาแทรกเส้นทางของหน่วยโฆษณาจากแท็กผู้เผยแพร่โฆษณาผ่าน Google ลงในโค้ดโฆษณาเมื่อมีการแสดงโฆษณา

ต่อไปนี้คือวิธีเพิ่มมาโคร ADUNIT ลงในข้อมูลโค้ดโฆษณาของบุคคลที่สาม

มาโครหน่วยโฆษณาจะขยายเป็นเส้นทางหน่วยโฆษณาแบบเต็มซึ่งมีอยู่ในคำขอโฆษณาต้นฉบับ ซึ่งรวมถึงรหัสเครือข่าย ต่อไปนี้คือตัวอย่างวิธีขยายเส้นทางของหน่วยโฆษณาเมื่อแสดงโฆษณา

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>

มาโคร URL ปลายทางจะขยายเป็น URL การคลิกผ่านของโฆษณา ซึ่งเป็นทั้ง URL การคลิกผ่านของรายการโฆษณาหรือชุดลบล้างสำหรับโฆษณาภายในรายการโฆษณา

มาโคร URL ปลายทางมีประโยชน์สำหรับครีเอทีฟโฆษณาสำหรับ AMP โดยเฉพาะและเทมเพลตโฆษณา ซึ่งมาโครนี้สามารถช่วยได้ หากโค้ดโฆษณาจำเป็นต้องมี URL การคลิกผ่านของโฆษณา และ URL การคลิกผ่านเปลี่ยนแปลงเมื่อใช้โฆษณาหรือเทมเพลตในรายการโฆษณาอื่น

มาโคร URL การคลิกผ่านมีสามประเภท ได้แก่ ใช้ Escape, ใช้ Escape 2 ครั้ง และไม่ใช้ Escape โดยทั่วไปแล้ว จำนวนของการ Escape (ไม่ว่าคุณจะรวม ESC หนึ่งครั้ง สองครั้ง หรือไม่มีเลยก็ตาม) จะขึ้นอยู่กับบริษัทติดตามการคลิกที่เป็นบุคคลที่สาม ซึ่งบางบริษัทอาจต้องการให้ URL มีการ Escape ในขณะที่บริษัทอื่นอาจไม่ต้องการ บ่อยครั้งจะมีการระบุระดับการ Escape ที่บริษัทติดตามการคลิกที่เป็นบุคคลที่สามต้องการไว้ในแท็กโดยใช้สตริง click= ในแท็กโฆษณาของบุคคลที่สาม หรือโค้ดครีเอทีฟโฆษณาสำหรับ AMP โดยเฉพาะใน Ad Manager ดังนี้

• click=: ใช้ Escape ครั้งเดียว (%%DEST_URL_ESC%%)

• click0=: ไม่ใช้ Escape (%%DEST_URL_UNESC%%)

• click1=: ใช้ Escape ครั้งเดียว (%%DEST_URL_ESC%%)

• click2=: ใช้ Escape 2 ครั้ง (%%DEST_URL_ESC_ESC%%)

มาโครเซิร์ฟเวอร์ไฟล์ %%FILE:file_display_name%% ขยายเป็น URL แบบเต็มของไฟล์เนื้อหาโฆษณาที่อัปโหลดสำหรับครีเอทีฟโฆษณา ใช้มาโครนี้เพื่อเรียกไฟล์เนื้อหาที่อัปโหลด เช่น รูปภาพ ที่มีโค้ดครีเอทีฟโฆษณาสำหรับ AMP โดยเฉพาะ

ในการใช้มาโครนี้ ให้แทนที่ file_display_name ด้วยชื่อที่แสดงของไฟล์เนื้อหาโฆษณาตามที่แสดงใน Ad Manager เมื่อคุณดูรายละเอียดครีเอทีฟโฆษณา

มาโครเหล่านี้จะแทรกความสูงและความกว้างของครีเอทีฟโฆษณาตามที่กำหนดใน Ad Manager โดยค่าในช่อง "ขนาดหน่วยโฆษณาเป้าหมาย" ของครีเอทีฟโฆษณา ลงในโค้ดที่กำหนดเองของครีเอทีฟโฆษณาในระหว่างขั้นตอนการแสดงโฆษณา

มาโครความสูงและความกว้างจะมีประโยชน์อย่างยิ่งเมื่อคุณสร้างเทมเพลตครีเอทีฟโฆษณาที่คุณต้องการใช้ครีเอทีฟโฆษณาซ้ำในขนาดที่ต่างกัน คุณให้มาโครความสูงและความกว้างใส่ค่าลงในครีเอทีฟโฆษณาแต่ละรายการแบบไดนามิกได้ แทนที่จะฮาร์ดโค้ดขนาดของแต่ละรายการ

ใช้มาโครการจับคู่รูปแบบเพื่อส่งตัวแปรที่กำหนดเอง 1 รายการขึ้นไป อย่างเช่นค่าการกำหนดเป้าหมายลงในครีเอทีฟโฆษณา คุณใช้มาโครนี้เพื่อส่งคีย์- ค่า แทนที่สตริงการกำหนดเป้าหมายทั้งสตริง หรือขยาย URL ที่มาได้ มาโครนี้จะมีประโยชน์ในกรณีที่คุณต้องการแสดงครีเอทีฟโฆษณาที่ต่างกันตามข้อมูลที่ทราบเกี่ยวกับผู้ใช้ เช่น ค่ากำหนดเนื้อหาของผู้ใช้

การแทนที่มาโครการจับคู่รูปแบบจะจำกัดอยู่ที่ 100 รายการต่อครีเอทีฟโฆษณา

%%PATTERN:key%%

ตัวอย่างเช่น คุณมีครีเอทีฟโฆษณา 2 ชิ้นสำหรับรายการโฆษณาหนึ่ง โดยชิ้นหนึ่งออกแบบมาเพื่อดึงดูดผู้ใช้เพศหญิงและอีกชิ้นหนึ่งสำหรับผู้ใช้เพศชาย "คีย์" ที่ใช้ในมาโครต้องเป็นอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือเครื่องหมายขีดล่าง (_)

การทำงานจะมีลักษณะดังนี้

1. คุณจะส่งค่าที่กำหนดเอง (ในกรณีนี้คือเพศของผู้ใช้) ไปยังแท็กโฆษณาในหน้าเว็บโดยใช้คีย์-ค่า ดังนี้
   googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male");
2. ในครีเอทีฟโฆษณาที่กำหนดเองหรือของบุคคลที่สาม ให้ส่งค่าที่กำหนดเอง (เพศของผู้ใช้) แบบไดนามิกโดยใช้มาโครต่อไปนี้ <ใส่สคริปต์ครีเอทีฟโฆษณาที่นี่>...&gender=%%PATTERN:gender%%
3. มาโคร %%PATTERN:gender%% ทั้งมาโครจะแทนที่ด้วย "male"
4. Ad Manager จะเรียกและแสดงไฟล์ครีเอทีฟโฆษณา "male" แก่ผู้ใช้คนนี้

%%PATTERN:TARGETINGMAP%%

คุณใช้ %%PATTERN:TARGETINGMAP%% เพื่อแทนที่ผังการกำหนดเป้าหมายทั้งหมดและสร้างแท็กรายการส่งคืนแบบไดนามิกได้

ต่อไปนี้คือวิธีเพิ่มมาโคร TARGETINGMAP ลงในแท็กโฆษณา

.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();

ต่อไปนี้คือตัวอย่างสตริงคีย์-ค่าที่สมบูรณ์เมื่อแสดงโฆษณา

.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();

%%PATTERN:url%%

คุณยังใช้ url ซึ่งเป็นคีย์สงวนเพื่อขยายเป็น URL ของหน้าที่อ้างอิงได้ด้วย

โปรดทราบว่า URL คือคีย์ที่สงวนไว้ ดังนั้นคีย์-ค่าใดๆ ก็ตามในแท็ก Campaign Manager 360 ที่มี URL เป็นชื่อคีย์จะถูกเขียนทับด้วย URL ผู้อ้างอิง

มาโครพารามิเตอร์แท็กจะใช้ร่วมกับพารามิเตอร์แท็กโฆษณาอื่นๆ และใช้ได้เฉพาะกับพารามิเตอร์ต่อไปนี้เท่านั้น

• pmad
• pmxd
• pmnd
• correlator
• scor
• pod
• vpos
• mridx
• ppos
• lip
• us_privacy

โดยจะขยายรวมไปถึงค่าของพารามิเตอร์หากรองรับ

ตัวอย่างเช่น %%TAG_PARAM:correlator%% (รองรับ) จะขยายรวมไปถึงค่าสหสัมพันธ์จากแท็กโฆษณา แต่ %%TAG_PARAM:ppid%% (ไม่รองรับ) จะไม่ขยายไปถึงค่าใดๆ

เป้าหมายในมาโครหน้าต่างใหม่จะบ่งบอกว่าการตั้งค่าหน้าต่างเป้าหมายที่ระบุไว้สำหรับหน่วยโฆษณาที่แสดงโฆษณาเป็น "_blank" (หน้าต่างใหม่) หรืออย่างอื่น

• หากหน้าต่างเป้าหมายเป็น _blank มาโครจะขยายเป็น 1

• หากหน้าต่างเป้าหมายเป็นค่าอื่นหรือไม่ได้ระบุหน้าต่างเป้าหมายไว้ มาโครจะขยายเป็น 0

ใช้มาโคร %%TARGET_WINDOW%% หากคุณต้องการแทรกค่าของการตั้งค่าหน้าต่างเป้าหมายที่แท้จริง

มาโครหน้าต่างเป้าหมายจะขยายเป็นหน้าต่างเป้าหมายที่ระบุไว้สำหรับหน่วยโฆษณาที่แสดงโฆษณา คุณใช้มาโครในโค้ดโฆษณาเพื่อระบุว่าการคลิกที่โฆษณาจะนำผู้ใช้ไปยังหน้าต่างใหม่หรือโหลดหน้า Landing Page ในหน้าต่างเดิมได้ ทั้งนี้ขึ้นอยู่กับการตั้งค่าของแต่ละไซต์ที่ผู้ใช้จะเห็นโฆษณา

ตัวอย่างเช่น หน่วยโฆษณา AdManager_News.com ตั้งค่าหน้าต่างเป้าหมายเป็น _top และหน่วยโฆษณา AdManager_Fashion.com ตั้งค่าดังกล่าวเป็น _new หากมาโคร %%TARGET_WINDOW%% รวมอยู่ในโค้ดของครีเอทีฟโฆษณา มาโครจะขยายเป็น _top สำหรับผู้ใช้ที่ AdManager_News.com และ _new สำหรับผู้ใช้ AdManager_Fashion.com

ตัวอย่างการใช้งาน

<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="โฆษณาของฉัน"></a>

ใช้มาโคร %%TARGET_IN_NEW_WINDOW%% หากคุณต้องการกำหนดให้ค่าของการตั้งค่าหน้าต่างเป้าหมายเป็น "_blank" หรือค่าอื่น

แท็กสำหรับเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย (TFCD) ช่วยให้คุณแจ้งให้บุคคลที่สามทราบได้ว่าคำขอโฆษณามาจากหน้าที่มีเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย มาโครดังกล่าวมีจุดประสงค์เพื่อช่วยให้ปฏิบัติตามข้อกำหนดของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act)

คุณใส่มาโครดังกล่าวในการเปลี่ยนเส้นทางหรือคำขอทั้งหมดสำหรับครีเอทีฟโฆษณาของบุคคลที่สามได้ โดยอยู่ในรูปแบบ coppa=%%TFCD%% หรือรูปแบบอื่นที่คล้ายกัน และคุณยังใช้มาโครนี้ใน JavaScript เพื่อตั้งค่าคำขอแท็กรายการส่งคืน GPT สำหรับการดูแลให้เหมาะสมกับเด็กได้ด้วย มาโครจะขยายเป็น 1 สำหรับเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย หรือ 0 สำหรับเนื้อหาอื่นๆ โดยอิงตามข้อมูลเกี่ยวกับลักษณะตามธรรมชาติของหน้า เว็บไซต์ หรือแอปบนอุปกรณ์เคลื่อนที่ที่ส่งคำขอไปยัง Ad Manager

หากคุณกำลังใช้บริการโฆษณาของ Google และต้องการใช้การดูแลให้เหมาะสมกับเด็กที่ระดับเว็บไซต์หรือระดับแอป โปรดดูแท็กเว็บไซต์หรือแอปสำหรับการดูแลให้เหมาะสมกับเด็ก

มาโครที่มีการเข้ารหัส URI จะแปลช่องว่างและสัญลักษณ์พิเศษอื่นๆ ในค่าตัวแปรของเทมเพลตครีเอทีฟโฆษณาอย่างถูกต้องเพื่อใช้ใน URI ซึ่งเรียกอีกอย่างว่า URL

มาโครนี้มีประโยชน์มากเมื่อใช้ตัวแปรเทมเพลตครีเอทีฟโฆษณาเพื่อกำหนด URL การคลิกผ่านหรือ URL การเปลี่ยนเส้นทาง หากไม่ได้เข้ารหัสอย่างถูกต้อง URL แบบเต็มในครีเอทีฟโฆษณาอาจใช้งานไม่ได้

มาโครระบบป้องกันแคชจะดูแลให้มีการเรียกครั้งใหม่ไปที่เซิร์ฟเวอร์โฆษณาทุกครั้งที่มีการเรียกใช้โค้ดเพื่อให้คุณนับการแสดงผลได้อย่างถูกต้อง หากคุณไม่ได้เพิ่มมาโครระบบป้องกันแคชลงในโค้ดโฆษณา คุณมีแนวโน้มที่จะเห็นความคลาดเคลื่อนในการนับการแสดงผลระหว่าง Google Ad Manager และเซิร์ฟเวอร์โฆษณาของบุคคลที่สาม โปรดทราบว่าบุคคลที่สามบางรายไม่ได้กำหนดให้ใช้มาโครระบบป้องกันแคช

ผู้ให้บริการโฆษณาส่วนใหญ่จะมีตัวยึดตำแหน่งในแท็กของตนสำหรับใส่มาโครระบบป้องกันแคช ตัวอย่างเช่น หากโค้ดโฆษณาของบุคคลที่สามมีลักษณะดังนี้

http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]

คุณจะต้องเลือก [RANDOM_NUMBER] และคลิกแทรกมาโครระบบป้องกันแคชเพื่อให้แทนที่ตัวยึดตำแหน่ง ดังนี้

http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%

มาโครระบบป้องกันแคชในการตอบสนองของ VAST

มาโคร %%CACHEBUSTER%% ขยายเป็นจำนวนแบบสุ่มจำนวนเดียวกันสำหรับเหตุการณ์ทั้งหมดในครีเอทีฟโฆษณาชิ้นหนึ่งๆ วิธีนี้มีประโยชน์โดยเฉพาะอย่างยิ่งสำหรับโฆษณาวิดีโอ เนื่องจากมาโครขยายเป็นจำนวนแบบสุ่มจำนวนเดียวกันสำหรับเหตุการณ์การติดตามวิดีโอทั้งหมดในการตอบสนอง VAST

มาโครการคลิกขยายเป็น URL พิเศษเพื่อให้คุณติดตามการคลิกใน Ad Manager สำหรับครีเอทีฟโฆษณาของบุคคลที่สามได้ โดยทั่วไปแล้วมาโครนี้จะจับคู่กับ URL การคลิกผ่านของครีเอทีฟโฆษณาในแท็ก Anchor (<a>) อย่าป้อนมาโครการคลิกเป็นแหล่งที่มาของรูปภาพหรือ iframe การทำเช่นนั้นจะทำให้มีการบันทึกการคลิกทุกครั้งที่แสดงผลรูปภาพหรือ iframe ซึ่งไม่ถูกต้องตามหลักเกณฑ์และจะถูกกรองออกเนื่องจากเป็นคลิกที่ไม่ถูกต้อง 

ใช้ %%CLICK_URL_UNESC%% ที่ด้านหน้าลิงก์ ใช้ %%CLICK_URL_ESC%% เมื่อตัวติดตามการคลิกเป็นพารามิเตอร์ของ URL อื่น

<a href="%%CLICK_URL_UNESC%%http://www.google.com">ลิงก์</a>

<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">ลิงก์</a>

ดูข้อมูลเพิ่มเติมเกี่ยวกับมาโครที่ใช้และไม่ใช้ Escape

ยืนยันการใช้มาโครการคลิก

การวางมาโครการคลิกที่ไม่ถูกต้องจะไม่ติดตามการคลิก ทำตามขั้นตอนต่อไปนี้เพื่อยืนยันว่า Ad Manager จะบันทึกการคลิกอย่างที่คุณคาดหวัง

1. ดูตัวอย่างครีเอทีฟโฆษณา
2. คลิกที่ตัวอย่าง

Ad Manager จะแสดงการยืนยันว่าจะบันทึกการคลิก หากคุณไม่เห็นการยืนยันนี้ แสดงว่ามีการใช้มาโครการคลิกอย่างไม่ถูกต้อง

ใช้มาโครการขยายในโค้ดครีเอทีฟโฆษณาสำหรับ AMP โดยเฉพาะหรือใน URL การคลิกผ่านเพื่อแสดงค่าของรหัสจาก Ad Manager เมื่อแสดงครีเอทีฟโฆษณาบนหน้าเว็บ ซึ่งมักใช้บ่อยในการจับคู่รหัสจาก Ad Manager กับรหัสในฐานข้อมูลของผู้เผยแพร่โฆษณาเองเพื่อการแก้ปัญหาหรือการรายงานอื่นๆ

คุณคั่นมาโครการขยายออกจากกันได้ใน URL การคลิกผ่านด้วยอักขระใดก็ได้ที่ปลอดภัยสำหรับการใช้ใน URL การคลิกผ่านของ Ad Manager ตัวอย่างเช่น http://www.site.com/?%eaid!;%ecid! จะขยายเป็น http://www.site.com/?1234567;4265598

มาโคร %%ADVERTISING_IDENTIFIER_PLAIN%% ช่วยให้ผู้เผยแพร่โฆษณาในแอปสามารถส่งรหัสอุปกรณ์ที่รีเซ็ตได้ให้แก่พาร์ทเนอร์โฆษณาเพื่อแสดงโฆษณาตามความสนใจ วิธีนี้ช่วยให้คุณให้สิทธิ์แก่ผู้ลงโฆษณาและเอเจนซีของคุณในการเข้าถึงรหัสอุปกรณ์ที่รีเซ็ตได้ได้ง่ายขึ้น

ผู้เผยแพร่โฆษณาในแอปยังใช้มาโคร %%ADVERTISING_IDENTIFIER_TYPE%% เพื่อส่งประเภทอุปกรณ์ และใช้มาโคร %%ADVERTISING_IDENTIFIER_IS_LAT%% เพื่อส่งการตั้งค่าการจำกัดการติดตามโฆษณา (LAT) ซึ่งระบุสัญญาณ "จํากัดการติดตามโฆษณา" จากอุปกรณ์

ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสอุปกรณ์ที่รีเซ็ตได้เพื่อการกําหนดเป้าหมายผู้ใช้ ซึ่งมีประเภทอุปกรณ์ที่รองรับ

ข้อกำหนดเบื้องต้น

ตั้งค่าการเข้ารหัส HTTPS สำหรับครีเอทีฟโฆษณา นี่เป็นข้อกำหนดสำหรับทั้งครีเอทีฟโฆษณาและพิกเซลของบุคคลที่สามที่คุณใช้เป็นเครื่องมือวัด Conversion หากครีเอทีฟโฆษณาไม่มีการเข้ารหัสสำหรับ HTTPS หรือหากคุณลบล้างความเข้ากันได้กับ SSL แบบอัตโนมัติ มาโครจะไม่ขยายค่า แต่จะยังคงมีการแสดงครีเอทีฟโฆษณา

วิธีการทำงาน

1. ใน Ad Manager ผู้เผยแพร่โฆษณารวมมาโครต่างๆ ไว้ในครีเอทีฟโฆษณาของตนและ/หรือ URL การติดตาม

2. มาโครจะขยายให้มีรหัสอุปกรณ์ของผู้ใช้ ประเภทอุปกรณ์ และ/หรือการตั้งค่า LAT ซึ่งจากนั้นจะรวมไว้ในครีเอทีฟโฆษณาขณะที่เรียกไปยังบุคคลที่สาม

   มาโครตัวระบุจะไม่ขยายหากคำขอโฆษณามาจากแอปที่มีเด็กเป็นกลุ่มเป้าหมาย (TFCD) หรือมีการเปิดใช้จำกัดการติดตามโฆษณา (LAT) ไว้ ในกรณีเหล่านี้ มาโครนี้จะส่งสตริงที่ว่างเปล่า ("") กลับมา

รูปแบบ

มาโครนี้จะส่งค่าเลขฐาน 16 ตัวพิมพ์ใหญ่ 32 หลัก ซึ่งแสดงเป็นกลุ่ม 5 กลุ่มและคั่นด้วยเครื่องหมายขีดกลางในรูปแบบ 8-4-4-4-12 รวม 36 อักขระ (อักขระที่เป็นตัวอักษรและตัวเลขคละกัน 32 ตัวและเครื่องหมายขีดกลาง 4 ตัว)

ตัวอย่างเช่น 201F2EB1-8041-9E39-CD07-FCBBA5A29B41

ดูค่าที่เป็นไปได้สำหรับประเภทอุปกรณ์ที่รองรับและจำกัดการติดตามโฆษณา (LAT)

ใช้มาโครโหมดแสดงตัวอย่างในโค้ดครีเอทีฟโฆษณาสำหรับ AMP โดยเฉพาะเพื่อป้องกันการนับการแสดงผลตัวอย่างโดยระบบแบ็กเอนด์หรือระบบของบุคคลที่สาม มาโครจะขยายเป็น true หากกำลังมีการดูครีเอทีฟโฆษณาเป็นตัวอย่างโฆษณา Ad Manager และหากเป็นการแสดงผลตามปกติ มาโครจะขยายเป็น false

มาโครรูปแบบจะขยายเป็น http: หรือ https: อย่างใดอย่างหนึ่งที่ตรงกับรูปแบบความปลอดภัยของหน้าเว็บที่กำลังแสดงครีเอทีฟโฆษณา คุณสามารถวางมาโครไว้ที่จุดเริ่มต้นของ URL ได้ดังนี้

<img src=%%SCHEME%%//www.website.com/img/logo.gif>

ขยายเป็นโดเมนของพารามิเตอร์ URL ในแท็กโฆษณา (เช่น google.com) มาโครนี้สามารถใช้เพื่อแก้ไขครีเอทีฟโฆษณาโดยอิงตามที่มาของคำขอ และจะไม่ทำงานในโฆษณาของ Ad Exchange ที่ทำเครื่องหมายว่าไม่ระบุตัวตน

มาโครการแสดงผลที่ดูแล้วทำให้ Ad Manager นับการแสดงผลได้ในแต่ละครั้งที่มีการดาวน์โหลดครีเอทีฟโฆษณาลงในอุปกรณ์ของผู้ใช้และโฆษณาเริ่มโหลดขึ้นแล้ว ใช้มาโครนี้ในครีเอทีฟโฆษณาที่ไม่อยู่ในขอบเขตหน้าเท่านั้น

คุณส่งการใช้คำสั่ง ping สำหรับการแสดงผลได้หลายวิธีด้วยกัน แต่เราขอแนะนำให้ใช้แท็ก <img> ดังนี้

<!-- คุณจะไม่เห็นแท็ก img นี้ แท็กนี้ทำให้เบราว์เซอร์ส่งคำขอไปยัง VIEW_URL -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">

<!-- แท็ก img นี้แสดงโฆษณาจริง-->
<img src="[%Imagefile%]" border="0">

แท็ก <img> แรกจะดึงภาพอัตราส่วน 1x1 จาก VIEW_URL กำหนดรูปแบบเป็น “display:none” เพื่อซ่อนไว้และไม่ให้มีผลกับเลย์เอาต์ของหน้า

ขยายเป็นค่า gdpr= ที่เชื่อมโยงกับคําขอ

ขยายเป็นสตริงความโปร่งใสและคำยินยอม (TC) ที่เชื่อมโยงกับคําขอ หากสตริงความโปร่งใสและคำยินยอม (TC) เว้นว่างไว้หรือไม่ถูกต้อง มาโครนี้จะไม่ขยาย ใช้มาโครนี้เพื่อส่งสตริง TC ไปยังผู้ให้บริการครีเอทีฟโฆษณาบุคคลที่สามในรูปแบบ URL ในชิ้นงานโฆษณาแบบไม่เป็นโปรแกรม

แทนที่ "XXXX" ด้วยรหัส IAB GVL ของผู้ให้บริการบุคคลที่สาม หากสตริง TC เว้นว่างไว้หรือไม่ถูกต้อง มาโครนี้จะไม่ขยาย

ชิ้นงานโฆษณาที่ใช้มาโคร ${GDPR_CONSENT_XXXX} อาจถูกบล็อกหากผู้ให้บริการบุคคลที่สามที่เกี่ยวข้องกับรหัส IAB GVL ที่คุณป้อนไม่ได้รับความยินยอมจากผู้ใช้

เมื่อใช้ในแท็ก VAST และผู้ให้บริการบุคคลที่สามไม่ได้รับความยินยอมจากผู้ใช้ มาโครนี้จะไม่ขยาย

มาโคร ${GDPR_CONSENT_XXXX} ควรปรากฏใน URL เพียงครั้งเดียวเท่านั้น โปรดติดต่อผู้ให้บริการครีเอทีฟโฆษณาบุคคลที่สามเพื่อสอบถามให้เข้าใจเกี่ยวกับข้อกำหนดของทางผู้ให้บริการในการส่งสตริง TC รวมทั้งข้อจำกัดด้านความยาวของ URL มาโครนี้จะถูกแทนที่เมื่อมีคำขอ IAB TCF v2.0 ที่เกี่ยวข้องซึ่งมีสตริง TC ที่สมบูรณ์และไม่มีการแก้ไข

มาโครกรอบความโปร่งใสและความยินยอม (TCF) จะไม่ขยายเมื่อนำมาใช้ใน HTML ของครีเอทีฟโฆษณา HTML5 โดยมีเพียงครีเอทีฟโฆษณาการเปลี่ยนเส้นทางโฆษณาแบบดิสเพลย์และครีเอทีฟโฆษณาแบบดิสเพลย์ที่กําหนดเองเท่านั้นที่รองรับมาโคร TCF แบบขยายผ่านช่อง "URL ของบุคคลที่สาม" และ "โค้ด HTML" ตามลําดับ

ขยายเป็นสตริงคํายินยอมเพิ่มเติม (AC) ที่เชื่อมโยงกับคําขอ

ขยายเป็นค่า 1 เพื่อแท็กคำขอสำหรับผู้ใช้ใน EEA และสหราชอาณาจักรที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้

ขยายเป็นระยะเวลาของโฆษณาวิดีโอ โดยมีหน่วยเป็นมิลลิวินาที สําหรับ VAST Wrapper/การเปลี่ยนเส้นทาง มาโครจะขยายตามระยะเวลาที่ระบุไว้ของโฆษณาใน Ad Manager

ใช้ %%DESCRIPTION_URL_ESC%% (ใช้ Escape ครั้งเดียว) เมื่อมาโครอยู่ภายใน URL และใช้ %%DESCRIPTION_URL_UNESC%% (ไม่ใช้ Escape) ในบริบทอื่น ดูข้อมูลเพิ่มเติมเกี่ยวกับมาโครที่ใช้ Escape และไม่ใช้ Escape

ในแท็กโฆษณาการเปลี่ยนเส้นทาง มาโครเหล่านี้จะขยายเป็นพารามิเตอร์ URL คำอธิบายจากพารามิเตอร์การค้นหา description_url ของแท็กผู้เผยแพร่โฆษณาผ่าน Google ดั้งเดิม โดยปกติแล้ว URL คำอธิบายควรเป็น URL เดียวกันกับ URL ที่มา คุณควรระบุ description_url ในแท็กผู้เผยแพร่โฆษณาผ่าน Google หากมีการฝังไว้ในที่ที่ IMA SDK อาจไม่พบ URL หน้าเว็บได้อย่างแม่นยำ หรือหากคุณกำลังใช้วิดีโอใน Ad Manager หรือ AdSense for Video

ใช้ %%REFERRER_URL_ESC%% (ใช้ Escape ครั้งเดียว) เมื่อมาโครอยู่ใน URL และใช้ %%REFERRER_URL_UNESC%% (ไม่ใช้ Escape) ในบริบทอื่น ดูข้อมูลเพิ่มเติมเกี่ยวกับมาโคร URL ที่ใช้ Escape และไม่ใช้ Escape

มาโครจะขยายเป็น URL ที่มา (URL ของหน้าเว็บที่มีโปรแกรมเล่นวิดีโอ) ในแท็กโฆษณาแบบเปลี่ยนเส้นทาง ซึ่งจะทำงานในลักษณะนี้ คือ Ad Manager แยกวิเคราะห์พารามิเตอร์การค้นหา URL ของแท็กโฆษณา แยก URL ที่มาออกมา และแทนที่ข้อความมาโครด้วย URL นั้น ใช้ได้เฉพาะกับ Google IMA SDK เท่านั้น โดยมีคุณสมบัติดังต่อไปนี้

• ต้องเปิดใช้การเข้าถึงสคริปต์บนหน้าเว็บเพื่อให้มาโครนี้ทำงาน
• มาโครไม่ทำงานภายใน iframe

ขยายเป็นระยะเวลาของวิดีโอ โดยมีหน่วยเป็นมิลลิวินาที

ขยายเป็นรหัสของเนื้อหาวิดีโอที่เล่นอยู่ในขณะนี้ โดยเป็นรหัสที่ไม่ซ้ำกันใน CMS หรือค่า dfpvideo:ContentID จาก MRSS 

ขยายเป็นข้อมูลเมตาเกี่ยวกับวิดีโอที่แสดงโฆษณาอ้างอิงตามคีย์-ค่าที่เชื่อมโยงกับเนื้อหาของวิดีโอ คีย์-ค่าเหล่านี้ได้รับการตั้งค่าใน Ad Manager ในแท็บ "วิดีโอ" 

เมื่อกําหนดเป้าหมายคีย์ข้อมูลเมตาของวิดีโอแล้วจะสามารถขยายคีย์ได้ในมาโครข้อมูลเมตาของวิดีโอ "คีย์" ที่ใช้ในมาโครต้องเป็นอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือเครื่องหมายขีดล่าง (_)

มาโครชื่อวิดีโอจะขยายเพื่อแสดงชื่อวิดีโอตามที่กำหนดไว้ใน Ad Manager

มาโครนี้ต้องใช้การนำเข้าเนื้อหาจึงจะทำงานได้ 

ขยายเป็นรหัสโฆษณาที่กำหนดเองของ FreeWheel

มาโครนี้ใช้เฉพาะกับผู้เผยแพร่โฆษณาที่ใช้ FreeWheel สำหรับการแสดงโฆษณาวิดีโอ

ใช้เพื่อส่งหมวดหมู่โฆษณาสำหรับครีเอทีฟโฆษณาที่คุณได้จัดหมวดหมู่เองโดยใช้ป้ายกำกับ มาโครนี้จะแสดงรายการหมวดหมู่ IAB มาตรฐานที่เกี่ยวข้องซึ่งคั่นแต่ละหมวดหมู่ด้วยจุลภาค (แปลงจากหมวดหมู่ที่จัดโดย Google)

มาโครนี้จะใช้ได้โดยผู้เผยแพร่โฆษณาที่แชร์พื้นที่โฆษณาวิดีโอกับ FreeWheel และต้องส่งหมวดหมู่โฆษณาเป็นพารามิเตอร์ที่กำหนดเอง ตัวอย่างเช่น คุณจะเพิ่ม &iab_categories=%%IAB_CATEGORIES%% ลงในแท็กการเปลี่ยนเส้นทาง VAST ได้