ย้ายข้อมูลจาก v2 ไปยัง v3

อัปเดตล่าสุด: 31-10-2023

ย้ายข้อมูลแอปพลิเคชัน

การย้ายข้อมูลจาก v2 ไปยัง v3 กำหนดให้ต้องอัปเดต URL ปลายทางเพื่อเรียกใช้ v3 และอัปเดตแอปพลิเคชันเพื่อรองรับการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง

อัปเดตการเรียก API จากเวอร์ชัน 2 เป็นเวอร์ชัน 3

หากต้องการใช้ v3 แทน v2 คุณต้องอัปเดตคำขอเพื่อใช้ปลายทาง v3 ใหม่

ตัวอย่างเช่น หากต้องการเรียกใช้เมธอด advertisers.get ด้วย v2 คุณต้องใช้ URL ต่อไปนี้

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

สําหรับ v3 ให้อัปเดต URL เป็น URL ต่อไปนี้

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

หากคุณใช้ไลบรารีของไคลเอ็นต์เพื่อส่งคำขอไปยัง API ให้ใช้ไลบรารีของไคลเอ็นต์เวอร์ชันล่าสุดและอัปเดตการกำหนดค่าให้ใช้ v3

ทำการเปลี่ยนแปลงที่จำเป็น

เราจะเปิดตัวการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการในเวอร์ชัน 3 อ่านวิธีการต่อไปนี้และทําการเปลี่ยนแปลงที่จําเป็นซึ่งเกี่ยวข้องกับการใช้งาน Display & Video 360 API ที่มีอยู่

  • เราได้แทนที่ทรัพยากร YoutubeAdGroup และ YoutubeAdGroupAd ด้วยทรัพยากร AdGroup และ AdGroupAd แหล่งข้อมูลใหม่เหล่านี้ให้ข้อมูลเกือบเหมือนกับแหล่งข้อมูล v2 แต่อาจใช้ชื่อช่องหรือประเภท Enum ที่อัปเดตแล้ว ในการผสานรวม ให้แทนที่การใช้ทรัพยากร YoutubeAdGroup หรือ YoutubeAdGroupAd ด้วยทรัพยากร AdGroup และ AdGroupAd และอัปเดตการเรียกใช้บริการ v2 ต่อไปนี้เป็นบริการ v3 ที่เกี่ยวข้อง
  • การอ้างอิงออบเจ็กต์ YoutubeAndPartnersBiddingStrategy ได้ย้ายไปยังช่อง youtubeAndPartnersBid ใหม่ภายในออบเจ็กต์ BiddingStrategy ทั่วไป ระบบได้นำช่อง biddingStrategy ออกจากออบเจ็กต์ YoutubeAndPartnersSettings แล้ว อัปเดตการผสานรวมเพื่อดึงข้อมูลกลยุทธ์การเสนอราคาสำหรับรายการโฆษณาหรือกลุ่มโฆษณา YouTube จากออบเจ็กต์ BiddingStrategy ในช่อง bidStrategy ในแหล่งข้อมูล LineItem หรือ AdGroup
  • เปลี่ยนชื่อช่อง thirdPartyMeasurementSettings เป็น thirdPartyMeasurementConfigs ในออบเจ็กต์ YoutubeAndPartnersSettings และเปลี่ยนชื่อออบเจ็กต์ YoutubeAndPartnersThirdPartyMeasurementSettings เป็น ThirdPartyMeasurementConfigs อัปเดตการผสานรวมเพื่อดึงข้อมูลการกําหนดค่าการวัดผลของบุคคลที่สามโดยใช้ช่องและออบเจ็กต์ใหม่

ระบุการกําหนดค่าการเรียกเก็บเงินที่จําเป็นเมื่อสร้างผู้ลงโฆษณา

ตอนนี้ billingConfig เป็นช่องที่ต้องกรอกในทรัพยากร Advertiser อัปเดตคำขอ advertisers.create เพื่อยืนยันว่ามีการตั้งค่าช่องนี้ คุณสามารถเรียกข้อมูลการเรียกเก็บเงินเริ่มต้นสำหรับพาร์ทเนอร์หลักผ่านช่องทรัพยากร billingConfig Partner ใหม่

ใช้ช่องใหม่เพื่อควบคุมการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ

ฟิลด์บูลีน enableOptimizedTargeting ใหม่มาแทนที่ฟิลด์ targetingExpansionLevel ในแอบเจ็กต์ TargetingExpansionConfig

อัปเดตการผสานรวมใบสั่งซื้อการใส่โฆษณาเพื่อใช้ช่อง KPI ใหม่

ช่อง kpi ใหม่มาแทนที่ช่อง performanceGoal ในทรัพยากร InsertionOrder ช่องใหม่นี้ใช้ออบเจ็กต์ Kpiแทนออบเจ็กต์ PerformanceGoal และใช้ช่องและลิสต์ค่าใหม่

นำการอ้างอิงถึงบริการและฟิลด์ที่เลิกใช้งานแล้วออก

ระบบได้นำเอนทิตีต่างๆ ออกในเวอร์ชัน 3 เพื่อให้สอดคล้องกับการเลิกใช้งานฟีเจอร์ที่ผ่านมา

การเปลี่ยนแปลงเพิ่มเติม

นอกจากการเปลี่ยนแปลงที่สำคัญที่ระบุไว้ข้างต้นแล้ว v3 ยังเปิดตัวฟีเจอร์ใหม่ๆ ด้วย

ฟีเจอร์ที่เพิ่มลงใน v3 หลังจากเปิดตัวครั้งแรกจะอยู่ในหมายเหตุการเผยแพร่

การจัดการรายการสถานที่ใกล้เคียง

ใน v3 คุณสามารถจัดการรายการสถานที่ใกล้เคียงได้อย่างเต็มที่ ซึ่งจะช่วยให้คุณใช้บริการ advertisers.locationLists.assignedLocations เพื่อสร้างและลบสถานที่ที่กำหนดให้กับทรัพยากร TARGETING_LOCATION_TYPE_PROXIMITY LocationList ได้ ระบบจะระบุสถานที่โดยใช้รหัสของทรัพยากร TARGETING_TYPE_POI TargetingOption ซึ่งจะเรียกดูได้โดยใช้ targetingTypes.targetingOptions.search

ความสามารถในการสร้างอัลกอริทึมการเสนอราคาที่กำหนดเองตามกฎ

ใน v3 คุณจะสร้างและเรียกใช้อัลกอริทึมการเสนอราคาที่กำหนดเองตามกฎได้โดยใช้บริการ customBiddingAlgorithms, media และ customBiddingAlgorithms.rules

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