Başla

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ına ve web veri biçimlerine aşina olduğunuz varsayılmaktadır.

Başlamadan önce

AdSense hesabı edinin

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

AdSense'i tanıyın

AdSense kavramlarına aşina değilseniz AdSense'le ilgili giriş bilgilerini okuyun ve kodlamaya 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 örnekler hakkında bilgi bulabilirsiniz. Seçtiğiniz dilin sekmesini tıklayın ve kaynağı indirmek için bağlantıları izleyin. İstemci kitaplıkları aşağıdaki işlemleri sizin için yapar:

  • kimlik doğrulama
  • hizmetlerin keşfi
  • API'ye istekler oluşturma
  • yanıt ayrıştırma

Seçtiğiniz istemci kitaplığını yükleme ve yapılandırmayla ilgili talimatları okuyun. Bu kitaplık genellikle deponun kök dizinindeki README dosyasında bulunur.

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

Uygulamanızı kaydetme

AdSense Management API'yi kullanmak için, geliştirmekte olduğunuz uygulamayı bir proje oluşturup bir İstemci Kimliği oluşturarak 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 ayrıntı için istemci kitaplığı belgelerini inceleyin.

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

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

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

  1. 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ğruladığı ve yetkilendirdiği tek seferlik bir işlemi başlatır.

    Reklam müşterileri, AdSense hesabı ile İçerik Reklamları veya Arama Reklamları gibi AdSense ürünleri arasındaki ilişkilendirmeyi temsil eder. Bir AdSense hesabında bir veya daha fazla reklam müşterisi olabilir.

    1. Web uygulamalarında kullanıcılar, erişim izni verebilecekleri bir siteye yönlendirilir. Yetki verildiğinde, API'ler konsolunda tanımlanan geri çağırma URL'sine yönlendirilirler.
    2. Yüklü uygulamalar da 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 özeldir.
  2. Aşağıdaki raporu istemek için reports.generate için API gezginini kullanın:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Raporlar, elde ettiğiniz kazancın yanı sıra bu kazançlarda nelerin etkisi olduğu konusunda bilgi verir. Kanalların kullanılması yoluyla hesabın tamamında veya bir reklam birimi alt kümesinde yayınlanabilirler.

  3. Aynı raporu uygulamanızdan istemeye çalışın.
  4. Raporları reklam birimlerine göre filtreleyebilirsiniz. adunits.list kullanarak reklam birimlerinin listesini getirin. Reklam istemcisi kimliğinin gerekli olduğunu unutmayın (1. adımdan alın). Bir reklam birimi seçtikten sonra reports.generate için filter parametresinde reklam birimini kullanın:

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

    • 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 filtreleme yapmayı veya birden çok filtreyi karıştırmayı deneyin.

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

Referans belgelerinde bulunan diğer uygun çağrı ve kaynakları inceleyerek uygulamanıza başlamaya hazırsınız.