Üçüncü taraflar, kendi Ad Manager ağlarına sahip olmayabilecekleri için 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 temel bilgileri 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 bakın.
Üçüncü taraf olarak kullanmaya 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 API'yi kullanarak Ad Manager API Hükümler ve Koşulları'nı kabul etmiş olursunuz.
Üçüncü taraf olarak Ad Manager entegrasyonunuzu test etme
Üçüncü taraf olarak, müşterilerinizin üretim ağlarında çalıştırmadan önce Ad Manager entegrasyonunuzu nasıl test edeceğinizi merak ediyor olabilirsiniz. Önerilen yaklaşım, test ağı oluşturmaktır. Bunun 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 de içermeyebilir. Test ağınızda bulunmayan Ad Manager özelliklerini test etmeniz gerekiyorsa seçeneklerden biri, bir 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 üretim ağlarında hangi özelliklerin bulunması gerektiği konusunda müşterilerinize net bilgi vermeniz gerekir. Uygulamanız, özelliklerin mevcut olmayabileceği durumları ya istisnaları yakalayıp düzgün bir şekilde başarısız olarak ya da istemcilerinizin ve her birinin sahip olduğu veya olmadığı özelliklerin listesini tutarak ele almalıdır. Ağlarındaki özellikleri yönetmek için Google'daki ilgili kişiyle çalışmak müşterinizin sorumluluğunda olmalıdır.
Kimlik doğrulama: Müşterinin Ad Manager ağına doğru şekilde erişme
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üşterinin bu hesabı Ad Manager ağına kullanıcı olarak eklemesini sağlayın.
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 edilirse ilk seçenek daha güvenlidir. Bu, 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, kendileri için oluşturduğunuz uygun Google Hesabı'nı Ad Manager ağlarına kullanıcı olarak eklemelerini 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ı olarak işlev gören 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. Zaten bir 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 kullanabilirsiniz. Bu kılavuzda, her ikisini de "normal" Google Hesabı olarak adlandıracağız.
2. Müşteriden Google Hesabınızı kendi ağına eklemesini isteyin.
Müşterinizin ağına erişmek için bir Google Hesabı aldıktan sonra müşterinizden hesabı Ad Manager ağına yeni bir kullanıcı olarak eklemesini isteyin.
Onlara bir OAuth2 hizmet hesabı e-posta adresi sağlıyorsanız bu adresi ağlarına eklemelerini isteyin.
Onlara 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 rollere ve izinlere sahip olması gerektiğini müşterinizle görüştüğünüzden emin olun.
Artık müşterinizin Ad Manager ağına API çağrıları yapmaya başlayabilirsiniz. networkCode SOAP başlığını, API çağrısını yaptığınız istemcinin ağ koduna ayarladığınızdan emin olun. Tüm istemci kitaplıklarımız, bu ayarın programatik olarak yapılmasına olanak tanır. Örneğin, Ads Java istemci kitaplığında, bir DfpSession örneği oluştururken programatik olarak ağ kodunu ayarlayabilirsiniz.
API ile ilgili son gelişmelerden haberdar olma
Hangi API sürümlerinin kullanımdan kaldırıldığını veya desteğinin sonlandırıldığını ve yeni sürümlerin ne zaman yayınlandığını takip etmeniz önemlidir. Bir sürüm kullanımdan kaldırıldığında hazırlıksız yakalanmak ve istemcilerinizin bozulması riskini almak istemezsiniz. Müşterilerimize yaptığımız gibi, üçüncü taraflara yaklaşan kullanımdan kaldırma ve sonlandırma işlemleri hakkında her zaman ulaşamayabiliriz. 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:
Geliştirici sitemizde düzenli olarak takip etmeniz gereken bir desteği sonlandırma planı da sunuyoruz.