Aracılığıyla paylaş


ExpandedTextAdBuilder

Genişletilmiş metin reklamı tanımlama ve oluşturma yöntemlerini içerir. Oluşturucular hakkında bilgi için bkz. Oluşturucular.

Not

  • Genişletilmiş metin reklamlarınızı 1 Şubat 2023'e kadar duyarlı arama reklamlarına yükseltin. Bu tarihten sonra artık yeni reklam oluşturamayacak veya mevcut genişletilmiş metin reklamlarını düzenleyemezsiniz. Daha fazla bilgi için bkz . Duyarlı arama reklamları hakkında.
  • Mevcut genişletilmiş metin reklamları yayınlanmaya devam eder ve bu reklamların performansına ilişkin raporları görüntüleyebilirsiniz.
  • Genişletilmiş metin reklamlarınızı duraklatabilir, etkinleştirebilir veya kaldırabilirsiniz. Aksi takdirde, genişletilmiş metin reklamları ekleme veya güncelleştirme girişimleri hataya CampaignServiceAdTypeInvalid neden olur.
  • Bu değişiklik hakkında daha fazla bilgi edinin.

Örnek kullanım:

    var operation = adGroup.newAd().expandedTextAdBuilder()
        .withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
        .withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
        .withDescription('AD TEXT GOES HERE')
        .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
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) ExpandedTextAdBuilder Reklamın özel parametrelerini ayarlar.
withDescription(dize açıklaması) ExpandedTextAdBuilder Reklamın ilk açıklamasını ayarlar. Bu yöntem , withDescription1(dize açıklaması1) lehine kullanım dışı bırakılmıştır.
withDescription1(dize açıklaması1) ExpandedTextAdBuilder Reklamın ilk açıklamasını ayarlar. Bu yöntem , withDescription(dize açıklaması) ile aynı alanı ayarlar.
withDescription2(dize açıklaması2) ExpandedTextAdBuilder Reklamın ikinci açıklamasını ayarlar.
withFinalUrl(string finalUrl) ExpandedTextAdBuilder Reklamın giriş sayfası URL'sini ayarlar.
withHeadlinePart1(string headlinePart1) ExpandedTextAdBuilder Reklam başlığının ilk bölümünü ayarlar.
withHeadlinePart2(string headlinePart2) ExpandedTextAdBuilder Reklam başlığının ikinci bölümünü ayarlar.
withHeadlinePart3(string headlinePart3) ExpandedTextAdBuilder Reklam başlığının üçüncü bölümünü ayarlar.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Reklamın mobil cihazlar için son URL'sini ayarlar.
withPath1(urlPath1 dizesi) ExpandedTextAdBuilder Reklamın görünen URL'sine eklenecek ilk isteğe bağlı yolu ayarlar.
withPath2(urlPath2 dizesi) ExpandedTextAdBuilder Reklamın görünen URL'sine eklenecek ikinci isteğe bağlı yolu ayarlar.
withTrackingTemplate(dize izlemeTemplate) ExpandedTextAdBuilder Reklamın izleme şablonunu ayarlar.

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
ExpandedTextAdBuilder Özel parametrelerin uygulandığı ad oluşturucusu.

withDescription(dize açıklaması)

Reklamın ilk açıklamasını ayarlar. Bu yöntem , withDescription1(dize açıklaması1) lehine kullanım dışı bırakılmıştır.

Bağımsız değişken

Name Tür Açıklama
Açıklama Dize Reklamın ilk açıklaması. Kopyalama sınırları ve dinamik metin dizeleri dahil hakkında bilgi için bkz . Bing Ads API'si.

Döndürür

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

withDescription1(dize açıklaması1)

Reklamın ilk açıklamasını ayarlar. Bu yöntem , withDescription(dize açıklaması) ile aynı alanı ayarlar.

Bağımsız değişken

Name Tür Açıklama
açıklama1 Dize Reklamın ilk açıklaması. Kopyalama sınırları ve dinamik metin dizeleri dahil hakkında bilgi için bkz . Bing Ads API'si.

Döndürür

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

withDescription2(dize açıklaması2)

Reklamın ikinci açıklamasını ayarlar.

Bağımsız değişken

Name Tür Açıklama
açıklama2 Dize Reklamın ikinci açıklaması. Kopyalama sınırları ve dinamik metin dizeleri dahil hakkında bilgi için bkz . Bing Ads API'si.

Döndürür

Tür Açıklama
ExpandedTextAdBuilder Açıklamanı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
ExpandedTextAdBuilder Son URL'nin uygulandığı reklam oluşturucusu.

withHeadlinePart1(string headlinePart1)

Reklam başlığının ilk bölümünü ayarlar.

Bağımsız değişken

Name Tür Açıklama
headlinePart1 Dize Reklamın başlığının ilk bölümü. Microsoft, başlığın 1, 2 ve 3. bölümlerini kullanarak reklamın başlığını oluşturduğunda, " - " kullanarak bölümleri birleştirir. Tireyi hiçbir başlık bölümünde belirtmeyin. Başlığın her bölümü en az bir sözcük içermelidir. Ek başlık sınırları ve başlığa dinamik metin dizeleri dahil etme hakkında daha fazla bilgi için bkz. Bing Ads API'si.

Döndürür

Tür Açıklama
ExpandedTextAdBuilder Reklam başlığının 1. bölümü uygulanmış reklam oluşturucusu.

withHeadlinePart2(string headlinePart2)

Reklam başlığının ikinci bölümünü ayarlar.

Bağımsız değişken

Name Tür Açıklama
headlinePart2 Dize Reklamın başlığının ikinci bölümü. Microsoft, başlığın 1, 2 ve 3. bölümlerini kullanarak reklamın başlığını oluşturduğunda, " - " kullanarak bölümleri birleştirir. Tireyi hiçbir başlık bölümünde belirtmeyin. Başlığın her bölümü en az bir sözcük içermelidir. Ek başlık sınırları ve başlığa dinamik metin dizeleri dahil etme hakkında daha fazla bilgi için bkz. Bing Ads API'si.

Döndürür

Tür Açıklama
ExpandedTextAdBuilder Reklam başlığının 1. bölümü uygulanmış reklam oluşturucusu.

withHeadlinePart3(string headlinePart3)

Reklam başlığının üçüncü bölümünü ayarlar.

Bağımsız değişken

Name Tür Açıklama
headlinePart3 Dize Reklam başlığının üçüncü bölümü. Microsoft, başlığın 1, 2 ve 3. bölümlerini kullanarak reklamın başlığını oluşturduğunda, " - " kullanarak bölümleri birleştirir. Tireyi hiçbir başlık bölümünde belirtmeyin. Başlığın her bölümü en az bir sözcük içermelidir. Ek başlık sınırları ve başlığa dinamik metin dizeleri dahil etme hakkında daha fazla bilgi için bkz. Bing Ads API'si.

Döndürür

Tür Açıklama
ExpandedTextAdBuilder Reklam başlığının 1. bölümü 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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder İzleme şablonunun uygulandığı reklam oluşturucusu.