Üçüncü taraflar, kendi Ad Manager ağlarına sahip 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şturur. Bu kılavuzda en iyi uygulamalar, ipuçları ve püf noktaları sayesinde üçüncü taraf entegrasyonlarıyla ilgili temel bilgiler yer almaktadır.
Bu kılavuzda, Ad Manager API'sinin çalışma bilgisine sahip olduğunuz varsayılmaktadır. Ad Manager API'si hakkında bilginiz yoksa lütfen başlangıç belgelerimizi inceleyin.
Üçüncü taraf olarak kullanmaya başlama
Ad Manager müşterisinin ağına erişmek amacıyla Ad Manager API'sini kullanmak için aşağıdaki yönergeleri uygulamanız yeterlidir. Google'dan ek onay almanıza gerek yoktur ancak Ad Manager API'sine erişerek ve/veya bu API'yi kullanarak Ad Manager API'si şartlar ve koşullarını kabul etmiş olursunuz.
Ad Manager entegrasyonunuzu üçüncü taraf olarak 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, bir test ağı oluşturmaktır. Bunun için Ad Manager müşterisi olmanız gerekmez. Google hesabı olan herkes bir test ağı oluşturabilir.
Bununla birlikte, test ve üretim ağları arasındaki farkları unutmayın. Test ağları reklam yayınlayamaz. Ayrıca test ağları, müşterilerinizin üretim ağlarında mevcut olabileceği tüm özellikleri de içermeyebilir. Test ağınızda bulunmayan Ad Manager özelliklerine göre test yapmanız gerekiyorsa seçeneklerden biri, Ad Manager iş ortağı 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 özelliklere sahip olmaları gerektiği konusunda müşterilerinize karşı net olmalısınız. Uygulamanız, istisnaları yakalayarak ve başarılı bir şekilde başarısız olarak ya da müşterilerinizin ve her birinin sahip olduğu veya olmayan özelliklerinin bir listesini saklayarak özelliklerin var olmayabileceği durumları ele almalıdır. Ağındaki özellikleri yönetmek için Google'daki ilgili kişiyle birlikte çalışmak müşterinizin sorumluluğunda olmalıdır.
Kimlik doğrulama: İstemcinin Ad Manager ağına doğru şekilde erişme
Uygulamanızın istemcinizin 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 istemciler için kullanacağınız birincil bir hesap oluşturabilirsiniz. İlk seçenek, hesaplarınızdan birinin güvenliğinin ihlal edilmesi durumunda daha güvenlidir. İkincisi ise 1. adımı bir kez uygulamanız gerektiği anlamına gelir.
1. adımda ne yaparsanız yapın, 2. adımda her yeni müşteriden, kullanıcı olarak kendisi için oluşturduğunuz uygun Google hesabını Ad Manager ağına 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: Google hesabı olarak çalışan bir hizmet hesabı e-posta adresi oluşturan bir OAuth2 hizmet hesabı oluşturun. 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 kaydolma işlemini gizli bir pencerede veya yeni bir tarayıcı oturumunda tamamlayın. Şirketinizde Google Workspace kullanılıyorsa şirketinizin alanında bir Google Hesabı oluşturup kullanabilirsiniz. Bu kılavuzun amacı doğrultusunda, bunların her ikisini de "normal" Google hesabı olarak ele alacağı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, bu hesabı Ad Manager ağına yeni bir kullanıcı olarak eklemelerini isteyin.
Kullanıcılara bir OAuth2 hizmet hesabı e-posta adresi sağlıyorsanız bu adresi ağlarına eklemelerini sağlayın.
Onlara normal bir Google hesabı sağlıyorsanız kendi ağlarına kullanıcı olarak hesabınızı eklemelerini isteyin.
Hangi yöntemi kullanırsanız kullanın, uygulamanızın müşterinizin ağında ihtiyaç duyduğu verilere erişebilmesi için hesabınızın sahip olması gereken rol ve izinleri müşterinizle konuştuğunuzdan 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ında bulunduğunuz istemcinin ağ koduna ayarladığınızdan emin olun. Tüm istemci kitaplıklarımız bunun programatik olarak ayarlanmasına olanak tanır. Örneğin, Ads Java istemci kitaplığında bir DfpSession örneği oluştururken ağ kodunu programlı bir şekilde ayarlayabilirsiniz.
API'yi güncel tutma
Hangi API sürümlerinin kullanımdan kaldırıldığı veya kullanımdan kaldırılan yeni sürümlerin ne zaman yayınlanacağı ile ilgili güncel bilgileri takip etmeniz önemlidir. Bir sürüm kullanımdan kaldırıldığında gafil avlanmak ve müşterilerinizin zarar görmesi riskini almak istemezsiniz. Yaklaşan kullanımdan kaldırma ve kullanımdan kaldırma işlemleriyle ilgili olarak müşterilerimize her zaman olduğu gibi üçüncü taraflara her zaman ulaşamayız. Dolayısıyla, 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 izlemeniz gereken bir kullanımdan kaldırma programı da sunuyoruz.
Destek alma
Ad Manager entegrasyonunuzla ilgili sorunlarla karşılaşırsanız sorununuza bağlı olarak aşağıdaki destek kanallarını sunarız. Ürün düzeyinde bir sorunuz varsa lütfen Ad Manager ürün forumlarına yazın. API'ye özgü bir sorunuz varsa lütfen Ad Manager API forumlarına yazın. Bir sorunun ürün düzeyinde mi yoksa API'ye özel bir soru mu olduğunu ayırt etmeyle ilgili ipuçları için lütfen bu blog yayınına göz atın.