ExpandedTextAdBuilder

Genişletilmiş metin reklam tanımlama ve oluşturma yöntemlerini içerir. İnşaatçılar hakkında daha fazla bilgi için bkz: İnşaatçılar.

Not

  • Genişletilmiş metin reklamlarınızı 1 Şubat 2023'e kadar duyarlı arama ağı reklamlarına dönüştürün. Bu tarihten sonra artık yeni metin reklam oluşturamayacak veya mevcut genişletilmiş metin reklamları düzenleyemeyeceksiniz. Daha fazla bilgi için Duyarlı arama ağı reklamları hakkında başlıklı makaleyi inceleyin.
  • Mevcut genişletilmiş metin reklamlar yayınlanmaya devam edecek ve performanslarıyla ilgili raporları görüntüleyebileceksiniz.
  • Genişletilmiş metin reklamlarınızı duraklatmaya, etkinleştirmeye veya kaldırmaya devam edebilirsiniz. Aksi takdirde, genişletilmiş metin reklamları ekleme veya güncelleme girişimleri hatayla CampaignServiceAdTypeInvalid sonuçlanır.
  • 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ı İade Türü Açıklama
İnşa etmek AdOperation Reklamı oluşturur ve Betiklerin reklamı başarıyla ekleyip eklemediğini kontrol etmek 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ımdan kaldırı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ı belirler.
withFinalUrl(dize finalUrl) ExpandedTextAdBuilder Reklamın açılış sayfası URL'sini ayarlar.
withHeadlinePart1(dize headlinePart1) ExpandedTextAdBuilder Reklam başlığının ilk bölümünü ayarlar.
withHeadlinePart2(dize headlinePart2) ExpandedTextAdBuilder Reklam başlığının ikinci bölümünü ayarlar.
withHeadlinePart3(dize headlinePart3) ExpandedTextAdBuilder Reklam başlığının üçüncü bölümünü ayarlar.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Mobil cihazlar için reklamın nihai URL'sini ayarlar.
withPath1(dize urlPath1) ExpandedTextAdBuilder Reklamın görünen URL'sine eklenecek ilk isteğe bağlı yolu ayarlar.
withPath2(dize urlPath2) ExpandedTextAdBuilder Reklamın görünen URL'sine eklenecek ikinci isteğe bağlı yolu ayarlar.
withTrackingTemplate(dize izlemeŞablonu) ExpandedTextAdBuilder Reklamın izleme şablonunu ayarlar.

İnşa etmek

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

Bir reklam grubuna ekleyebileceğiniz reklam sayısıyla ilgili sınırlamalar için Varlık hiyerarşisi sınırları başlıklı makaleye bakın.

Geri dönüşler

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

withCustomParameters(Object customParameters)

Reklamın özel parametrelerini ayarlar.

Özel parametreler, birden çok URL'de dinamik bilgilerin paylaşılması konusunda yardımcı olur. Kullanımı hakkında daha fazla bilgi için Özel Parametreler'e bakın.

Bağımsız değişkenler

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

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Özel parametrelerin uygulandığı reklam oluşturucu.

withDescription(dize açıklaması)

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

Bağımsız değişkenler

Name Tür Açıklama
Açıklama dize Reklamın ilk açıklaması. Kopyalama sınırları ve dinamik metin dizeleri ekleme hakkında bilgi için Bing Ads API'ye bakın.

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Açıklama uygulanmış reklam oluşturucu.

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şkenler

Name Tür Açıklama
Açıklama1 dize Reklamın ilk açıklaması. Kopyalama sınırları ve dinamik metin dizeleri ekleme hakkında bilgi için Bing Ads API'ye bakın.

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Açıklama uygulanmış reklam oluşturucu.

withDescription2(dize açıklaması2)

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

Bağımsız değişkenler

Name Tür Açıklama
Açıklama2 dize Reklamın ikinci açıklaması. Kopyalama sınırları ve dinamik metin dizeleri ekleme hakkında bilgi için Bing Ads API'ye bakın.

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Açıklama uygulanmış reklam oluşturucu.

withFinalUrl(dize finalUrl)

Reklamın açılış sayfası URL'sini ayarlar.

Bağımsız değişkenler

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

Geri dönüşler

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

withHeadlinePart1(dize headlinePart1)

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

Bağımsız değişkenler

Name Tür Açıklama
başlıkBölüm 1 dize Reklam başlığının ilk kısmı. Microsoft, başlığın 1, 2 ve 3. bölümlerini kullanarak reklamın başlığını oluştururken, " - " kullanarak bölümleri birleştirir. Başlık bölümlerinde tire 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 bilgi için Bing Ads API'sine bakın.

Geri dönüşler

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

withHeadlinePart2(dize headlinePart2)

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

Bağımsız değişkenler

Name Tür Açıklama
başlıkBölüm 2 dize Reklam başlığının ikinci kısmı. Microsoft, başlığın 1, 2 ve 3. bölümlerini kullanarak reklamın başlığını oluştururken, " - " kullanarak bölümleri birleştirir. Başlık bölümlerinde tire 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 bilgi için Bing Ads API'sine bakın.

Geri dönüşler

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

withHeadlinePart3(dize headlinePart3)

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

Bağımsız değişkenler

Name Tür Açıklama
başlıkBölüm 3 dize Reklamın 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ştururken, " - " kullanarak bölümleri birleştirir. Başlık bölümlerinde tire 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 bilgi için Bing Ads API'sine bakın.

Geri dönüşler

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

withMobileFinalUrl(string mobileFinalUrl)

Mobil cihazlar için reklamın nihai URL'sini ayarlar.

Son URL, kullanıcının reklamı tıkladığında yönlendirildiği web sayfasını tanımlar. Mobil cihazlara yönelik nihai URL'yi belirtmek için önce mobil olmayan cihazlar için nihai URL'yi belirtin (bkz withFinalUrl(). ).

Daha fazla bilgi için Hangi izleme veya URL parametrelerini kullanabilirim? bölümüne bakın.

Bağımsız değişkenler

Name Tür Açıklama
mobileFinalUrl dize Mobil cihazlar için nihai URL.

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Mobil nihai URL'nin uygulandığı reklam oluşturucu.

withPath1(dize urlPath1)

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

Bağımsız değişkenler

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

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Yolun uygulandığı reklam oluşturucu.

withPath2(dize urlPath2)

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

Bağımsız değişkenler

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ünen URL olarak belirtilen withFinalUrl etki alanını kullanır. Son URL'nin etki alanı contoso.com, ilk yol ayakkabılar ve ikinci yol bayanlar ise, reklamın görünen URL'si contoso.com/shoes/ladies'dir. Kullanım ve sınırlar için Yol2'ye bakın.

Geri dönüşler

Tür Açıklama
ExpandedTextAdBuilder Yolun uygulandığı reklam oluşturucu.

withTrackingTemplate(dize izlemeŞablonu)

Reklamın izleme şablonunu ayarlar.

İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar kelimenin FinalUrl'si ile birlikte kullanılır. Daha fazla bilgi için Hangi izleme veya URL parametrelerini kullanabilirim? bölümüne bakın.

Bağımsız değişkenler

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

Geri dönüşler

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