Başlarken

Bu belge, AdSense hesapları hakkında bilgi almak için AdSense Management API'yi kullanmak isteyen geliştiricilere yöneliktir. Bu belgede, web programlama kavramları ve web veri biçimleri hakkında bilgi sahibi olduğunuz varsayılır.

Başlamadan önce

Bir AdSense hesabı edinin

Başlamak için kaydolun veya AdSense hesabınızda oturum açın.

AdSense'le ilgili bilgi edinin

AdSense kavramlarına aşina değilseniz AdSense'le ilgili giriş bilgileri bölümünü okuyun ve koda başlamadan önce AdSense kullanıcı arayüzü ile denemeler yapın.

İstemci kitaplığınızı seçin

İstemci Kitaplıkları ve Örnekler sayfasında, kullanılabilir kitaplıklar ve örneklerle ilgili bilgileri bulabilirsiniz. Seçtiğiniz dilin sekmesini tıklayın ve kaynağı indirmek için bağlantıları izleyin. İstemci kitaplıkları şu işlemleri sizin için yapar:

  • kimlik doğrulama
  • hizmetlerin keşfedilmesi
  • API'ye yönelik istekleri derlemek
  • yanıt ayrıştırma

Tercih ettiğiniz istemci kitaplığını yüklemek ve yapılandırmak için talimatları okuyun. Bu kitaplık, genellikle deponun kök dizinindeki BENİOKU dosyasında bulunur.

Uygulamanızın, desteklenmeyen bir dil kullanmak gibi özel ihtiyaçları varsa istemci kitaplığı kullanmak yerine API'ye doğrudan istek gönderebilirsiniz.

Uygulamanızı kaydetme

AdSense Management API'yi kullanmak için bir proje oluşturup İstemci Kimliği oluşturarak geliştirdiğiniz uygulamayı kaydetmeniz gerekir.

Uygulamanızı kaydetme

İstemci kitaplığı projenizin yapılandırma dosyalarını, az önce oluşturduğunuz yeni kimlik bilgileriyle düzenleyin. Daha fazla bilgi için istemci kitaplığı belgelerine göz atın.

Not: Kayıt için kullanılan Google Hesabı geliştirici hesabınız, yani uygulama kullanıcılarının, uygulamanın geliştiricisi olarak görmesini istediğiniz hesap olmalıdır. Kullanıcılar uygulamayı kullanırken kendi hesaplarına erişim izni vereceklerinden, bu hesabın bir AdSense giriş bilgisine bağlanması gerekmez.

Hızlı başlangıç eğitimi

İlk isteklerinizi göndermek için aşağıdaki adımları uygulayın. Bu adımların, kullandığınız kitaplığa veya dile bağlı olarak biraz farklılık gösterebileceğini unutmayın:

  1. Bir AdSense hesabından reklam istemcilerinin listesini almak için uygun örneği kullanın. Bu istek, AdSense kullanıcısının projenizin kimliğini doğrulayıp yetkilendirdiği tek seferlik bir süreci başlatır.

    Reklam müşterileri, AdSense hesabı ile bir AdSense ürünü (ör. İçerik Reklamları veya Arama Reklamları) arasındaki ilişkilendirmeyi temsil eder. Bir AdSense hesabının bir veya daha fazla reklam istemcisi olabilir.

    1. Web uygulamaları için kullanıcılar, erişim vermeyi seçebilecekleri bir siteye yönlendirilir. Yetki verildiğinde, Google API Konsolu'nda tanımlanan geri çağırma URL'sine yönlendirilirler.
    2. Yüklü uygulamalar benzer şekilde çalışır. İstemci kitaplığı bir tarayıcı penceresi açıp yetkilendirme kodu kullanmaya çalışır. Android, Chrome ve iOS uygulamaları için bu yöntem platforma özgüdür.
  2. Aşağıdaki raporu istemek için reports.generate için Google API'leri gezginini kullanın:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Raporlar size ne kadar kazandığınız ve bu kazançlar üzerindeki etkisi hakkında bilgi verir. Kanalları kullanarak bir hesabın tamamında veya reklam birimlerinin bir alt kümesinde yayınlanabilirler.

  3. Uygulamanızdan aynı raporu istemeyi deneyin.
  4. Raporları reklam birimlerine göre filtreleyebilirsiniz. adunits.list kullanarak reklam birimlerinin listesini alın. Reklam istemci kimliği gerektiğini unutmayın (bu kimliği 1. adımdan alın). Bir reklam birimi seçtikten sonra, reports.generate için filter parametresinde reklam biriminin kimliğini kullanın:

    Reklam Birimleri, reklamlar için kullanıcı tarafından yapılandırılan yer tutuculardır. Bu yer tutucular, gösterilen reklamlara ilişkin bazı özellikleri (boyut ve şekil gibi) tanımlar.

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Özel kanallara veya URL kanallarına göre filtrelemeyi ya da birden çok filtreyi karıştırmayı deneyin.

    Kanallar, reklam birimlerinizin bir alt kümesinin performansını izlemenize olanak tanıyan araçlardır. İki tür kanal vardır: URL ve özel. İlki, belirli bir sayfa veya alan genelinde performansı izlemenize olanak tanırken ikincisi, kullanıcı tarafından seçilen belirli reklam birimi gruplarındaki performansı izlemenize yardımcı olur.

Referans belgelerde diğer aramalar ve kaynaklar hakkında bilgi edinerek uygulamanızı uygulamaya başlayabilirsiniz.