Microsoft Advertising Korumalı Alanı

Microsoft Advertising, uygulamanızı üretim ortamına dağıtmadan önce test edebileceğiniz bir API korumalı alan ortamı sağlar. Korumalı alanda oluşturduğunuz reklamlar yayınlanmaz. Korumalı alanda desteklenen hizmetler üretimden üretime farklılık gösterir. Desteklenen hizmetlerin web hizmeti adreslerini almak için Bing Ads API Web Hizmeti Adresleri bölümüne bakın.

Not

Korumalı alan, önceden bildirimde bulunarak veya bulunulmaksızın bakım nedeniyle kapalı olabilir.

İlk Müşteri Kaydı

Korumalı alan ve üretim ortamları ayrı kimlik bilgileri kullanır.

Yeni bir korumalı alan müşterisi edinmek için bu adımları izleyin. Zaten korumalı alan müşteriniz varsa ve yeni bir kullanıcı eklemek istiyorsanız (örneğin, Microsoft hesabı kimlik bilgileriyle), kullanıcı daveti adımlarına atlayabilirsiniz.

  1. Bir tarayıcı açın ve korumalı alan kayıt sayfasına gidin.

  2. Şimdi kaydol'u seçin.

  3. Microsoft hesabı (MSA) oluşturmak için Hesap oluştur'u seçin.

  4. Yeni bir e-posta adresi al'ı seçin.

  5. Bir MSA e-posta adresi girin. E-posta sunucusu outlook.com olmalıdır (örneğin, someone@outlook.com).

    Önemli

    Korumalı alan, yalnızca outlook.com bir e-posta hesabı kullanılarak oluşturulan MSA'ları destekler. Ayrıca, başka bir e-posta hizmetinden e-posta hesabı kullanamazsınız (örneğin, @contoso.com) hesap bir outlook.com e-posta hesabına bağlı olsa bile).

  6. Kullanıcı ve güvenlik bilgilerinizin kalan kısmını belirterek MSA iş akışını sonlandırın. Korumalı alan müşteri ve hesap kaydına devam etmek için Microsoft Advertising'e yönlendirilirsiniz.

  7. Hesap Oluştur formunu doldurun.

  8. Canlı Yayına Geçmek için Ödeme bilgilerini atla'yı seçin.

İsteğe bağlı: Daha fazla kullanıcı davet etme

Korumalı alanda OAuth ile kimlik doğrulaması yapmak için outlook.com bir e-posta hesabıyla oluşturulmuş bir Microsoft hesabınız (MSA) olmalıdır. Korumalı alan müşteriniz henüz bir Microsoft hesabı aracılığıyla kullanıcı kimlik bilgilerine sahip değilse veya korumalı alan müşteriniz outlook-int.com bir e-posta hesabıyla oluşturulduysa, aşağıdaki adımları izleyerek bir kullanıcıyı korumalı alan hesabınızda çalışmaya davet etmeniz gerekir.

  1. Microsoft Advertising korumalı alanda Ayarlar'ı seçin.

  2. Kullanıcı yönetimi'ni seçin.

  3. Kullanıcı davet et'i seçin.

  4. Davet edilecek kullanıcının e-posta adresini girin. E-posta sunucusu outlook.com olmalıdır (örneğin, someone@outlook.com).

    Önemli

    Yalnızca outlook.com e-posta hesaplarına davet gönderebilirsiniz. Hesap bir outlook.com e-posta hesabına bağlı olsa bile, başka bir etki alanına davet gönderemezsiniz. Başka bir etki alanına (örneğin, ) davet göndermeye çalışırsanız, someone@contoso.comBingAds kullanıcı arabirimi daveti süresiz olarak beklemede olarak gösterir (davet hiçbir zaman gönderilmez).

  5. Gönder'i seçin.

Microsoft Advertising kullanıcıya bir e-posta daveti gönderir. Davet gelen kutusunda görünmüyorsa, Önemsiz EmailEmail klasörünü kontrol edin. Davetin alınması birkaç dakika sürebilir. Aşağıdaki adımlarda davetin nasıl kabul edileceği gösterilir.

  1. Microsoft Advertising'den gelen konu satırında Microsoft Advertising'e Davet bulunan e-postayı açın

  2. Eklenen bağlantıyı kopyalayın ve InPrivate modundaki pencerede veya başka bir tarayıcıda açın.

  3. Microsoft hesabı (MSA) oluşturmak için Hesap oluştur'u seçin.

  4. Yeni bir e-posta adresi al'ı seçin.

  5. Bir MSA e-posta adresi girin. E-posta sunucusu outlook.com olmalıdır (örneğin, someone@outlook.com).

    Önemli

    Korumalı alan, yalnızca outlook.com bir e-posta hesabı kullanılarak oluşturulan MSA'ları destekler. Ayrıca, başka bir e-posta hizmetinden e-posta hesabı kullanamazsınız (örneğin, @contoso.com) hesap bir outlook.com e-posta hesabına bağlı olsa bile).

  6. Kullanıcı bilgilerinizin kalan bölümünü belirterek iş akışını sonlandırma

  7. MSA işlemini tamamladıktan sonra Microsoft Advertising'den çıkın.

Not

MSA kayıt işlemi sizi SI Microsoft Advertising kullanıcı arabirimine (ads-int.microsoft.com) döndürür. MSA işlemini tamamladıktan sonra, SI arabiriminin oturumunu kapatın ve ardından yeni outlook.com e-posta adresinizi kullanarak adresinden https://sandbox.bingads.microsoft.com/oturum açın.

Sandbox Ortamı — Google OAuth Desteği

Microsoft Advertising korumalı alan ve üretim ortamları ayrı kimlik bilgileri kullanır. Microsoft hesaplarına ek olarak, artık Google OAuth 2.0'ı kullanarak korumalı alan müşterileri oluşturabilir ve kullanıcıların kimliklerini doğrulayabilirsiniz.

Bu, geliştiricilerin ve reklam verenlerin Microsoft Advertising API'lerini bir outlook.com Microsoft hesabına ihtiyaç duymadan bir Google kimliği kullanarak korumalı alanda test etmelerini sağlar.

İlk Müşteri Sign-Up (Sandbox) - Google OAuth

Bir Google hesabı kullanarak yeni bir korumalı alan müşterisi oluşturabilirsiniz.

Google OAuth ile Yeni Bir Sandbox Müşterisi Oluşturma Adımları

  1. Bir tarayıcı açın ve korumalı alan kayıt sayfasına gidin.

  2. Şimdi kaydol'u seçin.

  3. Google ile kaydol'u seçin.

  4. Google OAuth kimlik doğrulama akışını tamamlayın:

    • Google hesabınızla oturum açın.
    • Microsoft Advertising'in hesabınıza erişmesine izin vermek için inceleyin ve izin verin.
    • İstenirse istenen kapsamları (email, profile) onaylayın.
  5. Başarılı bir kimlik doğrulamasından sonra, korumalı alan müşteri oluşturmaya devam etmek için Microsoft Advertising'e geri yönlendirilirsiniz.

  6. Hesap Oluştur formunu doldurun.

    • Canlı Yayına Geçmek için Ödeme bilgilerini atla'yı seçin.

Google OAuth ile Davetiye Kabul Etme

Davet edilen kullanıcılar, Google OAuth kullanarak korumalı alan davetlerini aşağıdaki şekilde kabul edebilir:

  1. Davet bağlantısını açın.
  2. Google ile oturum aç'ı seçin.
  3. Google OAuth kimlik doğrulama akışını tamamlayın.
  4. Başarılı bir oturum açma işleminden sonra kullanıcı, korumalı alan hesabına eklenir.

Bu geliştirilmiş korumalı alan desteği, ekiplerin Microsoft Advertising API'lerini Google tarafından kimliği doğrulanmış kullanıcılarla test etmesine ve üretimle aynı API davranışını korumasına olanak tanır.

API Erişimi Alın

Korumalı alan ve üretim ortamları ayrı kimlik bilgileri kullanır.

Bu tablo, başka korumalı alan uç noktalarını da içerir.

Açıklama Üretim Korumalı Alan
OAuth istekleri için uç nokta login.microsoftonline.com login.microsoftonline.com
Microsoft hesabı alırken kullanılan e-posta için etki alanı Herhangi bir e-posta adresi outlook.com
Microsoft hesabı parolasını değiştirmeye yönelik uç nokta account.live.com/password/change account.live.com/password/change

Üretimde kendi geliştirici belirtecinizi kullanmanız gerekse de, tüm Microsoft Advertising müşterileri korumalı alanda aşağıdaki evrensel geliştirici belirtecini kullanabilir.

BBD37VB98

Hem üretimde hem de korumalı alanda kendi uygulama kimliğinizi (diğer bir deyişle istemci kimliği) kullanmanız gerekir.

Artık Microsoft Advertising kullanıcınız için belirteçlere erişebilir ve yenileyebilir ve Bing Ads API'sini kullanarak ilk hizmet çağrınızı yapabilirsiniz, Hızlı Başlangıç kılavuzuna bakın.

İpucu

Bing Ads SDK'larını kullanarak jetonlara nasıl erişeceğiniz ve token'ları nasıl yenileyeceğiniz hakkında ayrıntılı bilgi için SDK'larla Kimlik Doğrulama bölümüne bakın.

Google oAuth için API Erişimi Alın

adresinde bir Google hesabı https://accounts.google.comoluşturun.

Korumalı alan için en iyi yöntemler

Korumalı alan, üretimle aynı kapasitede kullanılmamalıdır.

  • Uygulamanızı üretim ortamına dağıttığınızda üretim WSDL'lerini ve üretim kimlik bilgilerinizi kullandığınızdan emin olun.
  • Korumalı alan geçerli üretim sürümünü içerir ve önceden bildirim olsun veya olmasın özellik önizlemeleriyle güncelleştirilir.
  • Korumalı alanın kapasitesi üretimden daha azdır ve bunu stres veya kapasite testi yapmak için kullanmamalısınız.
  • Lütfen birden fazla iş parçacığı kullanmayın.

Reklam İçgörü Hizmeti

Sandbox, Ad Insight hizmet işlemlerini test etmek için sınırlı sayıda anahtar kelimeyi destekler. Test verilerini, üretimdeki anahtar kelimeleriniz için benzer tahminler elde etmek veya beklemek için kullanmamalısınız. Bazı sınırlamalar aşağıdaki tabloda açıklanmıştır.

İpucu

Reklam İçgörüsü hizmetini korumalı alan yerine üretimde kullanın. Sandbox yalnızca üretim hizmeti operasyonlarının bir alt kümesini sunar ve içgörü verileri üretimin gerisinde kalır. Korumalı alan fırsatı verileri her hafta sonu yenilenip güncelleştirilir ve Pazartesi gününe kadar kullanılabilir. Sandbox'taki anahtar kelime fikri verileri, üretimin birkaç ay gerisinde kalabilir. Geçersiz bir tarih aralığı nedeniyle bir işlem başarısız olursa, isteği daha önceki bir tarih aralığıyla yeniden göndermeyi deneyin.

Hizmet Operasyonu Korumalı alan sınırlamaları
GetBidLandscapeByKeywordIds Desteklenmez. İşlemi var olan anahtar sözcük tanımlayıcılarıyla çağırabilirsiniz, ancak hiçbir veri döndürülmez.
GetEstimatedBidByKeywordIds Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.
GetEstimatedBidByKeywords Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.
GetEstimatedPositionByKeywordIds Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

Tahmin alma şansını artırmak için MaxBid öğesinin 5 ABD Doları veya diğer para birimlerindeki eşdeğerinden fazla veya buna eşit olması gerekir.
GetEstimatedPositionByKeywords Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

Tahmin alma şansını artırmak için MaxBid öğesinin 5 ABD Doları veya diğer para birimlerindeki eşdeğerinden fazla veya buna eşit olması gerekir.
GetHistoricalKeywordPerformance Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

MatchType ve AdPosition öğeleri Toplama olarak ayarlanmalıdır.

Devices öğesi Computers veya left nil olarak ayarlanmalıdır.
GetHistoricalSearchCount Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

BitişAyVeYıl öğesi önceki aya ayarlanmalıdır. Örneğin, bugünün tarihi 1 Nisan 2020 ise, bitiş ayı Mart 2020 olmalıdır.

Devices öğesi Computers veya left nil olarak ayarlanmalıdır.
GetKeywordCategories Sandbox ile üretim arasında hiçbir fark olmamalıdır.
GetKeywordDemografisi Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

Devices öğesi Computers veya left nil olarak ayarlanmalıdır.
Anahtar KelimeFikirleri almak Korumalı alan test verileri 3 ayda bir yenilenir, bu nedenle daha erken bir tarih aralığı ayarlamanız gerekir.
Anahtar Sözcükleri Al Sınırlı sayıda anahtar kelime desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel incelemeleri, sigorta karşılaştırması, spor, otel.

Devices öğesi Computers veya left nil olarak ayarlanmalıdır.
Url için Anahtar Kelime Öner Sandbox ile üretim arasında hiçbir fark olmamalıdır.
VarolanAnahtar SözcüklerdenAnahtar Sözcükler Öner SuggestionType 1 olarak ayarlanırsa, üretime kıyasla davranışta bir fark olmamalıdır.

Öneri türü değerleri 2, 3 ve 4 için sınırlı bir anahtar sözcük grubu desteklenir: hava, otomobil, en iyi fırsatlar, rezervasyon, araba bilgileri, bakım, günün fırsatı, indirimler, eğlence, finans, oyunlar, otel değerlendirmeleri, sigorta karşılaştırması, spor, otel.

Toplu Servis

Üretimde yükleme için dosya boyutu sınırı 100 MB veya 2,5 milyon satırdır. Korumalı alan için sınır 20K satırdır. Daha fazla bilgi için bkz. Toplu İndirme ve Yükleme.

Kampanya Yönetim Hizmeti

Editoryal Destek

Sandbox, sınırlı editoryal incelemeleri ve itirazları destekler. Üretimde olduğu gibi sandbox'ta editoryal sorunların nedenlerini alamazsınız, örneğin GetEditorialReasonsByIds hizmet işlemi aracılığıyla.

Ürün Reklamları

Ürün reklamları Birleşik Devletler'de korumalı alanda desteklenir. Otomatik olarak onaylanmak için, aşağıdaki gibi "korumalı alan" ile biten bir katalog ve Microsoft Merchant Center mağazası oluşturmanız gerekir.

  1. Microsoft Advertising web uygulamasında Araçlar'ı seçin.
  2. Yönetim Araçları'nın altında, Microsoft Merchant Center'ı seçin.
  3. Mağaza oluştur'u seçin ve "korumalı alan" (büyük/küçük harf duyarlı değil) ile biten bir mağaza adı girin.
  4. Mağaza bilgilerinizi ekleyin, Katalog ayarları altından Ürün Reklamları'nı seçin ve Son'u seçin.
  5. Yeni mağazanızda Katalog yönetimi'ni ve ardından Katalog oluştur'u seçin.
  6. Katalog adınızı ekleyin, Katalog akışı dosyası altında Dosyayı daha sonra el ile yükle'yi seçin ve Kaydet'i seçin.

Müşteri Faturalama Hizmeti

Ödeme yöntemleri korumalı alanda desteklenmez.

Reporting Service

Bir anahtar kelime oluşturduğunuzda, test performansı verileri birkaç saat içinde oluşturulmalıdır. Veriler, korumalı alanda rapor oluşturmayı, almayı ve ayrıştırmayı test etmek için sağlanır. Test verilerini, üretimdeki anahtar kelimeleriniz için benzer bir performans elde etmek veya beklemek için kullanmamalısınız.

Test verileri yalnızca varlığın eklendiği veya güncelleştirildiği gün için oluşturulur. Örneğin, bugün bir anahtar kelime ekler ve geçen haftaya ait bir anahtar kelime performans raporu indirirseniz, orada herhangi bir veri olmayacaktır. Rapor zaman aralığına bugünü içeren bir rapor çıkarmanız gerekir.

Aşağıdaki raporlar, korumalı alanda performans verileri döndürebilir. Diğer tüm rapor türleri başarıyla gönderilebilir, ancak korumalı alan hizmeti herhangi bir örnek veri döndürmez; örneğin, sonuçlar için yoklama yaptığınızda rapor indirme URL'si ayarlanmaz.