Bir Search Ads 360 reklamvereni ile Adobe Analytics arasında bağlantı oluşturma

Adobe, 18 Ağustos 2021 tarihinde OAuth 1.4 desteğini sonlandırmayı planladığını duyurdu. Adobe Analytics ile entegrasyon konusunda OAuth 1.4 kullanan reklamverenler, Search Ads 360'ta sorun yaşamamak adına, OAuth 1.4 kullanımdan kaldırılmadan önce kimlik doğrulama için Adobe JWT'ye geçiş yapmalıdır.

 

Adobe Analytics ile entegrasyon konusunda OAuth 2.0 kullanan reklamverenler, OAuth 1.4'ün kullanımdan kaldırılmasından etkilenmiyor olsa da tüm reklamverenlerin daha iyi bir kimlik doğrulama deneyimi yaşamaları için Adobe JWT'ye geçiş yapmalarını şiddetle tavsiye ediyoruz.

Başlamadan önce

Paylaşılan Floodlight yapılandırmaları

Search Ads 360 reklamvereniniz bir paylaşılan Floodlight yapılandırmasının parçasıysa, yalnızca üst reklamverenden Floodlight etkinlikleri oluşturabileceğiniz için sadece üst reklamvereni Adobe Analytics'e bağlayabilirsiniz (tüm alt reklamverenler, üst reklamverende oluşturulan Floodlight etkinliklerine erişebilir). 

Search Ads 360'ta, üst Campaign Manager 360 reklamvereniyle ilişkilendirilen reklamverende oturum açın ve buradan Adobe Analytics'e bağlanın. Bu Search Ads 360 reklamvereni için ajans yöneticisi veya reklamveren yöneticisi izinlerine ihtiyacınız vardır.

Üst Campaign Manager 360 reklamvereni bir Search Ads 360 reklamverenine bağlanmamışsa:

1. Search Ads 360 reklamvereni oluşturun ve bunu , üst Campaign Manager 360 reklamverenine bağlayın.
   Bu adımı tamamlamak için gereken izinler hakkında daha fazla bilgi edinin.
   
   Oluşturduğunuz Search Ads 360 reklamvereni, alt reklamverenleri etkilemez ve Adobe Analytics'e bağladıktan sonra reklamvereni göz ardı edebilirsiniz.
    
2. Yeni Search Ads 360 reklamverenini, aşağıda açıklanan şekilde Adobe Analytics'e bağlayın. 

İki URL parametresi tüm açılış sayfalarına eklenir

Açılış sayfalarınızın gclid ve gclsrcURL parametrelerini ekleyebileceğinden emin olun. Dönüşüm API'sini etkinleştirdiğinizde Search Ads 360, gclid ve gclsrc parametrelerini reklamverendeki tüm açılış sayfası URL'lerinin sonuna otomatik olarak ekler. Bu parametrelerin diğer URL parametrelerini veya URL parçalarını nasıl etkileyebileceğini öğrenin.

Bir reklamvereni Adobe Analytics'e bağlama

Search Ads 360, bir reklamvereni Adobe Analytics'e bağlarken aşağıdaki yetkilendirme yöntemlerini destekler.

• Adobe JWT (yeni yetkilendirme yöntemi). Tüm reklamverenler için önerilir. Şu anda OAuth 1.4 sürümünü kullanan reklamverenler ile Adobe Analytics entegrasyonunu ilk kez kuracak reklamverenler için gereklidir.
• OAuth 2.0 (klasik yetkilendirme yöntemi). Yalnızca şu anda bu yetkilendirme yöntemini kullanan reklamverenler tarafından kullanılabilir.

Adobe JWT (yeni yetkilendirme yöntemi) kullanarak bir reklamvereni Adobe Analytics'e bağlama

Şu anda OAuth 2.0 (klasik yetkilendirme yöntemi) kullanıyorsanız daha iyi bir kimlik doğrulama deneyimi yaşamak için Adobe JWT'ye (yeni yetkilendirme yöntemi) geçiş yapmanızı şiddetle tavsiye ediyoruz. Adobe Analytics entegrasyonunu ilk kez kuruyorsanız JWT kullanmanız gerekir. Buna ek olarak, şu anda OAuth 1.4 sürümünü kullanıyorsanız Adobe, OAuth 1.4'ü kullanımdan kaldırmadan önce JWT'ye geçiş yapmalısınız.

Bir reklamvereni bağlamayla ilgili genel süreci burada bulabilirsiniz (ayrıntılar bu makalenin ilerleyen bölümlerinde sağlanmıştır):

1. Adobe Developer Console'da bir Hizmet Hesabı (JWT) entegrasyonu oluşturma. Search Ads 360, Adobe Analytics'ten raporlama verilerini indirme yetkisi almak için bu entegrasyonu kullanır.
2. Search Ads 360'ta Conversion API ve Adobe Analytics entegrasyonunu (JWT) etkinleştirme.

Adobe Developer Console'da bir Hizmet Hesabı (JWT) entegrasyonu oluşturma

1. Adobe Developer Console'da oturum açın.
2. Hizmet Hesabı'nı (JWT) kullanarak projeye API ekleme hakkında Adobe sitesindeki talimatları uygulayın.
   1. "Bir API ekle" adımındayken Adobe Analytics'i tıklayın.
   2. "API'yi yapılandır" adımındayken Hizmet Hesabı'nı (JWT) tıklayın.
   3. "Yeni bir hizmet hesabı (JWT) kimlik bilgisi oluştur" adımındayken 1. Seçenek: Bir anahtar çifti oluştur'u tıklayın. Bu işlemden sonra bilgisayarınıza bir config klasörü indirilir. Klasörün içinde private.key adında bir dosya bulunur. Bu dosyadaki bilgilere daha sonra Adobe Developer Console kimlik bilgilerinizi Search Ads 360'a girerken ihtiyacınız olacaktır.
3. API ekleme işlemini tamamladıktan sonra Adobe Developer Console'da projenizi tıklayıp "Products & services"in (Ürünler ve hizmetler) altında Adobe Analytics API'nin göründüğünden emin olun.
   
    
   Adobe Developer Console'da JWT entegrasyonunu ve özel anahtarı oluşturan kullanıcının, Search Ads 360'ın içe aktarmasını istediğiniz rapor paketlerine ve eVar'lara erişim izni olduğundan emin olun. Adobe Developer Console'da kimlik bilgileri oluşturan kullanıcı uygun izinlere sahip değilse Search Ads 360 entegrasyonu, Adobe rapor paketlerine ve eVar'lara erişemez. İdeal olan durum, Adobe kimlik bilgilerini oluşturan kullanıcının Sistem Yöneticisi izinlerine sahip olmasıdır. Ancak bazı durumlarda Web Service API izinleri de yeterli olabilir. Daha fazla bilgi edinin.
4. Soldaki gezinme menüsünde, "Credentials" (Kimlik bilgileri)" başlığının altında Service Account (JWT) (Hizmet Hesabı) seçeneğini tıklayarak Search Ads 360'a kopyalamanız gereken aşağıdaki kimlik bilgisi ayrıntılarını görebilirsiniz:
   • İstemci Kimliği
   • İstemci Gizli Anahtarı
   • Teknik Hesap Kimliği
   • Kuruluş Kimliği

Dönüşüm API'sini ve Adobe Analytics entegrasyonunu (JWT) etkinleştirme

Gereken özel izinler

Search Ads 360'ta, Google hesabınızın ajans yöneticisi veya reklamveren yöneticisi iznine ihtiyacı vardır.

Entegrasyonu etkinleştirme

1. Search Ads 360'ta bir reklamverene gidin.

   Reklamverene gitme adımları

   1. Gezinme seçeneklerini görüntülemek için gezinme çubuğunu tıklayın.

   2. Ajans listesinde, reklamvereni içeren ajansı tıklayın. Bir ajansı ada göre arayabilir veya listeye göz atabilirsiniz.

   3. Reklamveren listesinde, reklamvereni tıklayın.

   4. Uygula'yı tıklayın veya Enter tuşuna basın.

   Search Ads 360'ta, reklamverenin tüm arama motoru hesaplarıyla ilgili veriler içeren reklamveren sayfası görüntülenir.

2. Soldaki gezinme panelinde Reklamveren ayarları'nı tıklayın.
   
   Reklamveren ayarlarını görmüyor musunuz? Sol gezinme panelinde Reklamveren ayarlarını yalnızca Search Ads 360 ajans yöneticileri veya reklamveren yöneticileri görebilir.

3. Dönüşüm API'sini açık konumuna getirin (Adobe Analytics desteğinin etkinleştirilmesi için bu gereklidir):

   1. Entegrasyonlar▼ sekmesini tıklayarak Dönüşüm API'si seçeneğini belirleyin.

   2. Dönüşümler API'si öğesini Açık duruma getirin.

   3. Kaydet'i tıklayın.

4. Search Ads 360'ı bir Adobe Analytics mülküne bağlayın:

   1. Entegrasyonlar ▼ sekmesini tıklayın ve Adobe Analytics entegrasyonu'nu seçin.

   2. Adobe Analytics Entegrasyonu'nun yanındaki ayarlar simgesini () tıklayın.

   3. Adobe Analytics entegrasyonu düğmesini Açık durumuna getirin.

   4. Şu anda OAuth 2.0 sürümünü kullanıyor ve JWT'ye geçiş yapmak istiyorsanız Yeni yetkilendirme yöntemi'ni tıklayın.
      Adobe Analytics entegrasyonunu ilk kez kuracak reklamverenler, "Yeni yetkilendirme yöntemi" veya "Klasik yetkilendirme yöntemi" seçeneklerini görmemek için JWT kullanmalıdır. Buna ek olarak, şu anda OAuth 1.4 sürümünü kullanan reklamverenler de "Yeni yetkilendirme yöntemi" veya "Klasik yetkilendirme yöntemi" seçeneklerini görmemek için JWT'ye geçiş yapmalıdır.

   5. İstemci Kimliği alanına Adobe Developer Console'daki İstemci Kimliği'ni girin.

   6. İstemci gizli anahtarı alanına Adobe Developer Console'daki İstemci Gizli Anahtarı'nı girin.

   7. Şirket veya kuruluş adı alanına şirketinizin veya kuruluşunuzun adını girin.

   8. Kuruluş Kimliği alanına Adobe Developer Console'daki Kuruluş Kimliği'ni girin.

   9. Teknik Hesap Kimliği alanına Adobe Developer Console'daki Teknik Hesap Kimliği'ni girin.

   10. Özel anahtar alanına Adobe Developer Console'dan indirdiğiniz private.key dosyasındaki bilgileri girin. Bilgileri private.key dosyasından kopyalarken ilk satırı (-----BEGIN PRIVATE KEY----) veya son satırı (-----END PRIVATE KEY-----) dahil etmeyin.

   11. Kaydet'i tıklayın.

   12. Yetkilendirme onayını gördükten sonra pencereyi kapatın ve Kaydet'i tıklayın.

Search Ads 360, Adobe Developer Console entegrasyonunuza bağlanmaya başlar. Bağlantı başarılı olduğunda, düzenleme paneli kapanır ve bildirim merkezinde bir not görüntülenir.

Bağlantı başarılı olmazsa düzenleme panelinde bir hata mesajı görüntülenir. Doğru istemci kimliğini ve gizli anahtarı girdiğinizden emin olun.

 

Sonraki adımlar

Rapor paketlerini Search Ads 360'a ekleyin.
After you link to Adobe Analytics, Search Ads 360 needs time to retrieve the list of report suites and report metrics you have access to.