Sorun giderme

Dönüşümleri yönetmek için karmaşık bir entegrasyon gerekir. Bu entegrasyon genellikle birbirine bağlı birden fazla araç ve süreç içerir. Bu kılavuzda, API'den anlamadığınız hatalar alıyorsanız veya kullanıcı arayüzünde gördüğünüz metrikler ya da teşhisler konusunda kafanız karıştıysa yaşadığınız sorunları gidermek için uygulayabileceğiniz ayrıntılı adımlar sunulmaktadır.

Google Ads kullanıcı arayüzünde metrikleri okuma

Google Ads kullanıcı arayüzü, dönüşüm metriklerini içe aktarma tarihine göre düzenlemez. Bu nedenle, içe aktarma sonuçlarını doğrulamak için kullanıcı arayüzündeki kampanya raporlarını kullanmak yanıltıcı olabilir. API isteği düzeyinde içe aktarma durumunu doğrulamak için çevrimdışı veri teşhisleri ile başlayın. Çevrimdışı veri teşhisleri, gelişmiş dönüşümler için eşzamansız etiket eşleştirmeyi veya kullanıcı kimliği kalitesini değerlendirmez. Eşleştirme durumunu doğrulamak için potansiyel müşteriler için gelişmiş dönüşümler ve web için gelişmiş dönüşümler ile ilgili Google Ads kullanıcı arayüzü teşhis raporlarını kontrol edin. Sorun giderme adımları için Başarılı bir API yüklemesinden sonra kullanıcı arayüzü teşhis uyarıları başlıklı makaleyi inceleyin.

Potansiyel müşteriler için gelişmiş dönüşümlerle ilgili sorunlar

Bu bölümde, potansiyel müşteriler için gelişmiş dönüşümleri içe aktarırken karşılaşılan yaygın sorunların giderilmesi ele alınmaktadır.

Sık karşılaşılan hatalar

Aşağıdaki kılavuz, potansiyel müşteriler için gelişmiş dönüşümlerle ilgili yaygın hataları teşhis edip düzeltmenize yardımcı olur.

Hata
NO_CONVERSION_ACTION_FOUND	Belirtilen dönüşüm işlemi etkin değil veya isteğin customer_id alanındaki hesap tarafından erişilemiyor. Yüklemenizdeki dönüşüm işleminin etkinleştirildiğini ve sahibinin, tıklamanın Google Ads reklam dönüşümü müşterisi veya yükleme hesabının dönüşüm izleme hiyerarşisindeki bir hesap olduğunu onaylayın. Bu hata, istekteki GCLID'nin istekte belirtilen dönüşüm işlemine erişimi olmayan bir müşteri hesabına ait olması durumunda da ortaya çıkabilir. click_view kaynağını kullanarak bir GCLID'nin müşteri hesabına ait olup olmadığını doğrulayabilirsiniz. Bunun için click_view.gclid ve segments.date ölçütlerine göre filtreleme yapan bir sorgu göndermeniz gerekir. Buradaki tarih, tıklamanın gerçekleştiği tarihtir.
INVALID_CONVERSION_ACTION_TYPE	Belirtilen dönüşüm işleminin türü, potansiyel müşteriler için gelişmiş dönüşümler açısından geçerli değil. Yükleme isteğinizde belirtilen ConversionAction öğesinin türünün UPLOAD_CLICKS olduğundan emin olun.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Dönüşüm ayarlarınızda potansiyel müşteriler için gelişmiş dönüşümleri etkinleştirdiğinizden emin olun. Bununla ilgili talimatları ön koşullar kılavuzunda bulabilirsiniz.
DUPLICATE_ORDER_ID	İçe aktarılan etkinlikler, aynı Sipariş Kimliği'ne sahip birden çok dönüşüm içerdiği için işlenmedi. Sipariş kimliklerinin benzersiz olduğundan emin olup tekrar deneyin.
CLICK_NOT_FOUND	Sağlanan kullanıcı tanımlayıcılarıyla eşleşen tıklama bulunamadı. Bir dönüşüm bu uyarıyı alırsa Google Ads API, dönüşümü çevrimdışı veri teşhislerinizin successful_event_count bölümüne ekler. Google Ads API, alerts koleksiyonunda CLICK_NOT_FOUND için bir giriş içerir. Böylece bu uyarının sıklığını izleyebilirsiniz. Tıklama bir Google Ads kampanyasından gelmiyorsa bu hatanın alınması normaldir. Örneğin, SA360 veya DV360'tan gelebilir. Diğer olası nedenler şunlardır: Yükleme yapan müşteri, Google Ads dönüşüm müşterisinden farklıdır. Potansiyel müşteri formunuz için etiketleme doğru şekilde yapılandırılmamış. Yüklenen veriler doğru şekilde normalleştirilmemiş ve karma oluşturma işlemine tabi tutulmamıştır. Yükleyen müşterinin Google Ads dönüşüm müşterisinden farklı olduğu nadir durumlarda bu hata, yükleyen müşterinin müşteri verileri şartlarını kabul ettiği ancak yayınlayan müşterinin kabul etmediği anlamına gelebilir. Bir hesabın müşteri verileri şartlarını kabul edip etmediğini belirlemek için customer kaynağını sorgulayabilir ve customer.conversion_tracking_setting.accepted_customer_data_terms alanını kontrol edebilirsiniz.

Metriklerdeki tutarsızlıklar

Aşağıdaki yaygın sorunları göz önünde bulundurun:

• Dönüşümler, işleme hattımız tarafından çeşitli nedenlerle silinebilir ve bu dönüşümler kurtarılamaz. Daha fazla bilgi için Başarılı yükleme işlemi sonrası veri tutarsızlıkları bölümünü inceleyin.

• Google etiketinin web sayfanızda doğru şekilde ayarlandığından ve potansiyel müşteri formu gönderimlerinde etkinleştirildiğinden emin olun. Etiketiniz form gönderimlerinde tetiklenmiyorsa veya yanlış veri gönderiyorsa yüklenen dönüşümlerde ilişkilendirmenin düşük olduğunu ya da hiç olmadığını görebilirsiniz. Potansiyel müşteriler için gelişmiş dönüşümler özelliğini etkinleştirmek üzere Google etiketini yapılandırma ve Google Etiket Yöneticisi'ni yapılandırma ile ilgili Yardım Merkezi makalelerimizi inceleyin.

• Web sayfanızda Google etiketi olmadan potansiyel müşteriler için gelişmiş dönüşümleri kullanıyorsanız her dönüşümde ClickConversion.gclid alanını ayarlayarak dönüşüm içe aktarma işlemlerinize GCLID'yi dahil etmeniz gerekir.

• Yüklemelerinizde izni doğru şekilde belirttiğinizden emin olun. Bunu yapmak için hesabınızın varsayılan izin ayarlarını belirleyebilir (Google Ads kullanıcı arayüzünde Araçlar > Veri Yöneticisi > İzin ayarları'nı tıklayın) veya yüklenen her dönüşümde ClickConversion.consent alanını ayarlayabilirsiniz.

Kampanya performansıyla ilgili sorunlar

Dönüşümlerinizi yüklerken herhangi bir teknik sorun yaşamıyorsanız ve sunulan metriklerden memnunsanız ancak potansiyel müşteriler için gelişmiş dönüşümleri uyguladıktan sonra beklenen kampanya performansı iyileştirmelerini veya "artışı" görmüyorsanız yardım için Google Ads Ürün Destek Ekibi ile iletişime geçin.

Web için gelişmiş dönüşümlerle ilgili sorunlar

Bu bölümde, web için gelişmiş dönüşümleri içe aktarırken karşılaşılan yaygın sorunların giderilmesi ele alınmaktadır.

Sık karşılaşılan hatalar

Aşağıdaki kılavuz, web için gelişmiş dönüşümlerle ilgili yaygın hataları teşhis edip düzeltmenize yardımcı olur.

Hata
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	İsteğin customer_id için müşteri verileriyle ilgili hükümler ve koşullar kabul edilmedi. Bununla ilgili talimatları ön koşullar kılavuzunda bulabilirsiniz.
CONVERSION_ALREADY_ENHANCED	Bu dönüşüm, belirtilen order_id ve conversion_action alanlarıyla birlikte bir ENHANCEMENT ayarlaması aldı. Her dönüşüm için benzersiz bir order_id değeri sağladığınızdan emin olun.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Sağlanan conversion_action, web için gelişmiş dönüşümlere uygun değil. Google Ads kullanıcı arayüzünde, isteğinizde referans verilen dönüşüm işleminde Gelişmiş dönüşümleri aç kutusunu işaretlediğinizden emin olun. Bununla ilgili talimatları Yardım Merkezi'nde bulabilirsiniz.
INVALID_USER_IDENTIFIER	Karma oluşturma işlemi uygulanmış bir kullanıcı kimliği alanı (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name veya hashed_street_address) geçerli bir 64 karakterlik onaltılık SHA-256 özeti değil. Kullanıcı tarafından sağlanan verileri içe aktarmadan önce normalleştirin ve karma oluşturma işlemi uygulayın. Talimatlar için Kullanıcı tarafından sağlanan verileri normalleştirme ve karma oluşturma işlemi uygulama başlıklı makaleyi inceleyin.
CONVERSION_NOT_FOUND	Google Ads, sağlanan conversion_action alanı ve dönüşüm tanımlayıcısı (order_id veya gclid_date_time_pair) ile eşleşen bir dönüşüm bulamadı. Bu hata yalnızca RESTATEMENT ve RETRACTION ayarlamaları için geçerlidir. Ayrıntılar için Dönüşüm ayarlamalarını içe aktarma ile ilgili koşullar başlıklı makaleyi inceleyin. ENHANCEMENT düzenlemeleri için API, CONVERSION_NOT_FOUND hatası döndürmeden isteği kabul eder ve etiketten API'ye order_id eşleşmesini eşzamansız olarak değerlendirir. Eşleşmeyen order_id değerlerinin yüksek oranlarda olması, Google Ads kullanıcı arayüzündeki gelişmiş dönüşümler teşhis raporunda sipariş kimliği uyuşmazlığı uyarısını tetikler. Sorun giderme adımları için Başarılı bir API yüklemesinden sonra kullanıcı arayüzü teşhis uyarıları başlıklı makaleyi inceleyin.

Başarılı bir API yüklemesinden sonra kullanıcı arayüzü teşhis uyarıları

ConversionAdjustmentUploadService hizmetini kullanarak ENHANCEMENT düzenlemeleri yüklediğinizde API, yükleme sırasında istek biçimlendirmesini doğrular ve geliştirmeleri web sitesi etiketi etkinlikleriyle eşzamansız olarak eşleştirir. Bu nedenle, API istekleri partial_failure_error alanında hata olmadan başarılı olabilir ve çevrimdışı veri teşhislerinde EXCELLENT durumunu gösterebilir. Aynı zamanda, Google Ads kullanıcı arayüzündeki gelişmiş dönüşümler teşhis raporu uyarı göstermeye devam edebilir.

Başarılı API yüklemelerinden sonra kullanıcı arayüzü teşhis uyarıları görünüyorsa aşağıdaki nedenleri kontrol edin:

• Zorunlu adres alanları eksik: address_info alanındaki bir OfflineUserAddressInfo nesnesi, aynı girişte dört alan gerektirir: hashed_first_name, hashed_last_name, country_code ve postal_code. hashed_street_address, city ve state alanları isteğe bağlıdır (hashed_street_address alanını doldurursanız geçerli bir 64 karakterlik SHA-256 onaltılık özet olmalıdır). API, partial_failure_error alanında hata döndürmeden boş olmayan kısmi address_info nesnelerini (yalnızca ad ve soyadı gibi) kabul eder. Ancak alt eşleme, eksik adresleri siler ve eksik adres alanları için uyarı tetikler. Zorunlu dört alandan herhangi biri mevcut değilse address_info alanı için UserIdentifier nesnesini atlayın.

• Web sitesi etiketi etkinliklerinde işlem kimlikleri eksik: API'deki bir ENHANCEMENT ayarlamasından order_id alanının çıkarılması, eşzamanlı bir FieldError.REQUIRED hatası döndürür. API istekleriniz order_id alanını içerdiğinde, dönüşüm etkinliğinde işlem kimliği eksik uyarısı web sitesi etiketinizi ifade eder. Bu uyarı, web sitesi dönüşüm etiketi etkinliklerinin %90'ından azı geçerli bir işlem kimliği içerdiğinde (veya etiket, "undefined" ya da "null" gibi yer tutucu dizeler gönderdiğinde) gösterilir. Web sitesi dönüşüm etiketinizi her dönüşüm etkinliği için benzersiz bir işlem kimliği gönderecek şekilde yapılandırın.

• Etiket ve API sipariş kimliği uyuşmazlığı veya geç yüklemeler: ENHANCEMENT düzenlemeleri için API, yükleme sırasında CONVERSION_NOT_FOUND veya CONVERSION_EXPIRED hatası döndürmez. Bunun yerine, eşleşmeyen order_id değerleri, kullanıcı arayüzünde sipariş kimliği uyuşmazlığı uyarısını tetikler ve dönüşümden 24 saatten daha uzun bir süre sonra yüklenen geliştirmeler, geç yükleme uyarısını tetikler. API order_id alanını, web sitenizin dönüşüm etiketi tarafından gönderilen işlem kimliği dizesiyle tam olarak eşleştirin ve geliştirmeyi dönüşüm etkinliğinden sonraki 24 saat içinde yükleyin.

• Yüklemeden önce karma oluşturma işlemi uygulanmış normalleştirilmemiş kullanıcı verileri: Normalleştirilmemiş değerlere (ör. büyük harfler, baştaki veya sondaki boşluklar ya da E.164 biçimi dışındaki telefon numaraları) karma oluşturma işlemi uygulandığında geçerli bir 64 karakterlik SHA-256 onaltılık özet oluşturulur. API, INVALID_USER_IDENTIFIER hatası döndürmeden yüklemeyi kabul eder ancak alt akış eşleşmesi başarısız olur ve biçimlendirme veya düşük eşleşme oranı uyarıları bildirir. Kullanıcı tarafından sağlanan verileri normalleştirme ve karma oluşturma işlemi uygulama bölümündeki normalleştirme kurallarına uyun.

• Web sitesi etiketi hacmine kıyasla düşük API geliştirme hacmi: Kullanıcı arayüzü teşhisleri, kullanıcı kimliği içeren tekilleştirilmiş API geliştirmelerini, izin verilen tekilleştirilmiş web sitesi etiketi etkinlikleriyle karşılaştırır:

  • İzin modu yapılandırması: Google etiketindeki izin modu ad_storage='denied' ayarını işaret ettiğinde kullanıcı arayüzü teşhisleri, izin verilmeyen web sitesi etiketi etkinliklerini karşılaştırmadan hariç tutar. Bu nedenle, söz konusu etkinliklerin API yüklemelerinden çıkarılması düşük hacim uyarısını tetiklemez. Ancak web sitesi etiketiniz ile arka uç tetikleyicileriniz arasında uyumsuz izin işleme uyarıları:

    • Etikette ad_storage='denied' yok, arka uç yüklemeyi atlıyor: Kullanıcı arayüzü teşhisleri, etiket etkinliklerini izin verilmiş olarak sayar ve düşük kapsam uyarısı bildirir.
    • Etiket sinyalleri ad_storage='denied', arka uç yüklemeleri geliştirmesi: Yüklenen geliştirmelerde eşleşen bir izinli etiket etkinliği yok ve bu durum, sipariş kimliği uyuşmazlığı uyarılarına katkıda bulunuyor.

    Hem web sitesi etiketinize hem de API geliştirme yüklemelerinize aynı izin durumunu uygulayın.

  • Anonim web sitesi etkinlikleri: Web sitesi etiketinin anonim ziyaretçiler için tetiklendiği, dönüşüm hunisinin üst kısmındaki dönüşüm işlemlerinde (ör. sayfa görüntülemeleri veya öğe görüntülemeleri) gelişmiş dönüşümleri etkinleştirmeyin. Sunucunuz yalnızca kişi ayrıntıları bilinen oturum açmış kullanıcılar için API geliştirmeleri gönderiyorsa eşleşmeyen anonim etiket etkinlikleri, düşük kapsam uyarısını tetikler. Gelişmiş dönüşümleri yalnızca kullanıcı tarafından sağlanan verilerin tutarlı bir şekilde kullanılabildiği dönüşüm işlemlerinde etkinleştirin.

Genel dönüşüm yönetimi sorunları

Aşağıdaki yaygın sorunları göz önünde bulundurun:

• Herhangi bir enum alanını UNKNOWN olarak ayarlamaya çalışmak RequestError.INVALID_ENUM_VALUE hatasına neden olur. Bu, reklamveren iznin verilip verilmediğini bilmediğinde consent değerini belirtirken sık karşılaşılan bir sorundur. consent durumu bilinmiyorsa DENIED olarak ayarlanmalıdır.

• Uygulama dönüşümleri veya Firebase ve üçüncü taraf uygulama analizi için dönüşüm işlemi oluştururken app_id alanını yalnızca oluşturma sırasında değiştirebilirsiniz. Dönüşüm işlemi oluşturulduktan sonra bu alan değiştirilemez.

• Dönüşüm işlemi oluştururken ConversionAction.attribution_model_settings.attribution_model alanını yalnızca GOOGLE_ADS_LAST_CLICK veya GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN olarak ayarlayabilirsiniz. Başka bir seçenek belirlerseniz CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS hatası alırsınız. Diğer ilişkilendirme modellerinin kullanımdan kaldırılacağını duyurduğumuz blog yayınımızda daha fazla bilgi bulabilirsiniz.

• click_through_lookback_window_days alanı için izin verilen aralık, AD_CALL ve WEBSITE_CALL türündeki dönüşüm işlemleri için 1 ila 60 gündür. Diğer dönüşüm işlemlerinin çoğu için izin verilen aralık 1 ila 90 gündür.

• view_through_lookback_window_days alanı için izin verilen aralık, çoğu dönüşüm işleminde 1 ila 30 gündür. Bu alan, AD_CALL ve WEBSITE_CALL türündeki dönüşüm işlemleri için ayarlanmamış olmalıdır.

• Bir dönüşüm işleminde include_in_conversions_metric alanını ayarlamak veya güncellemek FieldError.IMMUTABLE_FIELD hatasına neden olur. Bunun yerine, dönüşüm hedefleri kılavuzunda açıklandığı şekilde primary_for_goal alanını ayarlayın.

• WEBSITE_CALL veya AD_CALL türünde bir dönüşüm işlemi oluştururken value_settings.always_use_default_value, true olarak ayarlanmalıdır. false değerinin belirtilmesi INVALID_VALUE hatasına neden olur.

Sık karşılaşılan hatalar

Aşağıdaki kılavuz, hesaplar arası dönüşüm izleme erişim hataları da dahil olmak üzere çevrimdışı dönüşüm içe aktarma işlemlerinde sık karşılaşılan hataları teşhis etmenize ve düzeltmenize yardımcı olur.

Hata
INVALID_CONVERSION_ACTION_TYPE	Belirtilen dönüşüm işleminin türü, tıklama dönüşümlerini yüklemek için geçerli değil. Yükleme isteğinizde belirtilen ConversionAction öğesinin türünün UPLOAD_CLICKS olduğundan emin olun.
NO_CONVERSION_ACTION_FOUND	Belirtilen dönüşüm işlemi etkinleştirilmemiş veya isteğin customer_id alanındaki hesap tarafından erişilemiyor. Dönüşüm işleminin etkinleştirildiğini doğrulamak için dönüşüm izleme ayarlarınızla ilgili bilgileri alın. Dönüşüm işleminin sahibi, tıklamanın Google Ads reklam dönüşümü müşterisi veya yükleme yapan hesabın dönüşüm izleme hiyerarşisindeki bir hesap olmalıdır. Örneğin, dönüşüm işlemi tıklamadan sonra bağlantısı kaldırılan eski bir yönetici hesabına aitse bu hata oluşur.
TOO_RECENT_CONVERSION_ACTION	Dönüşüm işlemi yeni oluşturulmuştur. Başarısız dönüşümleri yeniden denemeden önce, işlem oluşturulduktan sonra en az 6 saat bekleyin.
INVALID_CUSTOMER_FOR_CLICK	İstekteki customer_id alanı, tıklama anındaki Google Ads reklam dönüşümü müşterisi ile eşleşmiyor. Bu hata, yükleme yapan hesabın dönüşüm işlemine hesaplar arası erişimi de olmadığında ortaya çıkar. İsteğin customer_id alanını, dönüşüm işlemi sahibinin hiyerarşisindeki bir hesapla güncelleyin.
EVENT_NOT_FOUND	Google Ads, tıklama kimliği ve customer_id kombinasyonunu bulamıyor. customer_id için geçerli şartları inceleyin ve doğru Google Ads hesabını kullanarak yükleme yaptığınızı onaylayın.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	İstekteki birden çok dönüşüm aynı tıklama kimliği, conversion_date_time ve conversion_action kombinasyonuna sahip. İsteğinizden yinelenen dönüşümleri kaldırın.
CLICK_CONVERSION_ALREADY_EXISTS	Aynı tıklama kimliği, conversion_date_time ve conversion_action kombinasyonuna sahip bir dönüşüm daha önce yüklenmiş. Yüklemeyi yeniden deniyorsanız ve bu dönüşüm daha önce başarılı olduysa bu hatayı yoksayın. Daha önce yüklenen dönüşüme ek olarak başka bir dönüşüm eklemek istiyorsanız daha önce yüklenen dönüşümün kopyalanmasını önlemek için ClickConversion öğesinin conversion_date_time değerini ayarlayın.
EXPIRED_EVENT	İçe aktarılan tıklama, click_through_lookback_window_days alanında belirtilen zaman aralığından önce gerçekleşti. click_through_lookback_window_days üzerinde yapılan bir değişiklik yalnızca değişiklikten sonra kaydedilen tıklamaları etkiler. Bu nedenle, yeniden inceleme aralığının değiştirilmesi söz konusu tıklamayla ilgili bu hatayı çözmez. Uygunsa conversion_action işlemini daha uzun bir yeniden inceleme aralığına sahip başka bir işlemle değiştirin.
CONVERSION_PRECEDES_EVENT	conversion_date_time, tıklamanın tarih ve saatinden önce. conversion_date_time değerini daha sonraki bir değere güncelleyin.
VALUE_MUST_BE_UNSET	ClickConversion, gbraid veya wbraid için bir değer kümesine sahip (gclid olmadan) ve Google Ads'in gbraid veya wbraid ile desteklemediği custom_variables ya da cart_data için bir değere sahip. Çakışan alanı kaldırın.