บุคคลที่สามไม่ใช่ผู้ใช้ Ad Manager โดยตรง เนื่องจากอาจไม่มีเครือข่าย Ad Manager ของตนเอง แต่จะสร้างบริการหรือการผสานรวมกับ Ad Manager ให้แก่ลูกค้าของตนซึ่งเป็นลูกค้า Ad Manager แทน คู่มือนี้ครอบคลุม พื้นฐานของการผสานรวมกับบุคคลที่สามโดยการให้แนวทางปฏิบัติแนะนำ เคล็ดลับ และ เทคนิค
คู่มือนี้ถือว่าคุณมีความรู้ความเข้าใจเกี่ยวกับ Ad Manager API หากคุณยังไม่คุ้นเคยกับ Ad Manager API โปรดดูเอกสารการเริ่มต้นใช้งาน
เริ่มต้นใช้งานในฐานะบุคคลที่สาม
หากต้องการใช้ Ad Manager API เพื่อเข้าถึงเครือข่ายของลูกค้า Ad Manager ให้ทำตาม หลักเกณฑ์ด้านล่าง ไม่จำเป็นต้องขออนุมัติเพิ่มเติมจาก Google แต่โปรดทราบว่าการเข้าถึงและ/หรือการใช้ Ad Manager API ถือว่าคุณยอมรับข้อกำหนดและเงื่อนไขของ Ad Manager API
วิธีทดสอบการผสานรวม Ad Manager ในฐานะบุคคลที่สาม
ในฐานะบุคคลที่สาม คุณอาจสงสัยว่าจะทดสอบการผสานรวม Ad Manager ก่อนที่จะใช้งานกับเครือข่ายจริงของลูกค้าได้อย่างไร แนวทางที่แนะนำคือสร้างเครือข่ายทดสอบ คุณไม่จำเป็นต้องเป็นลูกค้า Ad Manager เพื่อดำเนินการนี้ ทุกคนที่มีบัญชี Google สามารถ สร้างเครือข่ายทดสอบได้
อย่างไรก็ตาม โปรดทราบความแตกต่างระหว่างเครือข่ายทดสอบและเครือข่ายที่ใช้งานจริง เครือข่ายทดสอบไม่สามารถแสดงโฆษณาได้ นอกจากนี้ เครือข่ายทดสอบ อาจไม่มีฟีเจอร์ทั้งหมดที่ลูกค้า อาจมีในเครือข่ายการผลิต หากต้องการทดสอบกับฟีเจอร์ Ad Manager ที่ไม่มีในเครือข่ายทดสอบ คุณสามารถเลือกซื้อสิทธิ์เข้าถึงเครือข่ายที่ไม่ใช่เครือข่ายทดสอบผ่านตัวแทนจำหน่าย Ad Manager
นอกจากนี้ คุณควรแจ้งให้ลูกค้าทราบอย่างชัดเจนว่าลูกค้าต้องมีฟีเจอร์ใดบ้างในเครือข่ายการผลิตเพื่อให้แอปพลิเคชันของคุณทำงานได้อย่างถูกต้อง แอปพลิเคชันของคุณควรจัดการกรณีที่ฟีเจอร์อาจไม่มีอยู่ โดยการดักจับข้อยกเว้นและล้มเหลวอย่างสง่างาม หรือเก็บรายการไคลเอ็นต์ และฟีเจอร์ที่แต่ละไคลเอ็นต์มีหรือไม่มี ลูกค้าของคุณควรเป็นผู้รับผิดชอบในการทำงานร่วมกับผู้ติดต่อที่ Google เพื่อจัดการฟีเจอร์ ในเครือข่ายของตน
การตรวจสอบสิทธิ์: วิธีเข้าถึงเครือข่าย Ad Manager ของลูกค้าอย่างถูกต้อง
หากต้องการให้แอปพลิเคชันเข้าถึงเครือข่าย Ad Manager ของลูกค้า คุณ ต้องตั้งค่าเวิร์กโฟลว์การตรวจสอบสิทธิ์อย่างปลอดภัย
โดยมี 2 ขั้นตอนดังนี้
- สร้างอีเมลบัญชี Google ที่คุณจะใช้เพื่อเข้าถึงเครือข่ายของลูกค้า
- ขอให้ลูกค้าเพิ่มบัญชีนี้เป็นผู้ใช้ในเครือข่าย Ad Manager ของตน
สำหรับขั้นตอนที่ 1 คุณจะสร้างบัญชี Google แยกต่างหากสำหรับลูกค้าแต่ละราย หรือ บัญชีหลักที่จะใช้สำหรับลูกค้าทั้งหมดก็ได้ ตัวเลือกแรกจะปลอดภัยกว่าในกรณีที่บัญชีใดบัญชีหนึ่งถูกบุกรุก ซึ่งหมายความว่า คุณต้องทำขั้นตอนที่ 1 เพียงครั้งเดียว
ไม่ว่าคุณจะทำอะไรในขั้นตอนที่ 1 ในขั้นตอนที่ 2 คุณจะต้องขอให้ลูกค้าใหม่แต่ละรายเพิ่มบัญชี Google ที่เหมาะสมซึ่งคุณสร้างไว้ให้เป็นผู้ใช้ในเครือข่าย Ad Manager ของลูกค้า
1. การสร้างบัญชี Google
คุณสร้างบัญชี Google ที่เพิ่มลงในเครือข่าย Ad Manager ได้หลายวิธี
ตัวเลือกที่ 1: สร้างบัญชีบริการ OAuth2 ซึ่งจะสร้าง อีเมลบัญชีบริการให้คุณซึ่งทำหน้าที่เป็นบัญชี Google วิธีการสร้างบัญชีบริการใหม่
ตัวเลือกที่ 2: คุณสร้างบัญชี Google ปกติ (บัญชี "Gmail") ได้โดยลงชื่อสมัครใช้ในฐานะผู้ใช้ใหม่ หากมีบัญชี Google อยู่แล้ว ให้ลงชื่อสมัครใช้ในหน้าต่างส่วนตัวหรือเซสชันเบราว์เซอร์ใหม่ หรือหากบริษัทใช้ Google Workspace คุณก็สร้างบัญชี Google ในโดเมนของบริษัทและใช้บัญชีนั้นแทนได้ สำหรับจุดประสงค์ของคู่มือนี้ เราจะ เรียกทั้ง 2 อย่างนี้ว่าบัญชี Google "ปกติ"
2. ขอให้ลูกค้าเพิ่มบัญชี Google ของคุณลงในเครือข่ายของตน
หลังจากได้รับบัญชี Google เพื่อเข้าถึงเครือข่ายของลูกค้าแล้ว ให้ขอให้ลูกค้าเพิ่มบัญชีดังกล่าวเป็นผู้ใช้ใหม่ในเครือข่าย Ad Manager
หากคุณให้อีเมลบัญชีบริการ OAuth2 แก่ผู้ใช้ ให้ผู้ใช้เพิ่มอีเมลดังกล่าวลงในเครือข่าย
หากคุณให้บัญชี Google ปกติแก่ผู้ใช้ ให้ผู้ใช้เพิ่มบัญชีของคุณเป็นผู้ใช้ในเครือข่ายของตน
ไม่ว่าคุณจะเลือกเส้นทางใดก็ตาม โปรดปรึกษากับลูกค้าเกี่ยวกับบทบาทและสิทธิ์ที่บัญชีของคุณควรมี เพื่อให้แอปพลิเคชันเข้าถึงข้อมูลที่ต้องการในเครือข่ายของลูกค้าได้
ตอนนี้คุณสามารถเริ่มทำการเรียก API ไปยังเครือข่าย Ad Manager ของลูกค้าได้แล้ว ตรวจสอบว่าคุณได้ตั้งค่าส่วนหัว SOAP ของ networkCode เป็นรหัสเครือข่ายของไคลเอ็นต์ที่คุณเรียกใช้ API ไลบรารีไคลเอ็นต์ทั้งหมดของเราอนุญาตให้ตั้งค่านี้โดยใช้โปรแกรม เช่น ในไลบรารีไคลเอ็นต์ Java ของโฆษณา คุณสามารถตั้งค่ารหัสเครือข่ายโดยใช้โปรแกรม เมื่อสร้างอินสแตนซ์ DfpSession
ติดตามข่าวสารล่าสุดเกี่ยวกับ API
คุณควรติดตามข่าวสารเกี่ยวกับเวอร์ชัน API ที่เลิกใช้งานหรือ หยุดให้บริการ รวมถึงวันที่เปิดตัวเวอร์ชันใหม่ คุณไม่ต้องการถูกจับได้โดยไม่ทันตั้งตัว เมื่อมีการหยุดให้บริการเวอร์ชันหนึ่งๆ และเสี่ยงต่อการทำให้ไคลเอ็นต์ของคุณใช้งานไม่ได้ เราไม่สามารถติดต่อบุคคลที่สามเกี่ยวกับการเลิกใช้งานและการหยุดให้บริการที่กำลังจะเกิดขึ้นได้เสมอเหมือนที่เราทำกับลูกค้า ดังนั้น คุณจึงมีหน้าที่รับผิดชอบในการติดตามช่องหลัก 3 ช่องของเราเพื่อรับข้อมูลอัปเดตเกี่ยวกับ API และปรับการตั้งค่าการแจ้งเตือน
นอกจากนี้ เรายังมีกำหนดการเลิกใช้งานในเว็บไซต์สำหรับนักพัฒนาซอฟต์แวร์ที่คุณควรตรวจสอบเป็นประจำ