Üçü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 kılavuzda, 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 alınması gerekmez. Ancak Ad Manager API'ye erişerek ve/veya Ad Manager API'yi kullanarak Ad Manager API şartlarını ve koşullarını kabul ettiğinizi unutmayın.
Ad Manager entegrasyonunuzu üçüncü taraf olarak test etme
Üçüncü taraf olarak, Ad Manager entegrasyonunuzu müşterilerinizin üretim ağlarında çalıştırmadan önce 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, 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, özelliklerin mevcut olmadığı 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. Ağlarındaki özellikleri yönetmek için Google'daki temsilcileriyle birlikte çalışmak müşterinizin sorumluluğundadır.
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. Hesaplarınızdan birinin güvenliği ihlal edildiğinde önceki seçenek daha güvenlidir. İkincisi, 1. adımı yalnızca bir kez yapmanı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, 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ılavuzda, her ikisinden de "normal" Google Hesabı olarak bahsedeceğiz.
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ğ kodunu 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 kullanımdan kaldırıldığında hazırlıksız yakalanmak ve müşterilerinizin uygulamalarını bozmak 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 destek sonlandırma planı da sunuyoruz.