Sorun giderme

Search Ads 360 API'sini kullanırken sorun yaşarsanız bu sorun giderme bölümüne göz atın.

Bu sitedeki kaynakları okuduktan sonra çözemediğiniz bir sorun varsa destek ekibiyle iletişime geçin ve aşağıdaki bilgileri hazır bulundurun:

  • Erişmeye çalıştığınız Search Ads 360 ajans kimliği ve reklamveren kimliği

  • Google API Konsolu'ndaki proje numarası

  • API'ye erişmek için kullandığınız Google Hesabı'nın kullanıcı adı.
    Bu, yetkilendirmeyi ayarlamak için kullandığınız hesapla aynı olan ve Search Ads 360'a erişim izni verilen hesaptır.

  • İsteğinizin kod snippet'i

  • JSON yanıtı
    Yanıt bir hataysa yalnızca sayısal hata kodunu değil, hata mesajını da eklediğinizden emin olun.

Yetkilendirme hataları

Sık karşılaşılan bazı yetkilendirme hataları aşağıda verilmiştir:

Mesaj Açıklama

Access Not Configured. Please use Google API Console to activate the API for your project.

Bu hata, hesabınız için Search Ads 360 API'yi etkinleştirmediyseniz ortaya çıkar. Aşağıdakileri yaptığınızdan emin olun:

  1. Google API Konsolu'na gidin.

  2. Projenizi seçin. Henüz proje oluşturmadıysanız İstemciniz için proje oluşturma başlıklı makaleyi inceleyin.

  3. Soldaki kenar çubuğunda API'ler ve kimlik doğrulama'yı genişletin. Ardından API'ler'i tıklayın. API listesinde, Search Ads 360 API'sinin durumunun AÇIK olduğundan emin olun.

Invalid grant

Bu hata, yenileme jetonunuz geçerli olmadığında ortaya çıkar. Search Ads 360 yardımcı programı komut dosyasını aşağıdaki gibi çağırarak yenileme jetonu elde edebilirsiniz:

sa360Api.py --login

Yetkilendirme için önerilen iş akışı hakkında daha fazla bilgi edinin.

Invalid client
no application name

Bu hata, Google API Konsolu'nda projenizi oluştururken bir ürün adı belirtmediyseniz meydana gelir. Bu hatayı düzeltmek için Google API Konsolu'nun izin ekranına ürününüzün adını girin.

Diğer yetkilendirme hatası türleri

Müşteri kimliğinizi ve müşteri gizli anahtarınızı almak için Google API Console'da oturum açarken ve yenileme jetonu alırken Search Ads 360'a erişim izni verilmiş bir Google Hesabı kullandığınızdan emin olun.

Dönüşüm yükleme hataları

Aşağıdaki tabloda, dönüşümleri yüklerken karşılaşabileceğiniz hatalar listelenmiştir. On altılık hata kodlarının değiştirilemediğini unutmayın. Bu nedenle, hataları tanımlamak için kendi komut dosyalarınızda kullanabilirsiniz.

Hata kodu Mesaj Açıklama
0x00000101

Click ID '{ID}' is not found

update isteğinde belirttiğiniz tıklama kimliği geçerli değil. Aşağıdakileri yaptıktan sonra dönüşümleri yeniden yükleyin:
0x0000010E Floodlight activity name '{name}' is not found

segmentationName sütununda belirtilen Floodlight etkinliğinin adı yanlış veya henüz kullanılamıyor. Bu hatayı görürseniz aşağıdaki yaygın sorunları kontrol edin:

  • Adlar büyük/küçük harfe duyarlıdır. Bu nedenle, isteğinizin büyük/küçük harf kullanımında tam olarak eşleştiğinden emin olun.
  • Floodlight etkinlik adına yazdırılabilir olmayan Unicode karakterleri veya çift boşluklar eklemediğinizden emin olun.
  • Floodlight sütunu yerine Floodlight etkinliğinin adını belirttiğinizden emin olun.
  • advertiserId sütununda belirttiğiniz reklamveren için Floodlight etkinliğinin var olup olmadığını kontrol edin. (Yanlış reklamvereni belirtmiş olabilirsiniz.)
  • Bir Floodlight etkinliği oluşturduktan veya düzenledikten sonra, etkinlik için dönüşüm yüklemeden önce birkaç saat bekleyin.
0x00000115 Custom dimension '{name}' is not found

Belirttiğiniz özel Floodlight değişkeninin, dönüşüm için ilişkilendirdiğiniz clickId, criterionId veya productGroupId ile ilişkili reklamveren için boyut (metrik değil) olarak ayarlandığından emin olun.

0x00000116 Custom metric '{name}' is not found

Belirttiğiniz özel Floodlight değişkeninin, dönüşüm için ilişkilendirdiğiniz clickId, criterionId veya productGroupId ile ilişkili reklamveren için metrik (boyut değil) olarak ayarlandığından emin olun.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

conversionId sütununda belirtilen aynı kapsam ve reklamveren dönüşüm kimliği için daha önce bir dönüşüm yüklenmiş.

"Reklamveren dönüşüm kimliği", oluşturduğunuz bir kimliktir. Search Ads 360, bu kimliğin belirli bir kapsam için benzersiz olmasını gerektirir. Search Ads 360 dönüşüm kimliği, Search Ads 360 tarafından oluşturulur ve benzersiz olması garanti edilir.
0x0000011B Advertiser conversion ID '{ID}' is not found

update isteğiniz, mevcut olmayan bir reklamveren dönüşüm kimliğini güncellemeye çalıştı. Doğru kimliği belirttiğinizden emin olun.
0x0000011D User does not have permission to view advertiser {advertiser ID}

İstemcide kullanılan Google Hesabı'nın, istekte belirtilen reklamvereni görüntüleme izni yok.

İstemci kimliğinizi ve istemci gizli anahtarınızı almak için Google API Konsolu'nda oturum açtığınızda ve yenileme jetonu aldığınızda, belirttiğiniz reklamverene erişim izni verilmiş bir Google Hesabı kullandığınızdan emin olun.
0x0000011F Advertiser conversion ID is already specified in this request

İstekteki iki veya daha fazla dönüşüm aynı kapsamı ve reklamveren dönüşüm kimliğini belirtiyor.

Reklamveren dönüşüm kimliği, oluşturduğunuz ve conversionId sütununda belirttiğiniz bir kimliktir. Search Ads 360, bu kimliğin belirli bir kapsam için benzersiz olmasını gerektirir.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

Sağladığınız Floodlight etkinlik kimliği veya adı, belirttiğiniz dönüşüm türüyle eşleşmiyor.

Yanıt kodlarını ve hata mesajlarını bildirme

Bir rapor isteğinde bulunursanız ve yanıt bir hata mesajıysa hata hakkında daha fazla bilgi için Search Ads 360 API'sindeki Yanıt Kodları ve Standart Hata Yanıtları başlıklı makalelere bakın.

Search Ads 360 kullanıcı arayüzündeki veriler, API tarafından döndürülen bir raporla eşleşmiyor

Search Ads 360 kullanıcı arayüzündeki veriler varsayılan olarak API tarafından döndürülen verilerle eşleşmelidir. Bir rapor isteği için includeRemovedEntities değerini true olarak ayarlarsanız kullanıcı arayüzünde Kaldırılanları göster onay kutusunun da seçildiğinden emin olun.