Dokümantasyon bölümleri
Para
Google Ads: bağlantı ve dönüşümler
Tüm Google ayarları Kaynaklar → Reklam hesabı → Google bölümündedir: kendi OAuth uygulamanız, hesap, işlemler, tarayıcı etiketleri, harcama ve gönderim geçmişi. Akışta yalnızca bu kaynağı seçin. Akışın ayrı Google bağlantısı veya işlem kimlikleri yoktur.
Bu kılavuzda: kaynakların sahipliği · bağlantı seçenekleri · ön koşullar · Google Cloud ve OAuth · kaynağı bağlama · hesap seçimi · işlem kimliklerini elle girme · kimlikler ve etiketler · ayrı akışlar · postback gönderimi · tarayıcı etiketleri · harcamalar · doğrulama · sorun giderme · bakım · sık sorulan sorular.
1. Hesaplar ve izinler kime ait?
| Kaynak | Sahibi ve amacı |
|---|---|
| Google Cloud projesi | Size aittir. API’leri bu projede etkinleştirir ve erişimlerini yönetirsiniz. |
| OAuth Client ID ve Client Secret | Kendi Cloud projenizdeki uygulamanızın kimlik bilgileridir. Uygulamanız, seçtiğiniz Google kullanıcısından izin ister. |
| Google kullanıcısı ve Ads hesabı | Seçilen kullanıcının hedef Ads hesabına erişimi olmalıdır. E-posta adresi, on haneli reklam hesabı kimliği değildir. |
| Yönetici hesabı / MCC | Bu erişim yolu gerekiyorsa kendi yönetici hesabınız veya seçilen Google kullanıcısının zaten erişebildiği bir yönetici hesabıdır. |
| ArtisanClo | Yazılımı, sunucuyu ve OAuth dönüş adresini sağlar; ayarları saklar, postback’leri alır, yetkilendirilmiş token’ları yeniler, olayları gönderir ve yanıtları gösterir. |
Bu Ads entegrasyonu, ArtisanClo’ya ait ortak bir OAuth uygulaması, Cloud projesi, developer token veya MCC kullanmaz. Başka bir müşterinin kimlik bilgilerini sizin yerinize kullanmaz. Sunucu istekleri yine ArtisanClo altyapısında çalışır; kendi uygulamanızı kullanmanız, isteklerin bilgisayarınızdan çıktığı anlamına gelmez.
Client Secret, erişim ve yenileme token’ları şifrelenerek saklanır. Kaydedilmiş gizli bilgiler ayar formuna geri gönderilmez. Kayıtlı bir gizli bilgi alanını boş bırakmak önceki değeri korur. Ziyaretçilere yalnızca herkese açık etiket kimlikleri ve etiket değerleri verilir. Kaynakların ayrılması Google kısıtlamalarına karşı garanti sağlamaz; Google’ın kuralları hesaplar, uygulamalar ve hizmet kullanımı için geçerlidir.
2. İhtiyacınız olan özellikleri seçin
| Seçenek | Gerekenler | Sağladıkları | Sağlamadıkları |
|---|---|---|---|
| Sunucu dönüşümleri | Kendi OAuth uygulamanız, Data Manager API, Ads hesap kimliği ve işlem kimlikleri | ArtisanClo dönüşümü aldıktan sonra lead ve satış gönderir | Tek başına hesap listeleme veya harcama aktarımı sağlamaz |
| Ek Google Ads API erişimi | Cloud projenizin hedef hesaplara erişimi ve Google Ads OAuth izni | Hesapları listeler, içe aktarma işlemleri oluşturur veya mevcutları kullanır, harcama aktarımını açar | Google kullanıcınızın yönetemediği hesaplara erişim sağlamaz |
| Yalnızca tarayıcı | Conversion ID/label ve sayfadaki ArtisanClo JavaScript etiketi | Teklif ziyareti ve form gönderimi olayları | Geç gelen postback’ler veya harcamalar; Google ile giriş gerekmez |
| Zamanlanmış dosya | Kaynağın veri akışı URL’si ve Google Ads’te yükleme planı | Google hazırlanmış çevrimdışı dönüşümleri alır | OAuth yetkilendirmesi veya postback geldiğinde anında gönderim sağlamaz |
Sunucu ve tarayıcı gönderimini birlikte açabilirsiniz. Farklı anları gözlemlerler ve otomatik olarak tek dönüşümde birleşmezler. Yinelenen kayıtları ve dönüşüm hedeflerini inceleyin.
Google bu gereksinimi 9 Eylül 2026’da kaldırdı. Google Ads API erişimi artık OAuth kimlik bilgilerinizin sahibi olan Cloud projesine bağlıdır. Bu bağlantı için MCC üzerinden yeni developer token başvurusu yapmayın; projenizin Google Ads API Overview ekranını kontrol edin. Google’ın geçiş duyurusu. ArtisanClo bunu istemez ve saklamaz; daha önce kaydedilen token’lar silindi.
3. Takibi ve kaynağınızı hazırlayın
- Planınız reklam platformlarına dönüşüm gönderimini içermelidir. Harcama aktarımı ayrı bir plan özelliğidir. Bir özellik kullanılamıyorsa ayarlarda plan kısıtlamaları gösterilir.
- Takip özelliği açık bir akış kullanın. Yalnızca cloaking kullanan akışlar kaynak dönüşümlerini göndermez. Kaynağı akışın takip ayarlarından seçin.
- Sitenizden, satış ortaklığı ağınızdan veya harici takip sisteminizden gelen dönüşümleri yapılandırın. ArtisanClo tıklama kimliğini teklife iletin ve postback içinde geri gönderin.
- Reklam ziyaretlerinde gerçek bir
gclid,gbraidveyawbraidkorunduğunu kontrol edin. ArtisanClo’nun dahiliclick_iddeğeri postback’i ziyarete, Google tanımlayıcısı ise ziyareti reklama bağlar. Her iki bağlantı da gereklidir. - Hedef Ads hesabında veya erişilebilir bir MCC’de yeterli yetkisi olan bir Google kullanıcısı seçin. Cloud izinleri tek başına Google Ads hesabına erişim vermez.
Normal gönderimler için Google tıklama kimliği uydurmayın. gad_source, UTM değerleri, e-posta ve işlem kimlikleri onun yerine geçmez. Google’ı sonradan bağlamak ilk ziyarette bulunmayan bir kimliği geri getirmez.
4. Kendi Google Cloud uygulamanızı kurun
- Google Cloud Console’u açın ve kontrolünüzdeki bir projeyi seçin veya oluşturun.
- Sunucudan dönüşüm göndermek için API kitaplığında Data Manager API’yi etkinleştirin.
- Hesapları listelemek, işlemleri otomatik oluşturmak veya harcamaları almak için Google Ads API’yi de etkinleştirin. Google Ads API Overview üzerinden projenizin erişim düzeyini kontrol edin ve kullanacağınız hesaplar için Google’ın gereksinimlerini tamamlayın. Yalnızca test erişimi, üretim reklam hesapları için yeterli değildir. Proje erişim düzeyleri.
- Google Auth Platform içinde uygulamanızın kimliğini, iletişim e-postasını ve hedef kitlesini ayarlayın. Kurum içi hedef kitle yalnızca o kurumun kullanıcılarına açıktır. Testing modunda, kullanacağınız Google adresini test kullanıcısı olarak ekleyin.
- Web application türünde bir OAuth Client ID oluşturun. ArtisanClo’da kaynak → Reklam hesabı → Google → sunucu dönüşümleri → kendi Google Cloud OAuth uygulamanız bölümünü açın. Gösterilen Authorized redirect URI değerini bu OAuth istemcisinin ayarlarına kopyalayın.
- Client ID ve Client Secret değerlerini kaynağa kopyalayın. Client ID genellikle
.apps.googleusercontent.comile biter. Bu alanlara API anahtarı, Ads hesap numarası veya tüm JSON dosyasını yapıştırmayın.
Dönüş adresini protokol, alan adı ve yol dahil tam olarak kopyalayın. /en/ kısmını panelinizin diliyle değiştirmeyin; dönüş yolu sabittir. Yerel ve üretim kurulumları farklı adresler gösterebilir. Google’ın web OAuth gereksinimleri.
Sunucu bağlantısı openid, email ve https://www.googleapis.com/auth/datamanager izinlerini ister. Google Ads API seçeneğini açmak https://www.googleapis.com/auth/adwords iznini ekler. Seçtiğiniz özellikler için gerekli izinleri verin. Bu sunucu bağlantısını tamamlamak için Data Manager izni zorunludur.
Testing modundaki harici bir uygulamanın bu API kapsamlarıyla aldığı yenileme token’ı genellikle yedi gün geçerlidir. Kesintisiz gönderim için uygulamanın yayın durumunu ayarlayın ve geçerli Google doğrulama gereksinimlerini karşılayın. OAuth uygulamasının yayınlanması/doğrulanması ile Cloud projesinin Ads API erişimi ayrı ayarlardır. OAuth token süreleri.
Google ekran adları değişebilir. Kendi uygulamanızın kimliğini kullanın ve yalnızca kontrol ettiğiniz alan adlarının sahipliğini belirtin. Google alan adı veya uygulama doğrulaması istiyorsa gerçek yapılandırmanıza uygun gereksinimleri yerine getirin; ArtisanClo’yu bağlamak bu sürecin yerine geçmez.
5. Kaynağı bağlayın
- Kaynaklar bölümünde Google kaynağınızı oluşturun veya düzenleyin. İşletmeyi ya da hesabı belirten bir ad verin.
- Reklam hesabının dönüşüm ve harcama bölümünü açın, Google’ı seçin ve sunucudan lead/satış gönderimini etkinleştirin.
- Client ID ve Client Secret girin. Cloud projeniz hazırsa «Hesap listeleme, dönüşüm oluşturma ve harcamalar (Google Ads API)» seçeneğini açın.
- «Kaydet ve Google hesabımı bağla» düğmesine basın. Google açılmadan önce kaynak kaydedilir. Uygun Google kullanıcısını seçip kendi uygulamanızı yetkilendirin.
- Döndüğünüzde bağlı e-postayı kontrol edin, reklam hesabını ve dönüşüm işlemlerini ayarlayın. «Bağlı» ifadesi kayıtlı yetkilendirmeyi doğrular; belirli bir dönüşümün teslim edildiğini göstermez.
ArtisanClo paneline Google ile giriş yapmak ve bir reklam kaynağını yetkilendirmek ayrı işlemlerdir. Ads bağlantısı, o kaynakta kayıtlı Client ID’yi kullanır.
Yetkilendirmeyi aynı tarayıcı oturumunda on dakika içinde tamamlayın. Yeni bir bağlantı başlatmak bekleyen bağlantıyı değiştirir. Eski bir sekmeye dönerseniz veya istek zaman aşımına uğrarsa kaynaktan yeniden başlayın.
Giriş başarısız olursa kabine nedeni gösterir:
| Neden | Ne yapılmalı |
|---|---|
| Dönüşüm gönderme erişimi işaretlenmedi | Yeniden giriş yapın ve Google ekranındaki tüm izinleri işaretli bırakın |
| Google kalıcı erişim vermedi | Google Hesabınızda uygulamanın erişimini kaldırın (Güvenlik → Üçüncü taraf uygulamalar) ve yeniden giriş yapın |
| Google Client ID veya Client Secret’ı kabul etmedi | Bunları Google Cloud’daki OAuth istemcinizle karşılaştırın |
| Giriş sırasında kaynağın Client ID, Secret veya erişimleri değişti | Kaynağı kaydedip yeniden giriş yapın |
| Google hesap e-postasını doğrulamadı | E-postası doğrulanmış bir hesapla giriş yapın |
| Google erişim vermedi | OAuth istemcinizdeki redirect URI’yi kontrol edip yeniden deneyin |
6. Hesabı seçin ve işlemleri otomatik yapılandırın
- Google Ads API’yi yetkilendirdikten sonra «Hesaplarımı göster» düğmesine basın. Listede MCC müşterileri dahil erişilebilir reklam hesapları bulunur. Liste boşsa Google kullanıcısını, Ads izinlerini ve Cloud projesinin erişimini kontrol edin.
- On haneli hesap kimliğini doğrulayıp «Seç ve yapılandır» düğmesine basın. Bu düğme hesapta gerçek dönüşüm işlemleri oluşturabilir.
- Doldurulan hesap kimliğini, gerekiyorsa yönetici kimliğini ve lead ile satış işlem kimliklerini inceleyin.
| ArtisanClo durumu | Ads’teki tam işlem adı | Oluşturulan işlem |
|---|---|---|
lead | AC — Lead | Tıklama içe aktarma (UPLOAD_CLICKS), lead formu gönderimi kategorisi, tıklama başına bir |
sale | AC — Sale | Tıklama içe aktarma (UPLOAD_CLICKS), satın alma kategorisi, tıklama başına birden fazla |
Bu tam adlara sahip etkin ve uyumlu işlemler yeniden kullanılır. Uyumsuz tür veya durum, yapılandırmayı hatayla durdurur; mevcut işlemler sessizce değiştirilmez. İki işlemin oluşturulması birbirinden ayrıdır: ikincisi başarısız olursa birincisi zaten oluşmuş olabilir ve hatayı giderip yeniden denediğinizde kullanılır.
MCC yapılandırmasında dönüşüm takibi başka bir hesaba aitse otomatik kurulum google_shared_conversion_account döndürür. Önce Google Ads’te dönüşümlerin sahibini kontrol edin; yönetici kimliğini değiştirmek işlemleri taşımaz.
Otomatik kurulum sunucu işlem kimliklerini doldurur. Tarayıcı Conversion ID/label değerlerini oluşturmaz veya getirmez. Tarayıcı olaylarını ayrıca yapılandırın; Google Ads’te kampanya dönüşüm hedeflerini ve teklif ayarlarını inceleyin.
7. Google Ads API olmadan kimlikleri elle girin
Data Manager API ve OAuth yetkilendirmeniz, hesap listeleme ve işlem oluşturma kapalıyken de postback gönderebilir.
- Google Ads’te tıklama içe aktarma dönüşüm işlemlerini hazırlayın. İki durumu da istiyorsanız lead ve satış için ayrı işlemler kullanın.
- Google Ads Account ID alanına reklam hesabı numarasını, örneğin
123-456-7890, girin. API isteklerinde tireler kaldırılır. - Erişiminiz MCC üzerinden ise MCC kimliğini girin. Doğrudan erişim için boş bırakın.
- Google Ads’te her dönüşüm işlemini açın ve sayfa URL’sindeki
ctIdparametresi olan sayısal kimliği ilgili lead veya satış alanına kopyalayın. - Kaynağı kaydedin ve açık olan her durum için doğrulamayı çalıştırın.
Boş işlem alanı o durumu devre dışı bırakır. Yalnızca satış göndermek için satış alanını doldurup lead alanını boş bırakın. Sunucu işlem kimliği alanına AW-… veya Conversion label girmeyin.
8. Hesap kimliklerini, işlem kimliklerini ve etiketleri ayırt edin
Bu değerler örnektir; kullanılabilir kimlik bilgileri değildir.
| Alan | Örnek | Amaç |
|---|---|---|
| Google Ads Account ID | 1234567890 | Sunucu olaylarını alan veya harcama verisi sağlayan reklam hesabı |
| Yönetici hesabı / MCC | 9876543210 | Erişim yolu; reklam hesabının yerine geçmez |
| İşlem kimliği / ctId | 111111111 | Sunucudan gönderilen lead veya satışın hedefi |
| GTAG ID / Conversion ID | AW-12345678901 | Tarayıcı gönderimi için herkese açık Google etiketi kimliği |
| Conversion label | ExampleLeadLabel | Belirli tarayıcı işlemini tanımlar |
| Tarayıcı hedefi | AW-12345678901/ExampleLeadLabel | Olay kodundaki kimlik ve etiketin birleşimi |
| Client ID / Client Secret | OAuth uygulamanızın kimlik bilgileri | Yetkilendirme ve erişim yenileme; ziyaretçi etiketine asla eklenmez |
9. Akışta bir kaynak seçin
Tüm Google ayarları Kaynaklar → Reklam hesabı → Google bölümündedir: kendi OAuth uygulamanız, hesap, işlemler, tarayıcı etiketleri, harcama ve gönderim geçmişi. Akışta yalnızca bu kaynağı seçin. Akışın ayrı Google bağlantısı veya işlem kimlikleri yoktur.
Başka Google hesabı veya farklı işlemler için başka kaynak oluşturup akışta seçin. Kaynak değişiklikleri onu seçen tüm akışlara uygulanır. Tarayıcı etiketi ve postback gönderimleri seçili kaynağı kullanır. Kuyruktaki dönüşüm gönderilmeden kaynak değişirse eski gönderim google_connection_changed ile durur.
10. Bir sunucu dönüşümünün yolunu izleyin
- Reklam ziyareti, gerçek Google tıklama tanımlayıcısı ve ArtisanClo’nun dahili tıklama kimliği ile kaydedilir.
- Siteniz veya ağınız, ArtisanClo tıklama kimliğini geri göndererek yapılandırılmış dönüşüm alıcısı üzerinden lead/satış bildirir.
- Tüm Google ayarları Kaynaklar → Reklam hesabı → Google bölümündedir: kendi OAuth uygulamanız, hesap, işlemler, tarayıcı etiketleri, harcama ve gönderim geçmişi. Akışta yalnızca bu kaynağı seçin. Akışın ayrı Google bağlantısı veya işlem kimlikleri yoktur.
- Sunucu, uygulamanızın geçerli OAuth token’ıyla hesabınız ve işleminiz için Data Manager API’yi çağırır.
- Sonuç gönderim geçmişine kaydedilir. Google olayı ayrıca işler ve ilişkilendirir.
İstek Google tıklama tanımlayıcısını, olay zamanını, USD cinsinden dönüşüm değerini ve yinelemeyi önleyen bir olay kimliğini içerir. Değer, reklam harcamasından değil ArtisanClo’da kayıtlı dönüşüm ödemesinden alınır. Sunucu gönderimi sabahki harcama aktarımını beklemez.
Her dönüşüm/durum çifti bir kez gönderilir. Lead’den satışa geçiş iki ayrı işlem gönderebilir. Hold, rejected ve trash bu eşleme üzerinden gönderilmez. Daha önce gönderilen bir lead’i reddetmek Google dönüşümünü otomatik olarak geri çekmez. Aynı durumda değişmiş bir tutarı yeniden göndermek Google Ads değer düzeltmesi değildir.
Bu arayüzde başarısız denemeleri otomatik yineleme veya geçmişi toplu yükleme yoktur. Yeniden bağlanmak gelecekteki olaylar için erişimi geri getirir. Aynı postback’i ve durumu tekrarlamak yeniden gönder düğmesi yerine geçmez. Ayarları doğrulamayla, tüm zinciri ise yeni ve izinli bir test dönüşümüyle kontrol edin.
11. Google kimlikleri ve etiketleriyle tarayıcı olayları
Google Ads API açık ve hesap seçiliyken kaynağın tarayıcı bölümünde «Etiketleri Google’dan ayarla» düğmesine basın. AC — Offer visit ve AC — Form lead oluşturulur veya kullanılır; kimlik/etiketleri alınır. Yeni işlemler ikincil hedeflerdir. ArtisanClo JavaScript etiketini sayfaya kurun; düğme kurulum yapmaz. API yoksa aşağıdaki manuel alanları kullanın.
Tarayıcı gönderimi OAuth’tan bağımsızdır. Ziyaretçi sayfadayken teklif ziyaretini ve form gönderimini gözlemler; ziyaretçi ayrıldıktan sonra geç gelen bir postback’i gönderemez.
- Sayfaya ArtisanClo JavaScript etiketini kurun ve akış takibini açın.
- Google Ads’te ilgili web sitesi dönüşümünü açın → etiket kurulumu → «Use Google Tag Manager». Conversion ID ve Conversion label değerlerini kopyalayın. Bu sekme değerleri gösterir; ArtisanClo kullanmak tek başına GTM kurulumu gerektirmez.
- Kaynakta tarayıcı dönüşümlerini açın. Teklif ziyareti için GTAG ID ve GTAG Click Label, form için GTAG Conversion ID ve GTAG Conversion Label (Lead) girin.
- Alternatif olarak «Olay kodu yapıştır» bölümünü açıp tek bir hedefin kodunu yapıştırın. ArtisanClo kimliği/etiketi çıkarır; yapıştırılan JavaScript çalıştırılmaz.
- Gösterilen
AW-ID/labeldeğerini kontrol edip kaydedin. Özellik açıkken en az bir olay eksiksiz olmalıdır. Tüm olayları kapatmak için tarayıcı seçeneğini kapatın.
Örneğin gtag('event', 'conversion', {'send_to': 'AW-12345678901/ExampleLeadLabel'}); kodundan AW-12345678901/ExampleLeadLabel hedefi kaydedilir. Aynı alanda iki farklı hedefi karıştırmayın. Etiketsiz bir kimlik eksiktir.
Çalışan kod Google etiketini otomatik yükler ve mevcut gtag işlevini yeniden kullanır. Ön açılış sayfasında teklif olayı, sayfa açıldığında değil teklif bağlantısı izlendiğinde oluşur. Yönlendirmeden önce olay geri çağrısını en fazla 800 ms bekler; ardından Google engellense bile devam eder.
Normal form olayı, submit engellenmemişse tarayıcının yerleşik alan doğrulamasından sonra tetiklenir. Bu, sunucunuzun formu kabul ettiğini kanıtlamaz. AJAX formlarında aşağıdaki olayı form işleyicinizden başarılı yanıt aldıktan sonra gönderin:
document.dispatchEvent(new Event('artisanclo:lead'));
Bunu yalnızca düğmeye basıldığında, doğrulama başarısız olduğunda veya sunucu yanıtından önce göndermeyin. Google etiketini bilgilendirir; tek başına ArtisanClo dönüşümü oluşturmaz. Gelen dönüşümleri ayrıca yapılandırın.
Ana sayfanın etiketi, üçüncü taraf iframe içindeki bir formu veya etiketinizin bulunmadığı harici sitedeki sonraki işlemleri gözlemleyemez. Reklam engelleyiciler, CSP ve izin ayarları gönderimi etkileyebilir. Entegrasyon sitenizin kullanıcı izni yapılandırmasını geçersiz kılmaz.
12. Yinelenen kayıtları önleyin ve dönüşüm hedeflerini seçin
Aynı tarayıcı işlemini aynı kimlik/etiketle hem GTM’den hem ArtisanClo’dan göndermeyin. ArtisanClo, aynı tıklama için aynı tür olayların tekrarını sınırlar ve Google’a bir işlem tanımlayıcısı sağlar.
Sunucu ve tarayıcı olayları ayrı mekanizmalar kullanır; ortak otomatik tekilleştirme garantisi yoktur. Tarayıcıdaki form gönderimi ve onaylanmış postback farklı hedefleri temsil edebilir. Google Ads’te hangi işlemlerin birincil olduğunu ve kampanya optimizasyonunda kullanıldığını inceleyin. Postback’i reddetmek, gönderilmiş tarayıcı olayını iptal etmez.
13. Harcamaları içe aktarın
- Kendi OAuth uygulamanıza Google Ads API izni verin ve Cloud projenizin üretim hesaplarına erişimini kontrol edin.
- Kaynağın reklam hesabı harcama bölümünde Google’ı seçin.
- Harcama sağlayacak reklam hesabını belirtin. Otomatik hesap kurulumundan sonra önerilen numarayı kontrol edin; daha önce doldurulmuş harcama hesabı otomatik değiştirilmez.
- Kaynağı kaydedin. Planınız bu özelliği içeriyorsa harcamalar zamanlamaya göre alınır.
İçe aktarma her sabah önceki üç tamamlanmış günü yeniden okuyarak düzeltmeleri alır. Bugünün harcamasını canlı gösteren bir sayaç değildir. Değerler reklam hesabının para biriminde okunur ve mevcut döviz kuruyla USD’ye çevrilir.
Birden fazla akış aynı kaynağı paylaşıyorsa kampanya kimliklerini tıklamalarda koruyun; genellikle Google Ads şablonunda utm_campaign={campaignid} kullanılır. Ortak kampanyanın harcaması, teklife ulaşan ilgili tıklamalardaki akış payına göre bölünür; hiçbiri teklife ulaşmadıysa tüm ilgili tıklamalar kullanılır. Eşleşen tıklaması olmayan kampanyalar rastgele dağıtılmaz; kimlikleri içe aktarma hatasında gösterilir.
Kaynağın takip yapan tek akışı varsa hesaptan alınan tüm harcama bu akışa yazılır. Bu ayarı büyük bir hesaptaki tek kampanya için filtre olarak görmeyin. İçe aktarılan değerler elle girilmiş harcamaların üzerine yazılmaz. Harcama ayarlarında son eşitleme zamanını ve hatayı kontrol edin.
14. Kurulumu, gönderimi ve ilişkilendirmeyi ayrı doğrulayın
Tüm Google ayarları Kaynaklar → Reklam hesabı → Google bölümündedir: kendi OAuth uygulamanız, hesap, işlemler, tarayıcı etiketleri, harcama ve gönderim geçmişi. Akışta yalnızca bu kaynağı seçin. Akışın ayrı Google bağlantısı veya işlem kimlikleri yoktur.
Kayıt oluşturmadan doğrulama. Doldurulmuş bir sunucu durumunun yanındaki «Kaydet ve doğrulama gönder» düğmesine basın. Form kaydedilir ve Google, dönüşümü gerçekleştirmeden doğrulamak için validateOnly = true ile çağrılır. ArtisanClo’da gerçek dönüşüm oluşturulmaz; gönderim geçmişi doğrulama denemesini belirtir. Google validateOnly başvurusu.
Tüm Google ayarları Kaynaklar → Reklam hesabı → Google bölümündedir: kendi OAuth uygulamanız, hesap, işlemler, tarayıcı etiketleri, harcama ve gönderim geçmişi. Akışta yalnızca bu kaynağı seçin. Akışın ayrı Google bağlantısı veya işlem kimlikleri yoktur.
Tüm zincirin kontrolü. İzinli bir test senaryosunda reklam tıklamasını kaydedin, Google tıklama kimliğini doğrulayın, yeni dönüşümde dahili tıklama kimliğini kullanın, dönüşümü ArtisanClo’da bulun ve normal Google gönderimini inceleyin. Hedefi ve sonucu doğrulayıp daha sonra Google Ads’i kontrol edin. Bu, raporları etkileyebilecek gerçek bir gönderimdir.
Tarayıcı kontrolü. Google Tag Assistant kullanın, işlemi gerçekleştirin ve conversion olayını ve send_to hedefini inceleyin. Başarısız formlar başarı olayınızı göndermemelidir. Tarayıcı olaylarının sunucuda Google yanıt günlüğü veya validateOnly düğmesi yoktur.
15. Gönderim geçmişini okuyun
| Alan veya sonuç | Anlamı |
|---|---|
| Zaman, google kanalı, lead/sale | Denemenin zamanı ve durumu |
| Doğrulama başarılı | Doğrulama isteği kabul edildi; gerçek dönüşüm gerçekleştirilmedi |
| İstek kabul edildi / OK | API normal isteği kabul etti; ilişkilendirme henüz doğrulanmadı |
| HTTP durumu ve hata | İsteğin sonucu veya gönderimin gerçekleşmeme nedeni |
| Google yanıtı ve uyarılar | Başarılı yanıtlardaki uyarılar dahil ek ayrıntılar |
| requestId | Döndürülmüşse denemeyi incelemek için Google istek kimliği |
Kaynak, tüm geçmiş dışa aktarımı yerine son on gönderimi gösterir. Normal gönderimin dönüşümle bağlantısı, dönüşüm/tıklama geçmişinde de bulunur. Destek için kaynak, akış, zaman, durum, HTTP kodu, hata metni ve varsa requestId sağlayın. Client Secret, erişim veya yenileme token’larını göndermeyin.
16. Sorun giderme
| Belirti veya kod | Kontrol edilecekler |
|---|---|
| Bağlan düğmesi kullanılamıyor | Sunucu gönderimi açık, Client ID/Secret girilmiş ve planınız ile ekip rolünüz bu özelliğe izin veriyor olmalıdır. |
| redirect_uri_mismatch | Gösterilen dönüş adresi, protokol, alan adı, dil yolu ve sondaki eğik çizgi dahil bu OAuth istemcisinde aynen kayıtlı olmalıdır. |
| Google seçilen kullanıcıyı reddediyor | E-posta, uygulama hedef kitlesi, Test users ve Workspace kısıtlamaları. Uygulama sahipliği bilgilerini doğru girin. |
| Google’dan dönüşte 403 | On dakikalık süre, aynı tarayıcı/oturum, başka bekleyen bağlantı veya değişmiş kimlik bilgileri. Kaynaktan yeniden başlayın. |
| google_ads_api_disabled | Projede Google Ads API’yi ve kaynakta ilgili seçeneği açıp kaydedin. |
| google_scope_missing / yeniden bağlanma isteği | Yeniden bağlanıp API iznini verin. Cloud’da API açmak tek başına OAuth erişimi vermez. |
| google_auth | Sunucu Google erişimi alamadı. Günlükteki yanıt nedeni söyler: erişim iptal edildi veya süresi doldu, Client ID/Secret reddedildi ya da kaynakta Google bağlantısı kesildi. Düzeltip yeniden bağlanın. |
| CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION | Cloud projenizin Google Ads API erişimi üretim hesaplarını kapsamıyor. Google Ads API Overview ve erişim gereksinimlerini inceleyin. Developer token bunu çözmez. |
| Hesap bulunamıyor veya Google izin hatası | Kullanıcı, doğrudan/MCC erişimi, hesap durumu ve işlem yetkileri. Cloud erişimi kullanıcıyı Ads’e eklemez. |
| google_shared_conversion_account | Dönüşüm sahibi seçilen hesaptan farklı; hesaplar arası dönüşüm takibini inceleyin. |
| google_incompatible_conversion | Bu addaki işlem etkin ve tıklama içe aktarma türünde olmalıdır. Uyumlu bir işlem kullanın veya uygun kimliği elle girin. |
| no_click_id | İlk tıklamada gclid/gbraid/wbraid yok. Reklam URL’sini, parametrelerin korunmasını ve postback-tıklama eşleşmesini kontrol edin. |
| Dönüşüm kayıtlı, gönderim denemesi yok | Seçili kaynağı, izleme modunu, planı, sunucu anahtarını, Google yetkisini ve durum işlemini kontrol edin. Doğruysa destekten gönderim kuyruğunu incelemesini isteyin. |
| İstek kabul edildi, Ads dönüşümü yok | validateOnly olmadığını doğrulayıp hesap/işlem, gerçek tıklama kimliği, içe aktarma tanıları, rapor aralığı, dönüşüm aralığı ve Google işlemesini kontrol edin. HTTP 200 tek başına ilişkilendirmeyi kanıtlamaz. |
| Tarayıcı olayı yok | JS etiketi, tarayıcı seçeneği, eksiksiz kimlik/etiket, CSP, engelleyici, izin ayarları, iframe sınırları ve AJAX başarı olayı. Tag Assistant’ı inceleyin. |
| Harcama yok | Plan, Google Ads API izni, hesap numarası, tamamlanmış gün, kampanya-tıklama eşleşmesi ve son içe aktarma hatası. |
| 429 / istek sınırı | Arayüz isteklerini yinelemeden önce bekleyin. Google sınırları için proje kotalarını kontrol edin. Başarısız normal gönderimler otomatik tekrarlanmaz. |
17. Yeniden bağlanma, bağlantıyı kesme ve JSON’dan geçiş
Google Ads API ekleme. Projede ve kaynakta etkinleştirip yeniden bağlanın. Seçeneği kaydetmek mevcut yetkilendirmeyi genişletmez.
Client ID veya Secret değiştirme. Değişen uygulama kimlik bilgilerini kaydetmek mevcut OAuth yetkilendirmesini temizler. Yeniden bağlanın ve değişiklikten önce aynı kaynağı paylaşan tüm akışları dikkate alın.
Yalnızca postback gönderimini durdurma. Sunucu gönderimini kapatıp kaydedin. Tarayıcı olayları, zamanlanmış dosyalar ve harcamalar ayrı ayarlara sahiptir. Kaynağın Google ile tüm etkinliğini durdurmak için kullanılan her özelliği kapatın.
Erişimi kesme. Bu kaynağın kayıtlı OAuth yetkilendirmesini kaldırır. Google Ads’teki uygulamayı veya işlemleri silmez. Aynı müşteri uygulamasını kullanan diğer kaynakları etkileyebilecek genel Google izin iptalini çalıştırmaz. İzni Google’da kendiniz iptal ederseniz bu kaynakların tümünü kontrol edin.
Müşterinin mevcut hizmet hesabı JSON anahtarı. Daha önce bağlanan kaynaklar desteklenmeye devam eder. Geçiş için kaynakta kendi OAuth uygulamanızı yapılandırıp yetkilendirin. OAuth Client ID girmek OAuth yolunu seçer; giriş tamamlanmadan eski JSON anahtarına otomatik dönüş beklemeyin. Başarılı yetkilendirme eski sunucu dönüşüm anahtarını temizler. Harcamaları, Ads API iznini ve tüm işlemleri de kontrol edin.
Zamanlanmış Google Ads dosyası. Bu bağımsız seçenek, gclid içeren uygun olayları en fazla 90 gün için kapsar ve veri akışı ayarlarındaki dönüşüm adlarını kullanır. Bu adlar ctId veya tarayıcı etiketleri değildir. İstenmeyen yinelenen içe aktarmaları önlemek için aynı olaylara tek bir ana gönderim yolu seçin.
18. Sık sorulan sorular
- Google Cloud olmadan kullanabilir miyim?
- Tarayıcı kimliği/etiketiyle gönderim veya zamanlanmış dosya için evet. OAuth ile otomatik sunucu gönderimi kendi Cloud projenizi gerektirir.
- JSON olmadan kullanabilir miyim?
- Evet. Yeni bağlantı, indirilen hizmet hesabı anahtarı yerine Client ID, Client Secret ve Google yetkilendirmesi kullanır.
- Her şey otomatik mi?
- Google Ads API açık ve hesap seçiliyken kaynağın tarayıcı bölümünde «Etiketleri Google’dan ayarla» düğmesine basın.
AC — Offer visitveAC — Form leadoluşturulur veya kullanılır; kimlik/etiketleri alınır. Yeni işlemler ikincil hedeflerdir. ArtisanClo JavaScript etiketini sayfaya kurun; düğme kurulum yapmaz. API yoksa aşağıdaki manuel alanları kullanın. - ArtisanClo’nun MCC’si gerekli mi?
- Hayır. Doğrudan erişimde kendi MCC’niz de gerekli değildir. Yönetici kimliğini yalnızca erişim yolunuz gerektiriyorsa kullanın.
- Bir akış başka hesap kullanabilir mi?
- Başka Google hesabı veya farklı işlemler için başka kaynak oluşturup akışta seçin. Kaynak değişiklikleri onu seçen tüm akışlara uygulanır. Tarayıcı etiketi ve postback gönderimleri seçili kaynağı kullanır. Kuyruktaki dönüşüm gönderilmeden kaynak değişirse eski gönderim
google_connection_changedile durur. - Ziyaretçi ayrıldıktan sonra lead gönderilir mi?
- Eşleşen postback gelir ve sunucu gönderimi koşulları sağlanırsa evet. Yalnızca tarayıcı yapılandırması bunu yapamaz.
- Tarayıcı olayı neden ArtisanClo dönüşümlerinde yok?
- Google etiketi dönüşüm alıcısının yerine geçmez. Postback/site işleyicisini ve dahili tıklama kimliğini yapılandırın.
- Başarılı doğrulama ilişkilendirmeyi kanıtlar mı?
- Hayır. Tüm zinciri izinli gerçek bir reklam tıklamasıyla doğrulayın ve Google Ads’teki nihai sonucu kontrol edin.
İlgili bölümler: kaynaklar, akış takibi, gelen dönüşümler, dönüşüm geçmişi, raporlar ve harcamalar. Harici API gereksinimleri 19 Ekim 2026’da Google belgeleriyle karşılaştırıldı; projenizin ayarları ve ekran adları için güncel Google arayüzüne başvurun.
ArtisanClo · Panel dokümantasyonu. Sorularınız için: info@artisanclo.com veya Telegram’da @artisanclo_support.