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

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

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

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

อัปเดตการเรียก API จาก v2 เป็น v3

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

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

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

สำหรับ v3 ให้อัปเดต URL เป็น:

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

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

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

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

  • ระบบได้แทนที่ทรัพยากร 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 เพื่อยืนยันว่ามีการตั้งค่าช่องนี้ คุณจะเรียกดูข้อมูลสำหรับการเรียกเก็บเงินเริ่มต้นของพาร์ทเนอร์หลักได้ผ่านทางช่องPartnerทรัพยากร billingConfig ใหม่

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

ช่องบูลีน enableOptimizedTargeting ใหม่ได้แทนที่ช่อง targetingExpansionLevel ในออบเจ็กต์ TargetingExpansionConfig

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

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

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

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

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

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

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

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

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

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

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

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