การส่งฟีดราคาไปยัง Microsoft Advertising

ก่อนส่งฟีดราคา:

• ตรวจสอบข้อความเพื่อให้แน่ใจว่าสอดคล้องกับ Transaction XSD ซึ่งจะช่วยให้คุณประหยัดไปกลับและเวลาที่ต้องแก้ไขข้อผิดพลาด

• ตรวจสอบให้แน่ใจว่าข้อความมีข้อมูลที่ไม่บีบอัดน้อยกว่า 100 MB หรือข้อมูลบีบอัด 10 MB (โดยใช้การบีบอัด GZip) เพื่อลดปริมาณการใช้งานเครือข่าย คุณควรส่งข้อมูลที่ถูกบีบอัดเสมอ

• ตรวจสอบให้แน่ใจว่าคุณมีการร้องขอน้อยกว่าห้ารายการที่จัดคิวหรือกําลังประมวลผลอยู่ แอปพลิเคชันของคุณควรมีตรรกะที่จําเป็นเพื่อให้อยู่ภายในขีดจํากัด หากคุณเกินขีดจํากัด คําขอจะล้มเหลวด้วยรหัสสถานะ HTTP 429

หลังจากตรวจสอบข้อความแล้ว ให้ส่งไปยัง Microsoft ในเนื้อความของคําขอ HTTPS POST URL ที่คุณส่งคําขอไปคือ:

https://hotels.api.bingads.microsoft.com/api/customers/<customerId>/transactions

ตั้งค่า <customerId> เป็น ID ลูกค้าของผู้ลงโฆษณา

คําขอต้องมีส่วนหัวต่อไปนี้:

• Content-Type: application/xml; charset=utf-8
• การอนุญาต: Bearer <accesstokengoeshere>

คุณยังสามารถระบุส่วนหัวที่เลือกได้ต่อไปนี้:

• การเข้ารหัสเนื้อหา: gzip
  ระบุส่วนหัวนี้ถ้าคุณบีบอัดตัวดึงข้อมูลราคา (แนะนํา)

• X-Transaction-ID: <ID ที่ผู้ใช้กําหนดเอง>
  ID ที่ผู้ใช้กําหนดเองแบบทึบแสงที่ผู้ลงโฆษณาใช้เพื่อระบุข้อความโดยไม่ซ้ํากัน ถ้าคุณรวมส่วนหัวนี้ ID ต้องตรงกับ ID ในแอตทริบิวต์ของidองค์ประกอบ Transaction

ต่อไปนี้แสดงตัวอย่างคําขอ POST

POST https://hotels.api.bingads.microsoft.com/api/customers/abc123/transactions HTTP/1.1
Content-Type: application/xml; charset=utf-8
Host: hotels.api.bingads.microsoft.com

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

คําขอ POST จะวางข้อความในคิวที่จะประมวลผล แล้วส่งกลับ คุณอาจมีการร้องขอสูงสุดห้ารายการที่จัดคิวหรือกําลังประมวลผลในเวลาเดียวกัน หากคุณเกินขีดจํากัด คําขอจะล้มเหลวด้วย 429

หากต้องการตรวจสอบว่า Microsoft ประมวลผลข้อความได้สําเร็จหรือไม่ ให้ดู สถานะตัวดึงข้อมูลโฆษณาราคาโรงแรม ในแอปพลิเคชันบนเว็บ Microsoft Hotel Center of Microsoft Advertising

ถ้าการร้องขอสําเร็จ (ข้อความถูกวางลงในคิวเรียบร้อยแล้ว) เนื้อความของการตอบสนองจะรวมเอกสาร XML ที่ระบุจํานวนไบต์ที่อ่าน (BytesReceived) จากเนื้อความของคําขอ (ตัวดึงข้อมูลราคา)

<TxnResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Microsoft.BingAds.BHAC.HotelAdsAPIs.Models">
  <BytesReceived>184381</BytesReceived>
  <FeedId>6165579</FeedId>
</TxnResponse>

องค์ประกอบ FeedId ประกอบด้วย ID ที่ Microsoft สร้างขึ้นซึ่งระบุตัวดึงข้อมูลโดยไม่ซ้ํากัน รายงานสถานะธุรกรรมประกอบด้วย ID นี้

ถ้าการร้องขอล้มเหลว เนื้อความการตอบสนองจะรวมเอกสาร XML ที่ประกอบด้วยรายการของรหัสข้อผิดพลาดและข้อความที่ระบุสาเหตุที่การร้องขอล้มเหลว สําหรับรายการรหัสข้อผิดพลาดและข้อความ ให้ดู รหัสข้อผิดพลาดและข้อความ

การตอบสนองรวมถึงส่วนหัวการตอบสนอง WebRequestActivityId ส่วนหัวมี ID ที่เชื่อมโยงกับคําขอในไฟล์บันทึก เมื่อใดก็ตามที่คําขอล้มเหลว ให้จับภาพ ID หากคุณไม่สามารถแก้ไขปัญหาได้ ให้ระบุ ID นี้เมื่อคุณติดต่อฝ่ายสนับสนุน

ฉันต้องใช้ความถี่ในการส่งข้อความเท่าใด

ส่งฟีดราคาเมื่อใดก็ตามที่มีการเปลี่ยนแปลงราคาและจํานวนห้องว่างที่เปิดให้จอง