แนวคิดพื้นฐาน

หน้านี้แสดงภาพรวมสถาปัตยกรรมของ Google Ad Manager API และอธิบายแนวคิดและข้อกำหนดทั่วไปใน Ad Manager

สถาปัตยกรรม API

ต่อไปนี้เป็นแผนภาพแบบง่ายของคลาสหลักใน Ad Manager API และความเกี่ยวข้องกัน

ออบเจ็กต์หลักในสถาปัตยกรรม Ad Manager

สั่งซื้อ

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

LineItem

ออบเจ็กต์ LineItem อธิบายถึงชุดข้อกำหนดในการแสดงโฆษณา รวมถึงวิธีและเวลาที่จะแสดงโฆษณา ขนาดของครีเอทีฟโฆษณาที่จะแสดง และลำดับในการแสดงโฆษณา (ตามลำดับ ถ่วงน้ำหนัก หรือตามประสิทธิภาพ) ลำดับความสำคัญของโฆษณา และพร็อพเพอร์ตี้มากมายที่อธิบายโครงสร้างต้นทุน LineItem มีออบเจ็กต์ InventoryTargeting 1 รายการที่อธิบายออบเจ็กต์ AdUnit และ Placement ที่กําหนดเป้าหมายได้ และออบเจ็กต์คลาสย่อย Targeting เพิ่มเติมที่ไม่บังคับที่แสดงถึงภูมิศาสตร์ ที่กําหนดเอง หรือเกณฑ์อื่นๆ

LineItemCreativeAssociation

LineItemCreativeAssociation (มักเรียกว่า LICA) ลิงก์ 1 LineItem ไปยัง Creative คุณลิงก์รายการโฆษณากับครีเอทีฟโฆษณาได้มากกว่า 1 รายการ และคุณอาจลิงก์ครีเอทีฟโฆษณากับรายการโฆษณาได้มากกว่า 1 รายการ ทั้งนี้ขึ้นอยู่กับประเภทบัญชีที่ใช้ เมื่อคุณสร้าง LineItemCreativeAssociation ก่อนอื่น Ad Manager จะตรวจสอบว่าทั้งครีเอทีฟโฆษณาและรายการโฆษณาใช้งานร่วมกันได้หรือไม่ เช่น หากขนาดแตกต่างกัน คุณจะได้รับข้อผิดพลาดเมื่อพยายามสร้างหรืออัปเดตการเชื่อมโยง ออบเจ็กต์นี้ยังให้คุณลบล้างค่าบางค่าใน LineItem ที่เชื่อมโยงได้ด้วย เช่น วันที่เริ่มต้น/สิ้นสุด หรือขนาด (หากคุณมีครีเอทีฟโฆษณาที่มีขนาดไม่พอดีกับขนาดที่รายการโฆษณาระบุไว้ แต่คุณยินดีให้ Ad Manager ปรับขนาดครีเอทีฟโฆษณาให้พอดีกับหน่วยโฆษณาได้อย่างรวดเร็ว) LICA จะไม่แสดงในอินเทอร์เฟซผู้ใช้ของ Ad Manager เนื่องจากเป็นรูปแบบ API

ครีเอทีฟโฆษณา

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

คลาสย่อยการกำหนดเป้าหมายพื้นที่โฆษณาและการกำหนดเป้าหมาย

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

ตำแหน่งโฆษณา

ออบเจ็กต์ Placement คือคอลเล็กชันของออบเจ็กต์ AdUnit อย่างน้อย 1 รายการ

AdUnit

AdUnit หมายถึงตำแหน่งของโฆษณาในหน้าเว็บอย่างน้อย 1 หน้า AdUnit อาจเป็นเป้าหมายของออบเจ็กต์ InventoryTargeting ของ LineItem หรือออบเจ็กต์ Placement ก็ได้ ออบเจ็กต์ AdUnit มีขนาด รหัส และชื่อที่ไม่ซ้ำกัน รหัสนี้ใช้สำหรับระบุออบเจ็กต์ AdUnit อื่นๆ ภายใน API ชื่อนี้จะใช้เป็นตัวระบุที่ไม่ซ้ำกันในแท็ก HTML เพื่อระบุออบเจ็กต์ AdUnit ที่เจาะจง และส่งกลับไปยัง Ad Manager โดยเป็นส่วนหนึ่งของคำขอหน้าเว็บ