บุคคลที่สามไม่ใช่ผู้ใช้ 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 ของ Google Ads คุณสามารถตั้งค่ารหัสเครือข่ายแบบเป็นโปรแกรมเมื่อสร้างอินสแตนซ์ DfpSession
ติดตามข่าวสารล่าสุดเกี่ยวกับ API
คุณควรติดตามข้อมูลล่าสุดเกี่ยวกับเวอร์ชัน API ที่เลิกใช้งานหรือหยุดให้บริการ และวันที่เผยแพร่เวอร์ชันใหม่ คุณคงไม่อยากตั้งตัวไม่ทันเมื่อมีการเลิกใช้งานเวอร์ชันหนึ่งๆ และเสี่ยงที่จะทำให้ไคลเอ็นต์ของคุณใช้งานไม่ได้ เราไม่สามารถติดต่อบุคคลที่สามเกี่ยวกับการเลิกใช้งานและการหยุดให้บริการที่กำลังจะเกิดขึ้นได้เสมอไปเหมือนที่เราทำกับลูกค้า ดังนั้น คุณจึงมีหน้าที่รับผิดชอบในการติดตามช่องทางหลัก 3 ช่องทางของเราเพื่อรับข้อมูลอัปเดตเกี่ยวกับ API และปรับการตั้งค่าการแจ้งเตือน ดังนี้
นอกจากนี้ เรายังมีกำหนดการเลิกใช้งานในเว็บไซต์ของนักพัฒนาซอฟต์แวร์ที่คุณควรตรวจสอบเป็นประจำ