แชร์ผ่าน

เริ่มต้นใช้งาน PHP ด้วย Bing Ads API

  • บทความ

ในการเริ่มต้นพัฒนาแอปพลิเคชัน Bing Ads API ด้วย PHP คุณสามารถเริ่มต้นด้วยตัวอย่างที่ให้มาหรือทําตามคําแนะนําแอปพลิเคชันสําหรับเว็บหรือเดสก์ท็อป ตัวอย่างได้รับการพัฒนาด้วย Bing Ads PHP SDK และทํางานกับ PHP 7.0.6 คุณควรสามารถใช้ PHP รุ่นอื่น ๆ (มากกว่า 5.6) แพคเกจ และระบบปฏิบัติการได้ อย่างไรก็ตาม บางส่วนของรหัสและการกําหนดค่าอาจต้องเปลี่ยนแปลง สําหรับข้อมูลเกี่ยวกับวิธีการตั้งค่าสภาพแวดล้อมการพัฒนา PHP เพื่อใช้บริการเว็บ ให้ดูเอกสารประกอบสําหรับเครื่องมือของคุณ ส่วนขยาย SOAP และ OpenSSL ควรเปิดใช้งานในไฟล์ PHP.ini ด้วย เปิดใช้งานส่วนขยาย curl เพื่อเรียกใช้ตัวอย่างการอัปโหลดจํานวนมาก

extension=php_soap.dll
extension=php_openssl.dll
extension=php_curl.dll

คุณจะต้องมีข้อมูลประจําตัวผู้ใช้ที่มีสิทธิ์เข้าถึง Microsoft Advertising ทั้งในการผลิตหรือ Sandbox สําหรับสภาพแวดล้อมการผลิต คุณจะต้องมีโทเค็นนักพัฒนาผลิต ไคลเอ็นต์ Sandbox ทั้งหมดสามารถใช้โทเค็นนักพัฒนา Sandbox สากลได้ เช่น BBD37VB98 สําหรับข้อมูลเพิ่มเติม โปรดดูเริ่มต้นใช้งาน API โฆษณา Bing และ Sandbox

หากต้องการรับรองความถูกต้องผ่าน OAuth คุณต้องลงทะเบียนแอปพลิเคชันและรับตัวระบุไคลเอ็นต์ที่สอดคล้องกัน คุณยังต้องจดบันทึกข้อมูลลับของไคลเอ็นต์และเปลี่ยนเส้นทาง URI ถ้าคุณกําลังพัฒนาแอปพลิเคชันบนเว็บ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการลงทะเบียนแอปพลิเคชันในการผลิตและขั้นตอนการให้รหัสการให้สิทธิ์ โปรดดูการรับรองความถูกต้องด้วย OAuth และการรับรองความถูกต้องด้วย SDK แม้ว่าในการผลิตคุณต้องใช้ ID แอปพลิเคชันของคุณเอง (a.k.a. client ID) ลูกค้า Microsoft Advertising ทั้งหมดสามารถใช้ ID ไคลเอ็นต์ "แอปตัวอย่างบทช่วยสอน" สาธารณะใน Sandbox เช่น 4c0b021c-00c3-4508-838f-d3127e8167ff สําหรับข้อมูลเพิ่มเติม โปรดดู Sandbox

ติดตั้ง SDK

คุณสามารถติดตั้ง Bing Ads PHP SDK โดยใช้ตัวจัดการแพคเกจ ผู้แต่ง เพื่อดึงข้อมูลจาก Packagist หรือคุณสามารถโคลนแหล่งที่มาจาก GitHub ได้ คู่มือนี้อธิบายวิธีที่คุณสามารถใช้ผู้แต่งเพื่อรับ Bing Ads SDK เวอร์ชันล่าสุด

  1. ดาวน์โหลดและติดตั้งผู้แต่ง ผู้ใช้ Microsoft Windows ควรเพิ่ม composer.phar ลงในตัวแปร PATH ของคุณ

  2. เปิดพร้อมท์คําสั่งและพิมพ์composer require microsoft/bingads

    หมายเหตุ

    ผู้ใช้ Windows ที่ไม่ได้เพิ่ม composer.phar ลงใน PATH จะต้องพิมพ์ php composer.phar require microsoft/bingads แทน

  3. เมื่อต้องการรับการอัปเดตไปข้างหน้า ให้พิมพ์composer update หากมีการอัปเดตใดๆ ที่ packagist ผู้แต่งจะติดตั้งเวอร์ชันล่าสุด

การฝึกปฏิบัติ

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

การใช้ SoapVar

เมื่อต้องการส่งชนิดที่ซับซ้อนที่สืบทอดมาจากคลาสฐาน คุณต้องเข้ารหัสวัตถุเป็น SoapVar ในตัวอย่างต่อไปนี้ BiddableCampaignCriterion (มาจาก CampaignCriterion), LocationCriterion (มาจากเกณฑ์) และ BidMultiplier (ที่มาจาก CriterionBid) จะถูกเข้ารหัสทั้งหมด

$campaignCriterions = array();

$locationBiddableCampaignCriterion = new BiddableCampaignCriterion();
$locationBiddableCampaignCriterion->CampaignId = $campaignId;
$locationCriterion = new LocationCriterion();
$locationCriterion->LocationId = 190;
$encodedLocationCriterion = new SoapVar($locationCriterion, SOAP_ENC_OBJECT, 'LocationCriterion', $GLOBALS['CampaignProxy']->GetNamespace());
$locationBiddableCampaignCriterion->Criterion = $encodedLocationCriterion;
$bidMultiplier = new BidMultiplier();
$bidMultiplier->Multiplier = 0;
$encodedBidMultiplier = new SoapVar($bidMultiplier, SOAP_ENC_OBJECT, 'BidMultiplier', $GLOBALS['CampaignProxy']->GetNamespace());
$locationBiddableCampaignCriterion->CriterionBid = $encodedBidMultiplier;

$encodedCriterion = new SoapVar($locationBiddableCampaignCriterion, SOAP_ENC_OBJECT, 'BiddableCampaignCriterion', $GLOBALS['CampaignProxy']->GetNamespace());
$campaignCriterions[] = $encodedCriterion;

ถ้าคุณไม่ได้เข้ารหัส CriterionBid เป็นประเภทคอนกรีต BidMultiplier คําขอที่สร้างขึ้น SOAP เป็นองค์ประกอบเกณฑ์นามธรรมที่ว่างเปล่า ซึ่งจะทําให้เกิดข้อยกเว้นการซีเรียลไลซ์กับข้อความ "ไม่สามารถสร้างคลาสนามธรรมได้"

<ns1:CriterionBid>

วัตถุต้องถูกเข้ารหัสอย่างถูกต้องด้วยชนิดที่ซับซ้อน เช่น BidMultiplier

<ns1:CriterionBid xsi:type="ns1:BidMultiplier">
    <ns1:Type xsi:nil="true" />
    <ns1:Multiplier>0</ns1:Multiplier>
</ns1:CriterionBid>

เอกสารอ้างอิงสําหรับวัตถุข้อมูลแต่ละวัตถุจะระบุว่าชนิดที่ซับซ้อนนั้นมาจากชนิดพื้นฐานหรือไม่ เช่น โปรดดู BiddableCampaignCriterion, LocationCriterion และ BidMultiplier

WSDL ยังกําหนดลําดับชั้น เช่น ข้อกําหนดต่อไปนี้สําหรับ BidMultiplier

<xs:complexType name="BidMultiplier">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:CriterionBid">
      <xs:sequence>
        <xs:element minOccurs="0" name="Multiplier" type="xs:double"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>
<xs:element name="BidMultiplier" nillable="true" type="tns:BidMultiplier"/>

ดูเพิ่มเติม

ไลบรารีไคลเอ็นต์ Bing Ads API
ตัวอย่างรหัส API ของโฆษณา Bing
ที่อยู่ของบริการเว็บ API ของ Bing Ads
การจัดการข้อผิดพลาดและข้อยกเว้นของบริการ
Sandbox