คู่มือนี้เป็นภาพรวมระดับสูงเกี่ยวกับวิธีใช้ฟีเจอร์โปรแกรมการขายโดยตรงผ่าน API โดยจะอธิบายวิธีสร้างข้อเสนอและวิธีเจรจาต่อรอง
Primer
ข้อเสนอแบบเป็นโปรแกรมคล้ายกับคำสั่งซื้อใน Google Ad Manager ข้อเสนอแบบเป็นโปรแกรม มีข้อมูลกว้างๆ เกี่ยวกับธุรกรรมที่เสนอระหว่างคุณกับผู้ซื้อ ข้อเสนอและรายการโฆษณาของข้อเสนอแสดงถึงข้อเสนอพื้นที่โฆษณาต่อผู้ซื้อ
ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือ
การสร้างข้อเสนอผ่าน API
หากต้องการสร้างออบเจ็กต์ Proposal คุณต้องระบุชื่อและผู้ซื้อแบบเป็นโปรแกรมเท่านั้น
คุณจะดูรหัสผู้ซื้อแบบเป็นโปรแกรมได้ผ่าน UI หรือ
ตาราง PQL ของ Programmatic_Buyer
Java
Proposal proposal = new Proposal(); // Setting required Marketplace information. ProposalMarketplaceInfo proposalMarketplaceInfo = new ProposalMarketplaceInfo(); proposalMarketplaceInfo.setBuyerAccountId(programmaticBuyerId); // Set common required fields for a proposal. proposal.setName("Proposal #" + new Random().nextInt(Integer.MAX_VALUE)); proposal.setPrimaryTraffickerId(primaryTraffickerId); proposal.setMarketplaceInfo(proposalMarketplaceInfo);
Python
proposal = { # Setting required Marketplace information. 'isProgrammatic': 'true', 'marketplaceInfo': { 'buyerAccountId': programmatic_buyer_id, }, # Set common required fields for proposals. 'name': 'Proposal #%s' % uuid.uuid4(), # ... }
PHP
$proposal = new Proposal(); $proposal->setName('Proposal #' . uniqid()); // Set the required Marketplace information. $proposalMarketplaceInfo = new ProposalMarketplaceInfo(); $proposalMarketplaceInfo->setBuyerAccountId($buyerId); $proposal->setMarketplaceInfo($proposalMarketplaceInfo);
C#
// Create a proposal with the minimum required fields. Proposal proposal = new Proposal() { name = "Programmatic proposal #" + new Random().Next(int.MaxValue), // Set required Marketplace information marketplaceInfo = new ProposalMarketplaceInfo() { buyerAccountId = programmaticBuyerId } };
Ruby
# Create proposal configuration object. proposal = { :marketplace_info => { :buyer_account_id => buyer_id }, :name => 'Proposal %s' % SecureRandom.uuid(), # ... }
ก่อนส่งให้ผู้ซื้อเจรจา คุณจะต้องตั้งค่าช่องเพิ่มเติม ข้อเสนอต้องมีผู้ลงโฆษณา พนักงานขาย ผู้ดูแลการแสดงโฆษณา และรายชื่อติดต่อของผู้ขาย
Java
SalespersonSplit primarySalesperson = new SalespersonSplit(); primarySalesperson.setUserId(primarySalespersonId); proposal.setPrimarySalesperson(primarySalesperson);
Python
'primarySalesperson': { 'userId': primary_salesperson_id, }, 'primaryTraffickerId': primary_trafficker_id, 'probabilityOfClose': '100000',
PHP
// Create salesperson splits for the primary salesperson. $primarySalesperson = new SalespersonSplit(); $primarySalesperson->setUserId($primarySalespersonId); $proposal->setPrimarySalesperson($primarySalesperson); // Set the primary trafficker on the proposal for when it becomes an // order. $proposal->setPrimaryTraffickerId($primaryTraffickerId); $advertiser = new ProposalCompanyAssociation(); $advertiser->setType( ProposalCompanyAssociationType::ADVERTISER ); $advertiser->setCompanyId($advertiserId); $proposal->setAdvertiser($advertiser);
C#
// Set fields that are required before sending the proposal to the buyer. proposal.primaryTraffickerId = primaryTraffickerId; proposal.sellerContactIds = new long[] { primarySalespersonId }; proposal.primarySalesperson = new SalespersonSplit() { userId = primarySalespersonId, }; proposal.advertiser = new ProposalCompanyAssociation() { type = ProposalCompanyAssociationType.ADVERTISER, companyId = advertiserId };
Ruby
:primary_salesperson => { :user_id => primary_salesperson_id }, :primary_trafficker_id => primary_trafficker_id
เนื่องจากโดยทั่วไปแล้วข้อเสนอประกอบด้วยออบเจ็กต์ ProposalLineItem ขั้นตอนถัดไปคือการเพิ่มรายการโฆษณาข้อเสนอภายใต้ข้อเสนอที่สร้างขึ้นใหม่
สถานะของข้อเสนอแบบเป็นโปรแกรม
รูปภาพต่อไปนี้แสดงข้อเสนอแบบเป็นโปรแกรมในจุดต่างๆ ระหว่าง กระบวนการต่อรองจากมุมมองของ API แต่ละรัฐจะแสดงด้วย การผสมผสานฟิลด์ต่อไปนี้ในรูปแบบต่างๆ
- ProposalMarketplaceInfo.hasLocalVersionEdits
- ProposalMarketplaceInfo.negotiationStatus
- Proposal.status
ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ Ad Manager
คำแนะนำแบบทีละขั้นในการเจรจาต่อรอง
ในส่วนนี้ เราจะแนะนำวิธีใช้ API เพื่อเจรจาต่อรองข้อเสนอแบบเป็นโปรแกรมกับผู้ซื้อให้เสร็จสมบูรณ์ เราจะอ้างอิงสถานะในแผนภาพ ด้านบน
เตรียมการตรวจสอบหรือการยอมรับของผู้ซื้อ
ก่อนอื่นคุณต้องร่างข้อเสนอแบบเป็นโปรแกรมที่มีรายการโฆษณาข้อเสนอที่คุณต้องการส่งให้ผู้ซื้อ ซึ่งก็คือ state C ในรูปด้านบน
ขอการตรวจสอบหรือการยอมรับจากผู้ซื้อ
เมื่อพร้อมให้ผู้ซื้อตรวจสอบข้อเสนอแบบเป็นโปรแกรมแล้ว คุณจะRequestBuyerReview หรือ RequestBuyerAcceptance ได้โดยใช้เมธอด ProposalService.performProposalAction
ซึ่งจะนำคุณเข้าสู่ระยะการเจรจา
การเจรจา
ในขั้นตอนนี้ อาจเกิดสิ่งต่างๆ ขึ้นดังนี้
- ผู้ซื้ออาจยอมรับข้อเสนอแบบเป็นโปรแกรมโดยไม่มีการเปลี่ยนแปลง
- ผู้ซื้ออาจเสนอการเปลี่ยนแปลง ในกรณีนี้ ระบบจะส่งข้อเสนอคืน
ไปยังสถานะร่าง (
state Bในรูปที่ 1) จากนั้นคุณจะต้อง เปิดข้อเสนอเพื่อแก้ไข ทำการเปลี่ยนแปลงที่เสนอ และส่งกลับไปให้ผู้ซื้อตรวจสอบ - นอกจากนี้ คุณยังเลือกที่จะทำการเปลี่ยนแปลงได้แม้ว่าผู้ซื้อจะยังไม่ได้ตอบกลับก็ตาม คุณทำได้โดยเปิดข้อเสนอเพื่อแก้ไขจาก
state Dในรูปที่ 1
การเจรจาต่อรองนี้จะดำเนินต่อไปจนกว่าคุณจะบรรลุข้อตกลงกับผู้ซื้อ คุณสามารถดึงข้อมูลความคิดเห็น
ระหว่างคุณกับผู้ซื้อได้โดยใช้
getMarketplaceCommentsByStatement
คุณส่งความคิดเห็นถึงผู้ซื้อได้ขณะอยู่ใน state A หากต้องการดำเนินการนี้ คุณจะต้องอัปเดตฟิลด์ marketplaceComment ในข้อเสนอโดยใช้ updateProposals
จากนั้นระบบจะส่งความคิดเห็นเมื่อคุณขอให้ผู้ซื้อยอมรับ
สรุปผลแล้ว
เมื่อทั้งคุณและผู้ซื้อยอมรับข้อเสนอแบบเป็นโปรแกรมแล้ว ข้อเสนอจะเข้าสู่สถานะสรุป (state F ในรูปที่ 1)
จากนั้น Ad Manager จะสร้างรายการโฆษณาจากข้อเสนอแบบเป็นโปรแกรมนี้โดยอัตโนมัติ
ในกรณีส่วนใหญ่ คุณจะดำเนินการกับข้อเสนอแบบเป็นโปรแกรมเสร็จแล้ว แต่คุณสามารถดำเนินการ 2 อย่างได้จากสถานะนี้
- คุณสามารถเปิดข้อเสนอแบบเป็นโปรแกรมอีกครั้งเพื่อเจรจาต่อรองใหม่ได้โดยการแก้ไข
ฟิลด์ที่เกี่ยวข้องกับการแสดงผลในข้อเสนอ คุณทำได้โดยเปิดข้อเสนอเพื่อแก้ไข (
state E to Aในรูปที่ 1) ทำการเปลี่ยนแปลง แล้ว ขอการยอมรับจากผู้ซื้อ - คุณสามารถทำการแก้ไขที่ไม่เกี่ยวข้องกับการแสดงโฆษณา เช่น อัปเดตชื่อข้อเสนอ และแสดงการเปลี่ยนแปลงเหล่านี้ในคำสั่งซื้อและรายการโฆษณา Ad Manager ที่สร้างจากดีลนี้ โดยคุณจะทำได้ด้วยการแก้ไขจาก
state Eในรูปที่ 1 แล้วดำเนินการUpdateOrderWithSellerData