ResponsiveSearchAdBuilder

Duyarlı bir arama reklamı tanımlama ve oluşturma yöntemlerini içerir. Oluşturucular hakkında bilgi için bkz. Oluşturucular.

Örnek kullanım:

    var operation = adGroup.newAd().responsiveSearchAdBuilder()
        .withFinalUrl('LANDING PAGE URL GOES HERE')
        .build();

    // See the Builders topic for performance considerations
    // when using the operation object's methods.
    if (!operation.isSuccessful()) {
        for (var error of operation.getErrors()) {
            Logger.log(`${error}\n`);
        }
    }

Yöntemler

Yöntem Adı	Dönüş Türü	Açıklama
addDescription(dize açıklaması, dize sabitleme)	ResponsiveSearchAdBuilder	Sağlanan açıklamayı geçerli açıklama listesine ekler. Bu veya addDescription() yöntemi kullanılarak en az 2 açıklama belirtilmelidir.
addHeadline(dize başlığı, dize sabitleme)	ResponsiveSearchAdBuilder	Sağlanan başlığı geçerli başlık listesine ekler. Bu veya addHeadline() yöntemi kullanılarak en az 3 başlık belirtilmelidir.
Oluşturmak	AdOperation	Reklamı oluşturur ve Betiklerin reklamı başarıyla ekleyip eklemediğini denetlemek için kullanılan bir işlem nesnesi döndürür.
withCustomParameters(Object customParameters)	ResponsiveSearchAdBuilder	Reklamın özel parametrelerini ayarlar.
withDescriptions(object[] descriptions)	ResponsiveSearchAdBuilder	Reklamın açıklamalarını ayarlar.
withFinalUrl(string finalUrl)	ResponsiveSearchAdBuilder	Reklamın giriş sayfası URL'sini ayarlar.
withFinalUrlSuffix(string finalUrlSuffix)	ResponsiveSearchAdBuilder	Reklamın son URL sonekini ayarlar.
withHeadlines(object[] başlıklar)	ResponsiveSearchAdBuilder	Reklamın başlıklarını ayarlar.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Reklamın mobil cihazlar için son URL'sini ayarlar.
withPath1(urlPath1 dizesi)	ResponsiveSearchAdBuilder	Reklamın görünen URL'sine eklenecek ilk isteğe bağlı yolu ayarlar.
withPath2(urlPath2 dizesi)	ResponsiveSearchAdBuilder	Reklamın görünen URL'sine eklenecek ikinci isteğe bağlı yolu ayarlar.
withTrackingTemplate(dize izlemeTemplate)	ResponsiveSearchAdBuilder	Reklamın izleme şablonunu ayarlar.

addDescription(dize açıklaması, dize sabitleme)

Sağlanan açıklamayı geçerli açıklama listesine ekler. Bu veya addDescription() yöntemi kullanılarak en az 2 açıklama belirtilmelidir.

Bağımsız değişken

Name	Tür	Açıklama
Açıklama	Dize	Eklenecek reklam açıklaması. Sınırlar ve dinamik metin dizeleri dahil etme hakkında bilgi için bkz. Bing Ads API'si.
Sabitleme	Dize	İsteğe bağlı sabitlenmiş konum. Açıklamalar için olası değerler şunlardır: DESCRIPTION_1, DESCRIPTION_2
Metin	Dize	Bu varlığın metni.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Açıklamanın uygulandığı reklam oluşturucusu.

addHeadline(dize başlığı, dize sabitleme)

Sağlanan başlığı geçerli başlık listesine ekler. Bu veya addHeadline() yöntemi kullanılarak en az 3 başlık belirtilmelidir.

Bağımsız değişken

Name	Tür	Açıklama
Başlık	Dize	Eklenecek reklam başlığı. Sınırlar ve dinamik metin dizeleri dahil etme hakkında bilgi için bkz. Bing Ads API'si.
Sabitleme	Dize	İsteğe bağlı sabitlenmiş konum. Başlıklar için olası değerler şunlardır: HEADLINE_1, HEADLINE_2 HEADLINE_3

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Başlığın uygulandığı reklam oluşturucusu.

Oluşturmak

Reklamı oluşturur ve Betiklerin reklamı başarıyla ekleyip eklemediğini denetlemek için kullanılan bir işlem nesnesi döndürür.

Bir reklam grubuna ekleyebileceğiniz reklam sayısıyla ilgili sınırlar için bkz . Varlık hiyerarşi sınırları.

Döndürür

Tür	Açıklama
AdOperation	Betiklerin reklamı başarıyla ekleyip eklemediğini denetlemek için kullanılan bir işlem nesnesi.

withCustomParameters(Object customParameters)

Reklamın özel parametrelerini ayarlar.

Özel parametreler, dinamik bilgilerin birden çok URL arasında paylaşılmasında yararlıdır. Kullanımı hakkında daha fazla bilgi için bkz. Özel Parametreler.

Bağımsız değişken

Name	Tür	Açıklama
customParameters	Nesne	Reklamın son URL'sine uygulanacak en fazla özel parametre haritası. Örneğin, {key1: 'value1', key2: 'value2', key3: 'value3'}burada anahtar özel parametrenin adı, değer ise parametrenin değeridir. Ad en fazla 16 8 bayt karakter ve değer en fazla 200 8 bayt karakter içerebilir.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Özel parametrelerin uygulandığı ad oluşturucusu.

withDescriptions(object[] descriptions)

Reklamın açıklamalarını ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
Açıklama	AdTextAsset[]	Reklamın açıklamaları. Sınırlar ve dinamik metin dizeleri dahil etme hakkında bilgi için bkz. Bing Ads API'si.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Açıklamaların uygulandığı reklam oluşturucusu.

withFinalUrl(string finalUrl)

Reklamın giriş sayfası URL'sini ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
finalUrl	Dize	Reklamın giriş sayfası URL'si. URL sınırları hakkında bilgi için bkz . Bing Ads API'si.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Son URL'nin uygulandığı reklam oluşturucusu.

withFinalUrlSuffix(string finalUrlSuffix)

Reklamın son URL sonekini ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
finalUrl	Dize	Reklamın son URL soneki. URL sınırları hakkında bilgi için bkz . Bing Ads API'si.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Son URL'nin uygulandığı reklam oluşturucusu.

withHeadlines(object[] başlıklar

Reklamın başlıklarını ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
Başlık	AdTextAsset[]	Reklamın başlıkları. Sınırlar ve dinamik metin dizeleri dahil etme hakkında bilgi için bkz. Bing Ads API'si.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Reklam başlıkları uygulanmış reklam oluşturucusu.

withMobileFinalUrl(string mobileFinalUrl)

Reklamın mobil cihazlar için son URL'sini ayarlar.

Son URL, kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlar. Mobil cihazlar için son URL'yi belirtmek için önce mobil olmayan cihazlar için son URL'yi belirtin (bkz withFinalUrl(). ).

Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?

Bağımsız değişken

Name	Tür	Açıklama
mobileFinalUrl	Dize	Mobil cihazlar için son URL.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Mobil son URL'nin uygulandığı reklam oluşturucusu.

withPath1(urlPath1 dizesi)

Reklamın görünen URL'sine eklenecek ilk isteğe bağlı yolu ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
mobileFinalUrl	Dize	Reklamın görünen URL'sine eklenecek ilk isteğe bağlı yol. Microsoft, görüntüleme URL'si olarak içinde withFinalUrl belirtilen etki alanını kullanır. Son URL'nin etki alanı contoso.com ve yol ayakkabı ise, reklamın görünen URL'si contoso.com/shoes. Kullanım ve sınırlar için bkz. Yol1.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Yolu uygulanmış ad oluşturucusu.

withPath2(urlPath2 dizesi)

Reklamın görünen URL'sine eklenecek ikinci isteğe bağlı yolu ayarlar.

Bağımsız değişken

Name	Tür	Açıklama
mobileFinalUrl	Dize	Reklamın görünen URL'sine eklenecek ikinci isteğe bağlı yol. İkinci yolu belirtmek için önce ilk yolu belirtin (bkz withPath1. ). Microsoft, görüntüleme URL'si olarak içinde withFinalUrl belirtilen etki alanını kullanır. Son URL'nin etki alanı contoso.com, ilk yol ayakkabı, ikinci yol ise bayanlar ise reklamın görünen URL'si contoso.com/shoes/ladies. Kullanım ve sınırlar için bkz. Yol2.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	Yolu uygulanmış ad oluşturucusu.

withTrackingTemplate(dize izlemeTemplate)

Reklamın izleme şablonunu ayarlar.

İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar sözcüğün FinalUrl ile birlikte kullanılır. Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?

Bağımsız değişken

Name	Tür	Açıklama
trackingTemplate	Dize	Bu reklamla kullanılacak izleme şablonu.

Döndürür

Tür	Açıklama
ResponsiveSearchAdBuilder	İzleme şablonunun uygulandığı reklam oluşturucusu.