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 Reklam Seçenekleri simgesini ve yer paylaşımını uygulamalıdır. Reklam Seçenekleri ("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 bir şeffaflık özelliğidir.

Daha fazla bilgi için Neden bir reklam'ı tıklayın.

Bu kılavuzda, reklamınızın VAST XML yanıtından veya DAI akışınızın meta veri yanıtından AdChoices'ı doğru şekilde uygulamak için gerekli bilgilerin nasıl ayıklanacağı açıklanmaktadır.

AdChoices oluşturma koşulları

Google'ın AdChoices simgelerini oluşturmayla ilgili koşullarını karşılamak 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 üzerine yerleştirilerek gösterilmelidir.
Reklam Seçenekleri simgesi, simge verilerine dahil edilen "X konumu" ve "Y konumu" özellikleriyle belirtilen konumda ve genişlik ile yükseklik özellikleriyle tanımlanan boyutta, Yoğunluk Bağımsız Piksel (DP) cinsinden gösterilmelidir.
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çim) olan platformlarda Reklam Seçenekleri simgesi tıklanabilir olmalıdır.
Tarayıcı desteği olan platformlarda, Reklam Seçenekleri simgesinin tıklanması "ClickThrough" veya "click_data" özelliğinde belirtilen URL'yi içeren bir tarayıcı sekmesi ya da penceresi açmalıdır.
Tarayıcı desteği olmayan platformlarda, Reklam Seçenekleri simgesinin tıklanması modal yer paylaşımı açmalıdır. Bu yer paylaşımında, "IconClickFallbackImage" veya "click_fallback_images" mülkünde belirtilen resimlerden biri gösterilir.
Tarayıcı desteği olmayan platformlarda yedek resim, "IconClickFallbackImage" veya "click_fallback_images" mülkünde belirtilen boyutta, Yoğunluktan Bağımsız Piksel (DP) cinsinden görüntülenmelidir.

VAST XML yanıtından AdChoices'ı ayrıştırma

XML reklam yanıtıyla çalışırken Reklam Seçenekleri yalnızca VAST'ta desteklenir 3.0 veya üzeri sürümlerden biri yüklü olmalıdır. Reklam Seçenekleri, VAST simgesi olarak uygulanır.

VAST 4.2

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

Uygulamanız VAST 4.2 simgelerini desteklemiyorsa simgelerin VAST yanıtınızdaki "GoogleWhyThisAd" program adıyla bu standarda göre manuel olarak ayrıştırılması 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'ı takip ediyorsa standart ise Reklam Seçenekleri VAST Simgesi ve özel bir VAST uzantısının kombinasyonu olarak sunulur. Eğer Uygulama veya web sitesi, VAST 3.0 Simge standardını tam olarak destekler ve platform, tıklama URL'sine gidip bu URL'yi görüntüleyebiliyorsanız, Reklam Seçenekleri, başka bir işlem yapmanız gerekmez.

Platformunuz tıklamaya gidemiyor ve tıklamayı görüntüleyemiyorsa URL'ler: Bu öncelikle entegre bir web sitesine sahip olmayan cihazlar için geçerlidir. tarayıcı—"IconFallbackImages" için destek uygulamanız gerekir uzantısına sahip olur. Bu uzantı, "program" özelliğinin VAST'a dahil edilen bir simgeyle eşleştiği bir dizi "IconFallbackImages" etiketi içerir.

AdChoices'ı tam olarak desteklemek için iconFallbackImages etiketinde program adını "GoogleNedenBuReklam" program adıyla simgeyle ilişkilendirilmelidir "GoogleWhyThisAd" içerir. Böylece kullanıcı simgeyle etkileşim kurduğunda ilişkili yedek resim görüntülenir.

Reklam Seçenekleri standardında gelecekte yapılabilecek olası değişiklikleri desteklemek için, mümkün olduğunda tüm VAST simgeleri için yedek resim desteği eklemenizi önemle tavsiye ederiz. Bu örneği kullanabilirsiniz: VAST 3.0 XML .

SimgeFallbackImages 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'ın program özelliğiyle eşleşir 3.0 Simgesi.
-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	Resmin gösterilmesi için tercih edilen genişlik.
--IconClickFallbackImage	yükseklik	Resmin gösterilmesi 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 ile çalışırken AdChoices ayrıntıları, meta veri URL'sine yapılan istekler tarafından döndürülen JSON nesnesi üzerinden iletilir.

Metadata JSON nesnesi, adID'ye göre anahtarlanan bir reklam listesi içerir. Her bir ad nesnesi bir simge dizisidir. Söz konusu reklam Reklam Seçenekleri'ni kullanıyorsa Reklam Seçenekleri simgesi bu dizide yer alır.

JSON simgesi 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'ı desteklemek için biçiminde, bazı özelliklerin gerektiğinde adı değişmiştir.

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 ayrıca şunları da kabul eder: duyarlı konum değerleri "right" veya "left".
y_position	Simgenin sol üst köşesinin, video reklam öğesinin sol üst köşesine göre dikey konumu (piksel cinsinden). 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 olarak "image/png" değerine ayarlanır.
kaynak	Reklam Seçenekleri simgesini alacak URL.
alt_text	Reklam Seçenekleri simgesi için oluşturulacak alternatif metin.
click_data	Web tarayıcısını destekleyen bir platformda kullanıcılar Reklam Seçenekleri simgesini tıkladığında kullanıcıları yönlendirilecek URL'yi temsil eden `click_data.url` mülkünü içeren bir nesne.
click_fallback_images	Web tarayıcısını desteklemeyen platformlarda AdChoices simgesini tıklayan izleyicilere gösterilecek bir resim nesnesi dizisi.

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