Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Reklam Seçenekleri simgesi ve yer paylaşımı

Google tarafından barındırılan kişiselleştirilmiş reklamlar gösteren tüm uygulamalar, Google tarafından sağlandığında AdChoices simgesini ve yer paylaşımını uygulamalıdır. Reklam Seçenekleri (aynı zamanda "Neden bu reklam?" olarak da bilinir), kullanıcılara belirli bir reklamı neden gördüklerini açıklayan ve gizliliklerinin nasıl korunduğu hakkında bilgi veren şeffaflık özelliğidir.

Daha fazla bilgi için Neden bu reklamı görüyorsunuz? başlıklı makaleyi inceleyin.

Bu kılavuzda, reklamınızın VAST XML yanıtından veya DAI akışınızın meta veri yanıtından Reklam Seçenekleri'ni düzgün şekilde uygulamak için gerekli bilgilerin nasıl ayıklanacağı açıklanmaktadır.

AdChoices oluşturma koşulları

Google'ın Reklam Seçenekleri simgelerinin oluşturulmasıyla ilgili şartlarına uymak için uygulamanızın veya web sitenizin aşağıdaki standartları karşılaması gerekir:

Reklam Seçenekleri simgesi, sağlandığı tüm reklamların üzerinde yer paylaşımı olarak gösterilmelidir.
Reklam Seçenekleri simgesi, simge verilerinde yer alan "X konumu" ve "Y konumu" özellikleriyle belirtilen konumda ve yoğunluktan bağımsız piksellerde (DP) genişlik ve yükseklik özellikleriyle tanımlanan boyutta gösterilmelidir.
Reklam Seçenekleri simgesi, diğer reklam yer paylaşımları veya arayüz öğeleri tarafından engellenmemelidir.
Tıklama desteği veya eşdeğeri (ör. dokunma ya da uzaktan seçme) olan platformlarda Reklam Seçenekleri simgesi tıklanabilir olmalıdır.
Tarayıcı desteği olan platformlarda, Reklam Seçenekleri simgesi tıklandığında "ClickThrough" veya "click_data" özelliğinde belirtilen URL'yi içeren bir tarayıcı sekmesi ya da penceresi açılmalıdır.
Tarayıcı desteği olmayan platformlarda Reklam Seçenekleri simgesi tıklandığında, "IconClickFallbackImage" veya "click_fallback_images" özelliğinde belirtilen resimlerden birini gösteren bir modal yer paylaşımı açılmalıdır.
Tarayıcı desteği olmayan platformlarda, yedek resim "IconClickFallbackImage" veya "click_fallback_images" özelliğinde belirtilen boyutta, yoğunluktan bağımsız pikseller (DP) cinsinden gösterilmelidir.

VAST XML yanıtından Reklam Seçenekleri'ni ayrıştırma

XML reklam yanıtıyla çalışırken Reklam Seçenekleri yalnızca VAST 3.0 ve sonraki sürümlerde desteklenir. Reklam Seçenekleri, VAST simgesi olarak uygulanır.

VAST 4.2

XML reklam yanıtınız VAST 4.2 standardına uyuyorsa, Reklam Seçenekleri, VAST simgesi olarak yayınlanır. Uygulamanız veya web siteniz VAST 4.2 simgelerini (VAST 4.2 standardının 3.11. bölümü) tam olarak destekliyorsa Reklam Seçenekleri desteği için başka bir işlem yapmanız gerekmez.

Uygulamanız VAST 4.2 simgelerini desteklemiyorsa bu standarda göre VAST yanıtınızdaki "GoogleWhyThisAd" program adıyla simgeleri manuel olarak ayrıştırmanız gerekir. Uygulamanızda ek testler yapmak için bu örnek VAST 4.2 xml dosyasını kullanabilirsiniz.

Örnek VAST 4.2 yanıtı

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
  <Ad id="20011">
    <Wrapper>
      ...
      <Creatives>
        ...
        <Creative id="5480" sequence="1">
          ...
          <Linear>
            ...
            <Icons>
              ...
              <Icon program="GoogleWhyThisAd" width="40" height="30" xPosition="left" yPosition="100" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="AdChoices icon">
                <StaticResource creativeType="image/png">
                  <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png ]]>
                </StaticResource>
                <IconClicks>
                  <IconClickThrough>
                    <![CDATA[ https://g.co/adsettings ]]>
                  </IconClickThrough>
                  <IconClickFallbackImages>
                    <IconClickFallbackImage width="950" height="600">
                      <AltText>
                        <![CDATA[ This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing. ]]>
                      </AltText>
                      <StaticResource creativeType="image/png">
                        <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png ]]>
                      </StaticResource>
                    </IconClickFallbackImage>
                    ...
                  </IconClickFallbackImages>
                </IconClicks>
              </Icon>
              ...
            </Icons>
            ...
          </Linear>
          ...
        </Creative>
        ...
      </Creatives>
      ...
    </Wrapper>
    ...
  </Ad>
</VAST>

VAST 3.0

XML reklam yanıtınız VAST 3.0 standardına uygunsa Reklam Seçenekleri, VAST simgesi ve özel VAST uzantısının birleşimi olarak yayınlanır. Uygulamanız veya web siteniz VAST 3.0 simge standardını tam olarak destekliyorsa ve platform, simge tıklama URL'sine gidebiliyor ve bu URL'yi görüntüleyebiliyorsa Reklam Seçenekleri desteği için başka bir işlem yapmanız gerekmez.

Platformunuz tıklama URL'lerine gidemiyor ve bunları görüntüleyemiyorsa (bu durum, entegre web tarayıcısı olmayan cihazlar için geçerlidir) "IconFallbackImages" uzantısı için destek uygulamanız gerekir. Bu uzantı, "program" özelliğinin VAST'a dahil edilen bir simgeyle eşleştiği bir dizi "IconFallbackImages" etiketi içerir.

Reklam Seçenekleri'ni tam olarak desteklemek için program adı "GoogleWhyThisAd" olan IconFallbackImages etiketi, program adı "GoogleWhyThisAd" olan simgeyle ilişkilendirilmelidir. Böylece kullanıcı simgeyle etkileşim kurduğunda ilişkili yedek resim gösterilir.

Reklam Seçenekleri standardında gelecekte yapılabilecek olası değişiklikleri desteklemek için, kullanılabilir olduğunda tüm VAST simgeleri için yedek resim desteğini eklemenizi önemle tavsiye ederiz. Uygulamanızda ek testler yapmak için bu örnek VAST 3.0 xml dosyasını kullanabilirsiniz.

IconFallbackImages Uzantı Yapısı

Etiket	Özellikler	Açıklama
Uzantı	tür	Bu uzantı için tür her zaman `IconClickFallbackImages` değerini içerir.
-IconClickFallbackImages	program	Bu özellik, her zaman ilişkili bir VAST 3.0 simgesinin program özelliğiyle eşleşir.
-IconClickFallbackImages		Bu düğümün yapısı, `program` özelliğinin eklenmesi dışında IconClickFallbackImages için VAST 4.2 standardıyla eşleşir.
--IconClickFallbackImage	genişlik	Resmi görüntülemek için tercih edilen genişlik.
--IconClickFallbackImage	yükseklik	Resmi görüntülemek için tercih edilen yükseklik.
---AltText		Resmin erişilebilir açıklaması.
---StaticResource	creativeType	Yedek resmin MIME türü.
---StaticResource		Yedek resmin URL'sini içeren bir CDATA değeri.

Örnek VAST 3.0 Yanıtı

<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
 <Ad id="123456">
  <InLine>
   ...
   <Creatives>
    ...
    <Creative id="7891011" AdID="ABCD123456EF" sequence="1">
     ...
     <Linear>
      ...
      <Icons>
       ...
       <Icon program="GoogleWhyThisAd" width="50" height="50" xPosition="20" yPosition="bottom" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="Why This Ad?">
        <StaticResource creativeType="image/png">
         <![CDATA[https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png]]>
        </StaticResource>
        <IconClicks>
         ...
         <IconClickThrough><![CDATA[https://g.co/adsettings]]></IconClickThrough>
        </IconClicks>
       </Icon>
       ...
      </Icons>
     ...
     </Linear>
     ...
    </Creative>
    ...
   </Creatives>
   <Extensions>
    ...
    <Extension type="IconClickFallbackImages">
     ...
     <IconClickFallbackImages program="GoogleWhyThisAd">
      <IconClickFallbackImage width="400" height="150">
       <AltText>Alt icon fallback</AltText>
       <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/gvabox/nickchavez/media/png/wta_dialog.png]]></StaticResource>
      </IconClickFallbackImage>
      ...
     </IconClickFallbackImages>
     ...
    </Extension>
    ...
   </Extensions>
   ...
  </InLine>
  ...
 </Ad>
</VAST>

DAI API meta verileri JSON'ından Reklam Seçenekleri'ni ayrıştırma

DAI API ile çalışırken AdChoices ayrıntıları, metadata URL'sine yapılan istekler tarafından döndürülen JSON nesnesi aracılığıyla iletilir.

Meta veri JSON nesnesi, adID ile anahtarlanmış bir reklam listesi içerir. Her reklam nesnesinde bir simge dizisi bulunur. Söz konusu reklamda Reklam Seçenekleri kullanılıyorsa Reklam Seçenekleri simgesi bu dizide yer alır.

JSON simge biçimi

JSON simge biçimi, mümkün olduğunda VAST 4.2 simge standardının (bölüm 3.11) 1:1 çevirisidir. Ancak daha katı JSON biçimini desteklemek için bazı özelliklerin adı gerektiğinde değiştirildi.

Simge JSON biçimi

program	Reklam Seçenekleri simgesi için bu değer her zaman "GoogleWhyThisAd" dizesini içerir.
x_position	Simgenin sol üst köşesinin, video reklam öğesinin sol üst köşesine göre yatay konumu (piksel cinsinden). Bu alan, duyarlı konum değerleri olan "sağ" veya "sol" değerlerini de kabul eder.
y_position	Simgenin sol üst köşesinin, video reklam öğesinin sol üst köşesine göre dikey konumu (piksel cinsinden). Bu alan, duyarlı konum değerleri olan "top" (üst) veya "bottom" (alt) değerlerini de kabul eder.
genişlik	Simgenin piksel cinsinden genişliği.
yükseklik	Simgenin piksel cinsinden yüksekliği.
creative_type	Simge için sağlanan resmin MIME türü. Varsayılan olarak "image/png" değerine ayarlanır.
kaynak	Reklam Seçenekleri simgesini almak için kullanılan URL.
alt_text	Reklam Seçenekleri simgesi için oluşturulacak alternatif metin.
click_data	Web'de gezinmeyi destekleyen bir platformda Reklam Seçenekleri simgesini tıklayan izleyicileri yönlendirecek URL'yi temsil eden `click_data.url` özelliğini içeren bir nesne.
click_fallback_images	Web'de gezinmeyi desteklemeyen platformlarda AdChoices simgesini tıklayan kullanıcılara gösterilecek bir dizi resim nesnesi.

Yedek resim JSON biçimi

genişlik	Yedek resmin piksel cinsinden genişliği.
yükseklik	Yedek resmin piksel cinsinden yüksekliği.
creative_type	Yedek resmin MIME türü. Varsayılan olarak "image/png" değerine ayarlanır.
kaynak	Yedek resmi almak için kullanılan URL.
alt_text	Yedek resim için oluşturulacak alternatif metin.

Örnek meta veri JSON'u

{
  ...
  "ads": {
    ...
    "0002640412_ad1": {
      ...
      "icons": [
        ...
        {
          "alt_text": "AdChoices icon",
          "click_data": {
            "url": "https://g.co/adsettings"
          },
          "click_fallback_images": [
            {
              "alt_text": "This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing.",
              "creative_type": "image/jpg",
              "height": 600,
              "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png",
              "width": 950
            }
          ],
          "creative_type": "image/png",
          "height": 30,
          "program": "AdChoices",
          "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png",
          "type": "static",
          "width": 40,
          "x_position": "0",
          "y_position": "100"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}