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 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 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 simgesi tıklandığında, tarayıcı "Tıklama" bölümünde belirtilen URL'ye sahip bir tarayıcı sekmesi veya penceresi veya "click_data"
- 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" veya "click_fallback_images" mülkünde belirtilen boyutta, Yoğunluktan Bağımsız Piksel (DP) cinsinden görüntülenmelidir.
Reklam Seçeneklerini VAST XML yanıtından 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ını uyguluyorsa Reklam Seçenekleri bir VAST simgesi olarak yayınlanır. 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 simgelerin VAST yanıtınızdaki "GoogleWhyThisAd" program adıyla bu standarda göre manuel olarak ayrıştırılması gerekir. 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 standardını karşılıyorsa Reklam Seçenekleri, VAST simgesi ve özel VAST uzantısının bir kombinasyonu 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 gidip bu URL'yi gösterebiliyorsa 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 öncelikle entegre web tarayıcısı olmayan cihazlar için geçerlidir) "IconFallbackImages" uzantısı için destek uygulamanız gerekir. Bu uzantı bir "IconFallbackImages" grubu içeriyor "programın" olduğu özelliği, VAST'ta bulunan bir simgeyle eşleşir.
Reklam Seçenekleri'nin tam olarak desteklenmesi için "GoogleWhyThisAd" program adına sahip IconFallbackImages etiketi, "GoogleWhyThisAd" program adına sahip 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, 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 .
IconFallbackImages Uzantısı 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. |
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. |
yükseklik | Resmin gösterilmesi için tercih edilen yükseklik. | |
---AltText | Resmin erişilebilir açıklaması. | |
---StaticResource | creativeType | Yedek resmin mime türü. |
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 veri JSON'undan AdChoices'ı 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 reklam nesnesinde bir simge dizisi bulunur. Söz konusu reklam Reklam Seçenekleri'ni kullanı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ı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 yatay konuma göre konumu video reklam öğesinin piksel cinsinden sol üst köşesinde görünür. Bu alan, "right" veya "left" (sağ veya sol) duyarlı konum 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, "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 almak için kullanılan 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 | 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"
}
...
]
...
},
...
}
...
}