Aracılığıyla paylaş

Bing Ads API ile PHP Kullanmaya Başlama

  • Makale

PHP ile Bing Ads API uygulamaları geliştirmeye başlamak için sağlanan örneklerle başlayabilir veya Web veya Masaüstü uygulaması için uygulama kılavuzlarından birini izleyebilirsiniz. Örnekler Bing Ads PHP SDK ile geliştirilmiştir ve PHP 7.0.6 ile çalıştırılmıştır. PHP'nin diğer sürümlerini (5.6'dan büyük), paketleri ve işletim sistemlerini kullanabilmeniz gerekir. Ancak, kodun ve yapılandırmanın bazı bölümlerinin değiştirilmesi gerekebilir. Web hizmetlerini kullanmak üzere php geliştirme ortamı ayarlama hakkında bilgi için, araçlarınıza yönelik belgelere bakın. SOAP ve OpenSSL uzantıları da PHP.ini dosyasında etkinleştirilmelidir. Toplu karşıya yükleme örneklerini çalıştırmak için curl uzantısını etkinleştirin.

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

Üretim veya korumalı alanda Microsoft Advertising erişimine sahip kullanıcı kimlik bilgilerine ihtiyacınız olacaktır. Üretim ortamı için bir üretim geliştirici belirteci gerekir. Tüm korumalı alan istemcileri evrensel korumalı alan geliştirici belirtecini BBD37VB98 kullanabilir. Daha fazla bilgi için bkz. Bing Ads API'sini ve Korumalı Alanı Kullanmaya Başlama.

OAuth aracılığıyla kimlik doğrulaması yapmak için bir uygulamayı kaydetmeniz ve ilgili istemci tanımlayıcısını almanız gerekir. Ayrıca bir web uygulaması geliştiriyorsanız istemci gizli dizisini ve yeniden yönlendirme URI'sini de not almanız gerekir. Bir uygulamayı üretime kaydetme ve yetkilendirme kodu verme akışı hakkında daha fazla bilgi için bkz. OAuth ile Kimlik Doğrulaması ve SDK'larla Kimlik Doğrulaması. Üretimde kendi uygulama kimliğinizi (istemci kimliği) kullanmanız gerekse de, tüm Microsoft Advertising müşterileri korumalı alanda genel "Öğretici Örnek Uygulama" istemci kimliğini kullanabilir; örneğin, 00001111-aaaa-2222-bbbb-3333cccc4444. Daha fazla bilgi için bkz. Korumalı Alan.

SDK'yi yükleme

Packagist'ten getirmek için Composer paket yöneticisini kullanarak Bing Ads PHP SDK'sını yükleyebilir veya kaynağı GitHub'dan kopyalayabilirsiniz. Bu kılavuzda, Bing Ads PHP SDK'sının en son sürümünü almak için Composer'ı nasıl kullanabileceğiniz açıklanmaktadır.

  1. Composer'ı indirip yükleyin. Microsoft Windows kullanıcıları path değişkeninize composer.phar da eklemelidir.

  2. Bir komut istemi açın ve yazın composer require microsoft/bingads.

    Not

    PATH'ecomposer.phar eklemeyen Windows kullanıcılarının yazması php composer.phar require microsoft/bingads gerekir.

  3. İleriye dönük güncelleştirmeleri almak için yazın composer update. Packagist'te herhangi bir güncelleştirme varsa oluşturucu en son sürümü yükler.

İzlenecek yollar

Bing Ads PHP SDK'sını yükledikten sonra Bing Ads API Kodu Örneklerine göz atabilir, GitHub'daki örnekleri indirebilir veya web veya masaüstü uygulaması için uygulama kılavuzlarından birini izleyebilirsiniz.

SoapVar kullanma

Temel sınıftan devralan karmaşık bir tür göndermek için nesneyi SoapVar olarak kodlamanız gerekir. Aşağıdaki örnekte BiddableCampaignCriterion (CampaignCriterion'dan türetilmiştir), LocationCriterion (Ölçütten türetilmiştir) ve BidMultiplier (CriterionBid'ten türetilmiştir) kodlanmıştır.

$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 öğesini BidMultiplier beton türü olarak kodlamazsanız, oluşturulan istek SOAP boş bir soyut CriterionBid öğesidir. Bu, "Soyut sınıf oluşturulamıyor" iletisiyle bir serileştirme özel durumuyla sonuçlanır.

<ns1:CriterionBid>

Nesnenin karmaşık türle (bidMultiplier gibi) düzgün bir şekilde kodlanması gerekir.

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

Her veri nesnesi için başvuru belgeleri karmaşık türün bir temel türden türetilip türetilmeyeceğini belirtir. Örneğin, bkz . BiddableCampaignCriterion, LocationCriterion ve BidMultiplier.

WSDL ayrıca hiyerarşiyi tanımlar; örneğin BidMultiplier için aşağıdaki tanım.

<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"/>

Ayrıca Bkz

API İstemci Kitaplıklarını Bing Ads
Bing Ads API Kodu Örnekleri
Bing Ads API Web Hizmeti Adresleri
Hizmet Hatalarını ve Özel Durumlarını İşleme
Sandbox