Android'de Mobil Uygulamalarda AFSMA (AFSMA) Uygulaması

Ön koşullar

Bu uygulama kılavuzunda, aşağıdaki konularda bilgi sahibi olduğunuz varsayılır:

Sınıflar

Uygulamanızda AFSMA reklamları (dinamik yükseklik arama ağı reklamları olarak da bilinir) yayınlamak için: şu sınıfları uygulayın:

SearchAdView

  • Bu sınıf, Android ViewGroup sınıfından devralınıyor ve AFSMA reklamlarını gösterir. SearchAdView, DynamicHeightSearchAdRequest ve döndürülen reklamları oluşturur. SearchAdView, uygulamanın mevcut görünüm gruplarından herhangi birine eklenmelidir.
  • SearchAdView, bağlamla örneklenmelidir SearchAdView, genellikle Activity türündedir.
  • SearchAdView örneklendirildikten sonra setAdSize() yöntemini çağırmanız gerekir AdSize.SEARCH ile AFSMA reklamları isteyin. Diğer sıralama değerleri, Mobil Uygulamalar için AFS ile uyumlu olmayan reklamları ister.
  • Mülk kodunuzla bu nesnedeki setAdUnitId() yöntemini çağırın.

DynamicHeightSearchAdRequest.Builder

  • Bu sınıf, reklam isteği parametrelerini içerir. Bu, JavaScript reklam isteği nesnelerindeki parametreleri ayarlamaya benzer (sayfa seçenekleri, birim seçenekleri) girin.
  • Parametreleri uygun belirleyicilerle belirleyin (yani sorgu parametresini ayarlamak için setQuery() yöntemini çağırın).

Örnek uygulama

Aşağıdaki örnekte, SearchAdView oluşturmak için Activity kullanımı gösterilmektedir bir ViewGroup alt görünümü olarak. AFSMA reklamlarını doğru şekilde istemek için SearchAdView nesne, AdSize.SEARCH ile setAdSize() yöntemini çağırmalıdır.

//  MainActivity.java implementation
//  (MainActivity is a subclass of Activity)

// Create the SearchAdView
final SearchAdView searchAdView = new SearchAdView(this);

// Set parameter to request for dynamic height search ads
searchAdView.setAdSize(AdSize.SEARCH); // Important!

// Replace with your pub ID (e.g. ms-app-pub-9616389000213823)
searchAdView.setAdUnitId("ms-app-pub-################");

// Add searchAdView to parent view group
...

Aynı Activity içinde, şu özelliklere sahip bir DynamicHeightSearchAdRequest.Builder oluşturun: SearchAdView içinde oluşturulacak reklamın parametrelerini belirtir. AFSMA reklamları, AFS Özel Arama Reklamları ile aynı şekilde yapılandırılır; AFS Özel Arama Reklamları'nı görebilirsiniz. Referans inceleyebilirsiniz.

// Create the ad request
DynamicHeightSearchAdRequest.Builder builder =
        new DynamicHeightSearchAdRequest.Builder();
builder.setQuery("flowers");
builder.setNumber(2);

// Replace with the ID of a style from your custom search styles
builder.setAdvancedOptionValue("csa_styleId", "0000000001");

// Customization options (set using setters on
// DynamicHeightSearchAdRequest.Builder)
builder.setAdTest(true);

Diğer özelleştirme seçenekleri, DynamicHeightSearchAdRequest.Builder nesnesini tanımlayın.

Reklam isteğinde bulunmak için loadAd() yöntemini SearchAdView nesnesindeki DynamicHeightSearchAdRequest.Builder nesne:

searchAdView.loadAd(builder.build());

Gelişmiş seçenekler

Reklam isteği parametrelerinin çoğu, belirleyici yöntemlerle ayarlanabilir. DynamicHeightSearchAdRequest.Builder nesnesinin üzerine getirin. Bir setter yöntemi olmayan tüm parametreler DynamicHeightSearchAdRequest.Builder, setAdvancedOptionValue() yöntemidir. AFS Özel Arama Reklamları'nı inceleyin Referans için setAdvancedOptionValue() yöntemi.

Anahtar parametresi "csa_" ön ekini almalıdır değerini girin.

// Advanced customization options (set using key-value pair)

// Set a parameter (parameter_name) and its value (parameter_value)
// builder.setAdvancedOptionValue("csa_parameter_name", "parameter_value");

// Example: Show visible URL below description
// (domainLinkAboveDescription: false)
builder.setAdvancedOptionValue("csa_domainLinkAboveDescription", "false");

Bir parametrenin setter yöntemini kullanır ve setAdvancedOptionValue ile ayarlarsanız ikinci çağrı, ilk çağrının değerini geçersiz kılar.

Hataları inceleme

SearchAdView (burada searchAdView) bir setAdListener() yöntemi içerir 'ni kullanabilirsiniz. Aynı Activity içinde:

searchAdView.setAdListener(new AdListener() {
    @Override
    public void onAdLoaded() {
        // Called when an ad is loaded
        super.onAdLoaded();
        Toast.makeText(MainActivity.this, "Ad Loaded",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Loaded");
    }

    @Override
    public void onAdOpened() {
        // Called when an ad opens an overlay that covers the screen
        super.onAdOpened();
        Toast.makeText(MainActivity.this, "Ad Opened",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Opened");
    }

    @Override
    public void onAdLeftApplication() {
        // Called when an ad leaves the application
        // (to go to the browser for example)
        super.onAdLeftApplication();
        Toast.makeText(MainActivity.this, "Ad Left Application",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Left Application");
    }

    @Override
    public void onAdFailedToLoad(int errorCode) {
        // Called when an ad request failed
        super.onAdFailedToLoad(errorCode);
        Toast.makeText(MainActivity.this, "Ad Failed to Load: " + errorCode,
                Toast.LENGTH_SHORT).show();
        Log.e(MainActivity.class.getSimpleName(), "Ad Failed to Load: " +
                errorCode);
    }
});

onAdFailedToLoad() geri çağırma yönteminde kullanılan sabitler hakkında daha fazla bilgi için referans.

Google Play'in veri açıklama şartlarına hazırlanma

Mayıs 2021'de Google Play yeni Veri Güvenliği bölümünü duyurdu. Bu bölüm, uygulamaların veri toplama, paylaşma ve güvenlik yöntemleri hakkında geliştirici tarafından sağlanan bir açıklamadır.

Bu sayfa, AFS Yerel SDK'sını (Alışveriş için AdSense kullanımında da geçerlidir) kullanımınızla ilgili olarak bu veri açıklamasındaki şartları yerine getirmenize yardımcı olabilir. Bu sayfada, SDK'larımızın son kullanıcı verilerini işleyip işlemediği ve nasıl işlediği hakkında bilgi edinebilirsiniz.

Size destek verirken mümkün olduğunca şeffaf olmayı amaçlıyoruz. Ancak uygulama geliştirici olarak uygulamanızın son kullanıcı verilerini toplama, paylaşma ve güvenlik yöntemleri konusunda Google Play'in Veri Güvenliği bölümü formuna nasıl yanıt vereceğinize karar vermek tamamen sizin sorumluluğunuzdadır.

Bu sayfadaki bilgiler nasıl kullanılır?

Bu sayfada, SDK'nın yalnızca son sürümü tarafından toplanan son kullanıcı verileri listelenmektedir.

Verilerle ilgili açıklamanızı tamamlamak için, toplanan verileri en iyi tanımlayan veri türünü belirlemenize yardımcı olması amacıyla Android'in veri türleri hakkındaki rehberini kullanabilirsiniz. Verilerle ilgili açıklamada, söz konusu uygulamanızın toplanan verileri nasıl paylaştığını ve kullandığını da belirttiğinizden emin olun.

SDK'nın eriştiği ve topladığı veri türü

Paketler:

com.google.android.gms:play-services-afs-native

com.google.ads.afsn

Otomatik olarak toplanan veriler

AFS SDK'sı aşağıdaki verileri otomatik olarak toplar. Tüm veriler reklam sunmak amacıyla cihazdan Google'a iletilir ve veriler aktarım sırasında şifrelenir. Kullanıcının kişisel bilgileri, uygulamanız tarafından bir kullanıcı sorgusunda gönderilmediği sürece hiçbir zaman toplanmaz.

Veriler Bu veriler aşağıdaki amaçlar doğrultusunda toplanır...
IP adresi Özet: 'nı inceleyin.
  • Sahtekarlığı önleme, güvenlik ve kanunlara uygunluk
  • Reklam veya pazarlama
  • Yaklaşık konum alma
ziyaret edin. Ayrıntı:
IP adresi, sahtekarlık ve kötüye kullanımın izlenmesinin yanı sıra kullanıcının konumunu yaklaşık olarak belirlemek için de kullanılır.

Daha sonra yaklaşık konum, sunulan reklamların yerel düzenlemelere uygun olmasını sağlamak ve bir kullanıcının yaklaşık coğrafi konumuyla alakalı reklamlar sunmak için kullanılır.

Uygulama etkinliği
  • Uygulamada yapılan sayfa görüntüleme ve dokunma işlemleri
  • Uygulama içi arama geçmişi
Özet: 'nı inceleyin.
  • Analiz
  • Sahtekarlığı önleme, güvenlik ve kanunlara uygunluk
  • Reklam veya pazarlama
  • Kişiselleştirme
ziyaret edin. Ayrıntı:
Anahtar kelimeyle alakalı Arama Ağı Reklamları döndürebilmemiz için uygulamanız bize kullanıcının sorgusunu sağlar. Döndürülen reklamlarla görüntüleme sayısını ve etkileşimi (dokunma) ölçeriz.
Teşhis Özet: 'nı inceleyin.
  • Analiz
ziyaret edin. Ayrıntı:
SDK, ürün iyileştirmelerinin uygulanması ve ölçülmesi için reklamların oluşturma gecikmesini ölçer. Ayrıca, işlevselliğin yayıncılar tarafından nasıl kullanıldığını anlamak için gerektiğinde kilitlenme/hata raporları gönderir ve gerektiğinde başka araçlar da ekleriz.
Cihaz veya diğer tanımlayıcılar Özet: 'nı inceleyin.
  • Sahtekarlığı önleme, güvenlik ve kanunlara uygunluk
  • Reklam veya pazarlama
ziyaret edin. Ayrıntı:
Cihaz kimliği, sahtekarlık ve kötüye kullanımı izlemenin yanı sıra reklam performansı ölçümüne yardımcı olmak için kullanılır.