อัปเดตล่าสุด: 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 ที่คุณมีอยู่
อัปเดตการโทรที่ดึงแหล่งข้อมูล YouTube และการกำหนดเป้าหมายที่เกี่ยวข้อง
- ระบบได้แทนที่ทรัพยากร
YoutubeAdGroup
และYoutubeAdGroupAd
ด้วยทรัพยากรAdGroup
และAdGroupAd
ทรัพยากรใหม่เหล่านี้ให้ข้อมูลแทบจะเหมือนกับทรัพยากร v2 แต่อาจใช้ชื่อช่องหรือประเภท enum ที่อัปเดต ในการผสานรวม ให้แทนที่การใช้ทรัพยากรYoutubeAdGroup
หรือYoutubeAdGroupAd
ด้วยทรัพยากรAdGroup
และAdGroupAd
และอัปเดตการเรียกบริการ v2 ต่อไปนี้ไปยังบริการ v3 ที่เกี่ยวข้องadvertisers.youtubeAdGroupAds
ไปadvertisers.adGroupAds
advertisers.youtubeAdGroups
ไปadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
ถึงadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- ระบบย้ายการอ้างอิงไปยังออบเจ็กต์
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 ออกเพื่อให้สอดคล้องกับการเลิกใช้งานฟีเจอร์ที่ผ่านมา ดังนี้
- เราได้นำบริการ
advertisers.manualTriggers
ออกแล้วเนื่องจากเลิกใช้งานทริกเกอร์ที่กำหนดเองแล้ว - ระบบนำช่อง
billableOutcome
ออกจากทรัพยากรInsertionOrder
เนื่องจากเลิกใช้งานการซื้อที่อิงตามผลลัพธ์แล้ว
การเปลี่ยนแปลงเพิ่มเติม
นอกจากการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ v3 ยังเปิดตัวฟีเจอร์ใหม่ด้วย
ดูฟีเจอร์ที่เพิ่มลงใน v3 หลังจากการเปิดตัวครั้งแรกได้ในบันทึกประจํารุ่น
การจัดการรายการสถานที่ใกล้เคียง
ในเวอร์ชัน 3 คุณสามารถจัดการรายการตำแหน่งสถานที่ใกล้เคียงได้อย่างเต็มรูปแบบ ทำให้ใช้บริการ advertisers.locationLists.assignedLocations
เพื่อสร้างและลบสถานที่ที่กำหนดให้กับทรัพยากร TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
ได้ ระบบจะระบุสถานที่ตั้งโดยใช้รหัสของทรัพยากร TARGETING_TYPE_POI
TargetingOption
เรียกข้อมูลได้โดยใช้ targetingTypes.targetingOptions.search
ความสามารถในการสร้างอัลกอริทึมการเสนอราคาที่กําหนดเองตามกฎ
ใน v3 คุณสามารถสร้างและเรียกข้อมูลอัลกอริทึมการเสนอราคาที่กำหนดเองตามกฎได้โดยใช้บริการ customBiddingAlgorithms
, media
และ customBiddingAlgorithms.rules
ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้าและพร้อมใช้งานสำหรับพาร์ทเนอร์ที่อยู่ในรายการที่อนุญาตเท่านั้น หากพาร์ทเนอร์ไม่ได้อยู่ในรายการที่อนุญาต คำขอจะแสดงข้อผิดพลาด