Üçüncü taraflar, kendi Ad Manager ağları olmayabileceğinden Ad Manager'ın doğrudan kullanıcıları değildir. Bunun yerine, Ad Manager müşterisi olan müşterileri için Ad Manager ile hizmetler veya entegrasyonlar oluştururlar. Bu rehberde, en iyi uygulamalar, ipuçları ve püf noktaları sunularak üçüncü taraf entegrasyonlarının temelleri ele alınmaktadır.
Bu kılavuzda, Ad Manager API hakkında bilgi sahibi olduğunuz varsayılmaktadır. Ad Manager API hakkında bilginiz yoksa başlangıç belgelerimize göz atın.
Üçüncü taraf olarak başlama
Ad Manager API'yi kullanarak bir Ad Manager müşterisinin ağına erişmek için aşağıdaki yönergeleri uygulamanız yeterlidir. Google'dan ek onay gerekmez. Ancak Ad Manager API'ye erişerek ve/veya Ad Manager API'yi kullanarak Ad Manager API hükümlerini ve koşullarını kabul ettiğinizi unutmayın.
Ad Manager entegrasyonunuzu üçüncü taraf olarak test etme
Üçüncü taraf olarak, müşterilerinizin üretim ağlarında yayınlamadan önce Ad Manager entegrasyonunuzu nasıl test edeceğinizi merak ediyor olabilirsiniz. Önerilen yaklaşım, bir test ağı oluşturmaktır. Bu işlemi gerçekleştirmek için Ad Manager müşterisi olmanız gerekmez. Google Hesabı olan herkes test ağı oluşturabilir.
Ancak test ve üretim ağları arasındaki farklara dikkat edin. Test ağları reklam yayınlayamaz. Test ağları, müşterilerinizin üretim ağlarında kullanabileceği tüm özellikleri içermeyebilir. Test ağınızda bulunmayan Ad Manager özelliklerine karşı test yapmanız gerekiyorsa bir seçenek de Ad Manager bayisi aracılığıyla test dışı bir ağa erişim satın almaktır.
Ayrıca, uygulamanızın düzgün çalışması için müşterilerinizin üretim ağında hangi özelliklerin bulunması gerektiği konusunda net olmalısınız. Uygulamanız, özellikleri bulunmayan durumları istisnaları yakalayarak ve sorunsuz bir şekilde başarısız olarak veya müşterilerinizin ve her birinin sahip olduğu ya da olmadığı özelliklerin bir listesini tutarak ele almalıdır. Müşterinizin, ağındaki özellikleri yönetmek için Google'daki temsilcisiyle birlikte çalışması gerekir.
Kimlik doğrulama: Bir müşterinin Ad Manager ağına nasıl doğru şekilde erişilir?
Uygulamanızın müşterinizin Ad Manager ağına erişebilmesi için kimlik doğrulama iş akışınızı güvenli bir şekilde ayarlamanız gerekir.
Bu işlem iki adımdan oluşur:
- Müşterinizin ağına erişmek için kullanacağınız bir Google Hesabı e-posta adresi oluşturun.
- Müşteriden bu hesabı Ad Manager ağına kullanıcı olarak eklemesini isteyin.
1. adımda, her müşteri için ayrı bir Google Hesabı veya tüm müşteriler için kullanacağınız birincil bir hesap oluşturabilirsiniz. İlk seçenek, hesaplarınızdan birinin güvenliği ihlal edildiğinde daha güvenlidir. İkincisi, 1. adımı yalnızca bir kez uygulamanız gerektiği anlamına gelir.
1. adımda ne yaparsanız yapın, 2. adımda her yeni müşteriden, kendisi için oluşturduğunuz uygun Google Hesabı'nı Ad Manager ağına kullanıcı olarak eklemesini istemeniz gerekir.
1. Google Hesabı Oluşturma
Ad Manager ağına eklenebilecek bir Google Hesabı oluşturmanın çeşitli yolları vardır.
1. seçenek: OAuth2 hizmet hesabı oluşturun. Bu hesap, sizin için Google Hesabı gibi davranan bir hizmet hesabı e-posta adresi oluşturur. Yeni hizmet hesabı oluşturma talimatları.
2. seçenek: Yeni kullanıcı olarak kaydolarak normal bir Google Hesabı ("Gmail" hesabı) oluşturabilirsiniz. Google Hesabınız varsa bu kaydı gizli pencerede veya yeni bir tarayıcı oturumunda tamamlayın. Şirketiniz Google Workspace kullanıyorsa şirketinizin alanında bir Google Hesabı oluşturup bunu da kullanabilirsiniz. Bu kılavuzun amaçları doğrultusunda, her ikisini de "normal" Google Hesabı olarak adlandıracağız.
2. Müşteriden Google Hesabınızı ağına eklemesini isteyin.
Müşterinizin ağına erişmek için bir Google Hesabı edindikten sonra, müşterinizden hesabı Ad Manager ağında yeni bir kullanıcı olarak eklemesini isteyin.
Kullanıcılara bir OAuth2 hizmet hesabı e-posta adresi sağlıyorsanız bu adresi ağlarına eklemelerini isteyin.
Kullanıcılara normal bir Google Hesabı sağlıyorsanız hesabınızı ağlarına kullanıcı olarak eklemelerini isteyin.
Hangi yolu seçerseniz seçin, uygulamanızın müşterinizin ağında ihtiyaç duyduğu verilere erişebilmesi için hesabınızın hangi rolleri ve izinleri alması gerektiğini müşterinizle görüşün.
Artık müşterinizin Ad Manager ağına API çağrıları yapmaya başlayabilirsiniz. networkCode SOAP üstbilgisini, API çağrısı yaptığınız istemcinin ağ kodu olarak ayarladığınızdan emin olun. Tüm istemci kitaplıklarımızda bu ayar programatik olarak yapılabilir. Örneğin, ads Java istemci kitaplığında bir DfpSession örneği oluştururken ağı programatik olarak ayarlayabilirsiniz.
API ile ilgili son gelişmelerden haberdar olun
Hangi API sürümlerinin kullanımdan kaldırıldığı veya desteğinin sonlandırıldığı ve yeni sürümlerin ne zaman yayınlandığı konusunda güncel kalmanız önemlidir. Bir sürümün desteği sonlandırıldığında hazırlıksız yakalanmak ve müşterilerinizi mağdur etmek istemezsiniz. Müşterilerimiz için yaptığımız gibi, yaklaşan desteğin sonlandırılması ve kullanımdan kaldırılma işlemleri hakkında her zaman üçüncü taraflarla iletişime geçemeyebiliriz. Bu nedenle, API güncellemeleri için üç ana kanalımızdan birine abone olmak ve bildirim ayarlarınızı düzenlemek sizin sorumluluğunuzdadır:
Ayrıca, geliştirici sitemizde düzenli olarak izlemeniz gereken bir kullanımdan kaldırma planı da sunuyoruz.