Bu sayfa, Cloud Translation API ile çevrilmiştir.

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 ("Neden bu Reklam?" olarak da adlandırılır), kullanıcılara neden belirli bir reklamın gösterildiğini açıklayan ve gizliliklerinin nasıl korunduğu hakkında bilgi veren şeffaflık özelliğidir.

Daha fazla bilgi için Neden bir reklam görüyorsunuz? bölümüne bakın.

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 doğru bir şekilde uygulamak için gerekli bilgileri nasıl çıkaracağınız açıklanmaktadır.

Reklam Seçenekleri oluşturma koşulları

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

Reklam Seçenekleri simgesi, sağlandığı herhangi bir reklamla yer paylaşımlı olarak gösterilmelidir
Reklam Seçenekleri simgesi, simge verilerine dahil edilen "X konumu" ve "Y konumu" özellikleriyle belirtilen konumda, Yoğunluktan Bağımsız Piksellerde (DP) ise genişlik ve yükseklik özellikleriyle tanımlanan boyutta görüntülenmelidir.
Reklam Seçenekleri simgesi, diğer reklam yer paylaşımları veya arayüz öğeleri tarafından gizlenmemelidir.
Tıklama desteği veya eşdeğeri (ör. dokunma veya uzaktan seçme) içeren 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 veya 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örüntüleyen kalıcı bir yer paylaşımı açılmalıdır.
Tarayıcı desteği olmayan platformlarda yedek resim, Yoğunluktan Bağımsız Piksellerde (DP) "IconClickFallbackImage" veya "click_fallback_images" özelliğinde belirtilen boyutta gösterilmelidir.

VAST XML yanıtından Reklam Seçeneklerini ayrıştırma

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

VAST 4.2

XML reklam yanıtınız VAST 4.2 standardını karşılıyorsa Reklam Seçenekleri, VAST Simgesi olarak sunulur. Uygulamanız veya web siteniz VAST 4.2 Simgelerini tam olarak destekliyorsa (VAST 4.2 standardının 3.11 bölümü) 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, "GoogleWhyThisAd" olan simgeleri VAST yanıtınızdan manuel olarak ayrıştırmanız gerekir. Uygulamanızda ek test 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ını karşılıyorsa Reklam Seçenekleri, bir VAST Simgesi ve özel VAST uzantısının kombinasyonu olarak sunulur. Uygulamanız veya web siteniz VAST 3.0 Simge standardını tam olarak destekliyorsa ve platform, simge tıklama URL'sine gidebiliyor ve simge tıklama URL'sini görüntüleyebiliyorsa Reklam Seçenekleri desteği için başka bir işlem yapılması gerekmez.

Platformunuz tıklama URL'lerine gidemiyor ve bunları gösteremiyorsa (bu, öncelikli olarak 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 "IconFallbackImages" etiket grubu içerir.

Reklam Seçenekleri'ni tam olarak desteklemek için "GoogleWhyThisAd" program adına sahip iconFallbackImages etiketi, Simge ile "GoogleWhyThisAd" program adıyla ilişkilendirilmelidir. Böylece, kullanıcı simgeyle etkileşime geçtiğinde ilişkili yedek resim gösterilir.

Reklam Seçenekleri standardında gelecekte yapılabilecek değişiklikleri desteklemek için, mümkün olduğunda tüm VAST Simgelerine yedek resim desteği eklemenizi önemle tavsiye ederiz. Uygulamanızda ek test için bu örnek VAST 3.0 xml'sini kullanabilirsiniz.

SimgesiFallbackImages Uzantı Yapısı

Etiket	Özellikler	Açıklama
Uzantı	tür	Bu uzantı için tür her zaman `IconClickFallbackImages` değerini içerir.
-IconClickYedekResimler	program	Bu özellik, ilişkilendirilmiş VAST 3.0 simgesinin program özelliğiyle her zaman eşleşir.
-IconClickYedekResimler		Bu düğümün yapısı, `program` özelliğinin eklenmesi dışında IconClickFallbackImages için VAST 4.2 standardıyla eşleşir.
--SimgeTıklamaYedekResim	genişlik	Resmin görüntülenmesi için tercih edilen genişlik.
--SimgeTıklamaYedekResim	yükseklik	Resmin görüntülenmesi 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>

Reklam Seçeneklerini DAI API meta verileri JSON dosyasından ayrıştırma

DAI API'si ile çalışırken Reklam Seçenekleri ayrıntıları, meta veri URL'sine istekler tarafından döndürülen JSON nesnesi üzerinden iletilir.

Metadata JSON nesnesi, adID tarafından belirlenen bir reklam listesi içerir. Her reklam nesnesinin içinde bir simge dizisi bulunur. Söz konusu reklam Reklam Seçenekleri'ni kullanıyorsa bu dizide Reklam Seçenekleri simgesi yer alır.

JSON simge biçimi

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

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 piksel cinsinden yatay konumu. Bu alan, "right" veya "left" duyarlı konum değerlerini de kabul eder.
y_position	Simgenin sol üst köşesinin, video reklam öğesinin sol üst köşesine göre piksel cinsinden dikey konumu. Bu alan, "top" (üst) veya "bottom" (alt) duyarlı konum 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 değer "image/png"dir.
kaynak	Reklam Seçenekleri simgesini alacak 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 izleyicilerin yönlendirileceği URL'yi temsil eden `click_data.url` mülkünü içeren bir nesne.
click_fallback_images	Web'de gezinmeyi desteklemeyen platformlarda, Reklam Seçenekleri simgesini tıklayan izleyicilere gösterilecek bir resim nesneleri dizisidir.

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 değer "image/png"dir.
kaynak	Yedek resmin alınacağı URL.
alt_text	Yedek resim için oluşturulacak alternatif metin.

Örnek Meta Veri JSON Örneği

{
  ...
  "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}