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 AdChoices simgesi ve Google tarafından sağlanır. Reklam Seçenekleri ("Neden bu reklam?" olarak da adlandırılır) kullanıcılara neden kendilerine reklam gösterildiğini açıklayan ve gizliliğinin nasıl korunduğuyla ilgili bilgi verir.

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

Bu kılavuzda, doğru bir şekilde araştırma yapmak için gereken bilgileri reklamınızın VAST XML yanıtından veya DAI akışınızın meta veri yanıtı.

Reklam Seçenekleri oluşturma koşulları

Google'ın Reklam Seçenekleri simgelerini oluşturma şartlarına uymak için uygulama veya Web sitesi aşağıdaki standartları karşılamalıdır:

Reklam Seçenekleri simgesi, bulunduğu tüm reklamların yer paylaşımı üzerine görüntülenmelidir. sağlandı
Reklam Seçenekleri simgesi "X" ile belirtilen konumda görüntülenmelidir. konum" ve "Y konumu" özellikleri ve Yoğunluktan bağımsız olarak genişlik ve yükseklik özellikleriyle tanımlanan boyut Pikseller (DP).
Reklam Seçenekleri simgesi, diğer reklam yer paylaşımları veya arayüz tarafından gizlenmemelidir öğeler.
Tıklama desteği veya eşdeğeri (ör. dokunma veya uzaktan seçme) olan platformlarda, Reklam Seçenekleri simgesi tıklanabilir olmalıdır.
Tarayıcı destekli platformlarda Reklam Seçenekleri simgesi tıklandığında, tarayıcı "Tıklama" bölümünde belirtilen URL'ye sahip bir tarayıcı sekmesi veya penceresi veya "tıklama_verileri"
Tarayıcı desteği olmayan platformlarda Reklam Seçenekleri simgesi tıklandığında, tarayıcı Google Etiket Yöneticisi'nde belirtilen resimlerden birini gösteren "IconClickFallbackImage" veya "click_fallback_images"
Tarayıcı desteği olmayan platformlarda yedek resim "IconClickFallbackImage" içinde belirtilen boyut veya "tıklama_fallback_resimleri" özelliğindeki değerleri, Yoğunluktan Bağımsız Pikseller (DP) cinsinden gösterir.

Reklam Seçeneklerini VAST XML yanıtından 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'yi takip ediyorsa standart ise Reklam Seçenekleri, VAST Simgesi olarak sunulur. Uygulamanız veya web siteniz tam olarak destekliyorsa VAST 4.2 Simgeleri (VAST 4.2 standardının 3.11 bölümü), Reklam Seçenekleri desteği başka bir işlem yapmanız gerekmez.

Uygulamanız VAST 4.2 simgelerini desteklemiyorsa simgeleri manuel olarak ayrıştırmanız gerekir program adı: "GoogleWhyThisAd" bununla ilgili olarak VAST yanıtınızdan standart. Bu örneği (VAST 4.2 xml) 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ı bir "IconFallbackImages" grubu içeriyor "programın" olduğu özelliği, VAST'ta bulunan bir simgeyle eşleşir.

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 değişiklikleri desteklemek için yalnızca aşağıdaki durumlarda, tüm VAST Simgeleri için yedek resim desteğinin kullanılabilir. 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`
-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ı, şunun için VAST 4.2 standardıyla eşleşir: iconClickFallbackImages, (`program` öğesinin eklenmesi hariç) özelliğini gönderin.
--IconClickFallbackImage	genişlik	Resmin görüntülenmesi tercih edilen genişlik.
--IconClickFallbackImage	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 ile çalışırken API, Reklam Seçenekleri ayrıntıları meta verilere isteklerin döndürdüğü JSON nesnesi aracılığıyla iletilir URL.

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, VAST 4.2 simgesinden standart (bölüm 3.11)'i (Bölüm 3.11) geçerli kılmayı unutmayın. 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 yatay konuma göre konumu video reklam öğesinin piksel cinsinden sol üst köşesinde görünür. 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 piksel cinsinden sol üst köşesinde görünür. Bu alan ayrıca duyarlı konum değerleri "üst" veya "alt" olarak değiştirin.
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" kullanılır.
kaynak	Reklam Seçenekleri simgesini alacak URL.
alt_text	Reklam Seçenekleri simgesi için oluşturulacak alternatif metin.
click_data	`click_data.url` özelliğini içeren bir nesne "Reklam Seçenekleri" simgesini tıkladıklarında izleyicilerin yönlendirileceği URL'yi web'de gezinmeyi destekleyen bir platform.
click_fallback_images	Reklam Seçenekleri'ni tıklayan izleyicilere gösterilecek resim nesneleri dizisi Web'de gezinmeyi desteklemeyen platformlarda simge

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" kullanılır.
kaynak	Yedek resmin alınacağı URL.
alt_text	Yedek resim için oluşturulacak alternatif metin.

Örnek Meta Veri JSON Dosyası

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