InsertionOrder Data Object - การเรียกเก็บเงินของลูกค้า

ลําดับการแทรกเป็นสัญญาที่สร้างยอดเงินสูงสุดที่คุณจะจ่ายในบัญชีของคุณในช่วงเวลาที่ระบุ หากตั้งค่าการเรียกเก็บเงินสําหรับใบแจ้งหนี้รายเดือนสําหรับบัญชีของคุณ คุณจะต้องมีลําดับการแทรกโฆษณาที่ใช้งานอยู่เพื่อให้โฆษณามีสิทธิ์ในการแสดงโฆษณา คุณยังคงควบคุมค่าใช้จ่ายของคุณโดยใช้งบประมาณแคมเปญและคุณจะถูกเรียกเก็บเงินสําหรับสิ่งที่เกิดขึ้นเท่านั้น ตัวอย่างเช่น หากคุณมีคําสั่งการแทรกที่มีระยะเวลาหนึ่งเดือนในราคา $5,000 และมียอดค้างจ่ายเพียง $4,500 ในการเรียกเก็บเงินในช่วงเวลาการเรียกเก็บเงิน เราจะหักเฉพาะ $4,500 จากงบประมาณคําสั่งซื้อที่แทรกของคุณเท่านั้น

คำเตือน

งบประมาณลําดับการแทรกจะใช้กับค่าใช้จ่ายโฆษณาเท่านั้น ซึ่งเป็นความแตกต่างที่สําคัญหากธุรกิจของคุณอยู่ในประเทศ/ภูมิภาคที่บริการออนไลน์ต้องเสียภาษี หากคุณมีขีดจํากัดงบประมาณที่เข้มงวด คุณอาจจําเป็นต้องพิจารณาภาษีในงบประมาณคําสั่งซื้อที่แทรกของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับข้อกําหนดด้านภาษีในตําแหน่งที่ตั้งทางธุรกิจของคุณ โปรดดูบทความวิธีใช้ข้อมูลภาษีหรือภาษีมูลค่าเพิ่ม

องค์ประกอบส่วนใหญ่ของวัตถุนี้สามารถตั้งค่าได้เฉพาะก่อนที่ลําดับการแทรกจะได้รับการอนุมัติเท่านั้น เช่น ถ้า สถานะ ถูกตั้งค่าเป็น PendingUserReview ในกรณีดังกล่าว คุณสามารถทําการเปลี่ยนแปลงใหม่ หรืออนุมัติหรือปฏิเสธลําดับการแทรกผ่านองค์ประกอบของวัตถุนี้ได้ เมื่อสถานะลําดับการแทรกเป็น ใช้งานอยู่, หมดเวลา, หมดอายุ หรือ ไม่เริ่มต้น จากนั้นคุณสามารถทําการเปลี่ยนแปลงใหม่หรืออนุมัติ หรือปฏิเสธการเปลี่ยนแปลงที่ค้างอยู่ปัจจุบันผ่านองค์ประกอบ PendingChanges ถ้า สถานะ ลําดับการแทรกเป็น ยกเลิก หรือ ปฏิเสธ คุณจะไม่สามารถอัปเดตลําดับการแทรกได้

หมายเหตุ

การดําเนินการ SearchInsertionOrders จะส่งกลับลําดับการแทรกสูงสุด 24 ลําดับต่อชุดข้อมูลที่เป็นกิจวัตร

คุณสามารถดึงข้อมูลได้ แต่มีข้อยกเว้นน้อยมากที่ไม่สามารถเพิ่มหรืออัปเดตชุดลําดับการแทรกผ่าน Bing Ads API ได้ ใช้องค์ประกอบ IsInSeries เพื่อกําหนดว่าลําดับการแทรกอยู่ในชุดข้อมูลที่เป็นกิจวัตรหรือไม่

• ถ้าคุณพยายามที่จะอัปเดต StartDate หรือ EndDate ของลําดับการแทรกที่เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา API จะส่งกลับข้อผิดพลาด
• ถ้าคุณอัปเดต สถานะของ ลําดับการแทรกที่เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา

เมื่อต้องการจัดการลําดับการแทรกที่เกิดซ้ําในแอปพลิเคชันบนเว็บ Microsoft Advertising ให้ดูบทความ How do I สร้างและแก้ไขลําดับการแทรกหรือไม่

ไวยากรณ์

<xs:complexType name="InsertionOrder" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AccountId" type="xs:long" />
    <xs:element minOccurs="0" name="BookingCountryCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Comment" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="NotificationThreshold" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ReferenceId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="SpendCapAmount" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:InsertionOrderStatus" />
    <xs:element minOccurs="0" name="PurchaseOrder" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PendingChanges" nillable="true" type="tns:InsertionOrderPendingChanges" />
    <xs:element minOccurs="0" name="AccountNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="BudgetRemaining" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetRemainingPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpentPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="SeriesName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsInSeries" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="SeriesFrequencyType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsUnlimited" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="IsEndless" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุ InsertionOrder มีองค์ประกอบต่อไปนี้: AccountId, AccountNumber, BookingCountryCode, BudgetRemaining, BudgetRemainingPercent, BudgetSpent, BudgetSpentPercent, Comment, EndDate, Id, IsEndless, IsInSeries, IsUnlimited, LastModifiedByUserId, LastModifiedTime, Name, NotificationThreshold, PendingChanges, PurchaseOrder, ReferenceId, SeriesFrequencyType, SeriesName, SpendCapAmount, StartDate, Status

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AccountId	ตัวระบุของบัญชีที่นําลําดับการแทรกไปใช้ คุณไม่สามารถอัปเดตตัวระบุบัญชีหลังจากที่คุณสร้างลําดับการแทรก เพิ่ม: ต้องระบุ ปรับ ปรุง: อ่านอย่างเดียว	ยาว
หมายเลขบัญชี	หมายเลขบัญชีที่ระบบสร้างขึ้นซึ่งใช้เพื่อระบุบัญชีในแอปพลิเคชันบนเว็บ Microsoft Advertising หมายเลขบัญชีมีรูปแบบ xxxxxxxxx โดย ที่ xxxxxxxxx คือชุดของอักขระพยัญชนะผสมตัวเลขแปดตัว เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	สาย อักขระ
BookingCountryCode	สงวนไว้สําหรับการใช้ภายใน เพิ่ม: จําเป็นสําหรับบางบัญชี ไม่บังคับสําหรับบางบัญชีผู้ใช้ ปรับ ปรุง: อ่านอย่างเดียว	สาย อักขระ
การกําหนดงบประมาณใหม่	ยอดดุลสะสมของลําดับการแทรก ในตอนแรกค่ายอดคงเหลือสะสมจะเหมือนกับ SpendCapAmount จากนั้นจะลดลงในแต่ละครั้งที่มีการแสดงโฆษณาในบัญชี องค์ประกอบนี้จะว่างเปล่าถ้าลําดับการแทรกมีงบประมาณไม่จํากัด เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	คู่
BudgetRemainingPercent	เปอร์เซ็นต์ของงบประมาณคงเหลือสําหรับใบสั่งการแทรก ค่านี้ถูกคํานวณเป็น BudgetRemaining / SpendCapAmount องค์ประกอบนี้จะว่างเปล่าถ้าลําดับการแทรกมีงบประมาณไม่จํากัด เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	คู่
งบประมาณที่ใช้ไป	ยอดดุลที่เหลือของลําดับการแทรก ยอดคงเหลือที่เหลืออยู่เริ่มต้นเป็น 0 (ศูนย์) จากนั้นจะเพิ่มขึ้นไปยัง SpendCapAmount ทุกครั้งที่แสดงโฆษณาในบัญชี องค์ประกอบนี้จะว่างเปล่าถ้าลําดับการแทรกมีงบประมาณไม่จํากัด เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	คู่
BudgetSpentPercent	เปอร์เซ็นต์ของงบประมาณที่ใช้สําหรับลําดับการแทรก ค่านี้ถูกคํานวณเป็นBudgetSpentCapAmount / องค์ประกอบนี้จะว่างเปล่าถ้าลําดับการแทรกมีงบประมาณไม่จํากัด เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	คู่
ข้อคิดเห็น	คําอธิบายของลําดับการแทรก คําอธิบายจะถูกจํากัดไว้ที่ 100 อักขระ เพิ่ม: เสริม ปรับ ปรุง: เสริม	สาย อักขระ
วันที่สิ้นสุด	วันที่ที่ใบสั่งการแทรกหมดอายุ วันที่สิ้นสุดต้องอยู่หลังจากวันที่เริ่มต้น วันที่จะถูกจัดเก็บไว้ในเวลามาตรฐานสากล (UTC) ใช้เฉพาะเดือน วัน และปีของสตริงที่ระบุเท่านั้น ถ้าคุณระบุชั่วโมง นาที และวินาทีของวันที่ จะถูกละเว้น สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML หมายเหตุ: ถ้าลําดับการแทรกไม่มีวันที่สิ้นสุด วันที่สิ้นสุด จะว่างเปล่า การเพิ่มหรือการอัปเดตลําดับการแทรกแบบไม่จํากัดไม่ได้รับการสนับสนุน EndDate ทํางานในโหมดอ่านอย่างเดียว เพิ่ม: ต้องระบุ ปรับ ปรุง: เสริม ถ้าคุณพยายามที่จะอัปเดต StartDate หรือ EndDate ของลําดับการแทรกที่ เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา API จะส่งกลับข้อผิดพลาด	Datetime
Id	ตัวระบุที่ระบบสร้างขึ้นซึ่งระบุลําดับการแทรก เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียวและจําเป็น	ยาว
IsEndless	กําหนดว่าลําดับการแทรกไม่มีวันที่สิ้นสุดหรือไม่ ถ้า ค่าเป็นจริง ลําดับการแทรกจะไม่มีวันที่สิ้นสุด และ วันที่สิ้นสุด ของลําดับการแทรกนี้จะถูกละเว้น เพิ่ม: เสริม ปรับ ปรุง: เสริม	บูลีน
IsInSeries	กําหนดว่าลําดับการแทรกอยู่ในชุดข้อมูลที่เกิดซ้ําหรือไม่ ถ้าค่าเป็นจริง ลําดับการแทรกจะเป็นส่วนหนึ่งของชุดข้อมูลที่เป็นกิจวัตร ถ้าคุณพยายามที่จะอัปเดต StartDate หรือ EndDate ของลําดับการแทรกที่เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา API จะส่งกลับข้อผิดพลาด ถ้าคุณอัปเดต สถานะของ ลําดับการแทรกที่เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	บูลีน
IsUnlimited	กําหนดว่าใบสั่งการแทรกมีงบประมาณที่ไม่จํากัดหรือไม่ ถ้า ค่าเป็นจริง ลําดับการแทรกจะมีงบประมาณไม่จํากัด และ SpendCapAmount ของลําดับการแทรกนี้จะถูกละเว้น เพิ่ม: เสริม ปรับ ปรุง: เสริม	บูลีน
LastModifiedByUserId	ตัวระบุของผู้ใช้คนล่าสุดที่จะอัปเดตลําดับการแทรก เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	ยาว
LastModifiedTime	วันที่และเวลาที่อัปเดตลําดับการแทรกครั้งล่าสุด วันที่จะถูกจัดเก็บไว้ในเวลามาตรฐานสากล (UTC) สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	Datetime
ชื่อ	ชื่อที่เรียกง่ายที่สามารถใช้อ้างอิงลําดับการแทรกนี้ได้ ชื่อสามารถมีอักขระได้สูงสุด 100 อักขระ ชื่อนี้ไม่จําเป็นต้องไม่ซ้ํากันเมื่อเปรียบเทียบกับใบสั่งการแทรกอื่นๆ สําหรับลูกค้า เพิ่ม: เสริม ปรับ ปรุง: เสริม	สาย อักขระ
ค่าเกณฑ์การแจ้งเตือน	เปอร์เซ็นต์ของงบประมาณที่ใช้ไป ระบุเปอร์เซ็นต์เป็นค่าตั้งแต่ 0 ถึง 100 การแจ้งเตือนจะถูกส่งเมื่อถึงขีดจํากัด ตัวอย่างเช่น หากคุณตั้งค่าเกณฑ์เป็น 70 บริการการเรียกเก็บเงินจะส่งการแจ้งเตือนเมื่อคุณใช้งบประมาณ 70 เปอร์เซ็นต์ ถ้าคุณไม่ต้องการรับการแจ้งเตือน ให้ตั้งค่าเป็น NULL สงวนไว้สําหรับการใช้ภายใน เพิ่ม: เสริม ปรับ ปรุง: เสริม	คู่
คําสั่งที่ค้างอยู่	สามารถใช้เพื่อจัดการการเปลี่ยนแปลงสําหรับใบสั่งการแทรกที่ได้รับการอนุมัติซึ่งมีการตั้งค่าสถานะเป็น ใช้งานอยู่, หมดแล้ว, หมดอายุ แล้ว หรือ ยังไม่เริ่มต้น เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: เสริม	InsertionOrderPendingChanges
PurchaseOrder	ค่าใบสั่งซื้อที่สามารถใช้เพื่ออ้างอิงใบสั่งการแทรกนี้ในใบแจ้งหนี้รายเดือน ค่านี้จะถูกพิมพ์เป็นใบสั่งซื้อในใบแจ้งหนี้รายเดือน ใบสั่งซื้อสามารถมีอักขระได้สูงสุด 50 อักขระ เพิ่ม: เสริม ปรับ ปรุง: เสริม	สาย อักขระ
ReferenceId	สงวนไว้สําหรับการใช้ภายในเท่านั้น เพิ่ม: เสริม ปรับ ปรุง: เสริม	ยาว
SeriesFrequencyType	กําหนดวิธีที่ลําดับจะเกิดซ้ําในชุดข้อมูล ค่าที่เป็นไปได้คือ รายเดือน, BiMonthly, Quarterly และ Yearly เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	สาย อักขระ
SeriesName	ชื่อของชุดลําดับการแทรกที่เกิดซ้ํา ชื่อสามารถมีอักขระได้สูงสุด 100 อักขระ แม้ว่าลําดับการแทรกจะถูกเอาออกจากชุดข้อมูลที่เป็นกิจวัตรในภายหลัง แต่องค์ประกอบนี้จะยังคงแสดงชื่อของชุดข้อมูลที่สร้างขึ้น เพิ่ม: อ่านอย่างเดียว ปรับ ปรุง: อ่านอย่างเดียว	สาย อักขระ
SpendCapAmount	งบประมาณสําหรับลําดับการแทรกนี้ งบประมาณเป็นขีดจํากัดตายตัว เมื่อบัญชีถึงขีดจํากัดนี้และไม่มีลําดับการแทรกอื่นที่พร้อมใช้งาน ค่าสถานะวงจรการใช้งานของบัญชีจะถูกตั้งค่าเป็น หยุดชั่วคราว องค์ประกอบนี้จะว่างเปล่าถ้าลําดับการแทรกมีงบประมาณไม่จํากัด งบประมาณคือจํานวนเงินสูงสุดที่คุณต้องการใช้สําหรับคําสั่งการแทรก สําหรับคําสั่งแทรกที่มีงบประมาณไม่ จํากัด งบประมาณของคุณจะถูกผูกไว้ตามวงเงินสินเชื่อของคุณ ในกรณีดังกล่าว งบประมาณรายวันของแต่ละแคมเปญจะกําหนดค่าใช้จ่ายสูงสุด หมายเหตุ: การเพิ่มหรือการอัปเดตลําดับการแทรกแบบไม่จํากัดไม่ได้รับการสนับสนุน SpendCapAmount ทํางานในโหมดอ่านอย่างเดียว เพิ่ม: ต้องระบุ ปรับ ปรุง: เสริม	คู่
วันที่เริ่มต้น	วันที่ที่ใบสั่งการแทรกสามารถเริ่มต้นค่าธรรมเนียมการค้างรับค้างจ่ายได้ วันที่เริ่มต้องอยู่หลังจากวันที่ปัจจุบัน วันที่จะถูกจัดเก็บไว้ในเวลามาตรฐานสากล (UTC) ใช้เฉพาะเดือน วัน และปีของสตริงที่ระบุเท่านั้น ถ้าคุณระบุชั่วโมง นาที และวินาทีของวันที่ จะถูกละเว้น สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML เพิ่ม: ต้องระบุ ปรับ ปรุง: เสริม คุณสามารถอัปเดตวันที่เริ่มต้นผ่านองค์ประกอบนี้ได้เท่านั้นถ้า Status คือ PendingUserReview ถ้าวันที่เริ่มต้นผ่านไปแล้ว คุณจะไม่สามารถเปลี่ยนแปลงได้ ถ้าคุณพยายามที่จะอัปเดต StartDate หรือ EndDate ของลําดับการแทรกที่ เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา API จะส่งกลับข้อผิดพลาด	Datetime
สถานะ	สถานะของใบสั่งการแทรก เพิ่ม: อ่านอย่างเดียว ลําดับการแทรกที่คุณสร้างจะถูกตั้งค่าเป็น ใช้งานอยู่, ไม่เริ่มต้น หรือ ปฏิเสธ ทันที ปรับ ปรุง: จําเป็นในการอนุมัติหรือปฏิเสธลําดับการแทรกที่ยังไม่ได้รับอนุมัติ หรือยกเลิกลําดับการแทรกที่ได้รับการอนุมัติแล้ว คุณสามารถอนุมัติหรือปฏิเสธผ่านองค์ประกอบนี้ได้เท่านั้นถ้าสถานะปัจจุบันถูกตั้งค่าเป็น PendingUserReview คุณสามารถยกเลิกได้ผ่านทางองค์ประกอบนี้เท่านั้นถ้าสถานะปัจจุบันถูกตั้งค่าเป็น ใช้งานอยู่, หมดแรง หรือ ไม่เริ่มต้น เมื่อสถานะลําดับการแทรกเป็น ใช้งานอยู่, หมดเวลา, หมดอายุ หรือ ไม่เริ่มต้น จากนั้นคุณสามารถทําการเปลี่ยนแปลงใหม่หรืออนุมัติ หรือปฏิเสธการเปลี่ยนแปลงที่ค้างอยู่ปัจจุบันผ่านองค์ประกอบ PendingChanges เมื่อคุณเรียก UpdateInsertionOrder คุณสามารถตั้งค่าองค์ประกอบสถานะนี้ หรือปรับเปลี่ยนองค์ประกอบอื่นของวัตถุนี้ได้ แต่คุณไม่สามารถเปลี่ยนสถานะควบคู่ไปกับการอัปเดตคุณสมบัติอื่นๆ ได้ ถ้าคุณอัปเดตสถานะของลําดับการแทรกที่เป็นส่วนหนึ่งของชุดที่เกิดซ้ํา	InsertionOrderStatus

ข้อกําหนด

บริการ: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

ใช้โดย

AddInsertionOrder
SearchInsertionOrders
UpdateInsertionOrder