Google Ads API'deki hesap türleri

Bu belgede, Google Ads API'deki hesapları açıklamak için kullanılan farklı terimler ve bunların birbiriyle ilişkisi açıklanmaktadır.

Genel Bakış

Google Ads API, hesapları tanımlamak için bazen kafa karışıklığına yol açabilecek çeşitli terimler kullanır. Bu ayrımları anlamak, hesapları yönetmek ve API yanıtlarını yorumlamak için önemlidir.

Hesap türleri

Aşağıdaki tanımlar, Google Ads API ile çalışırken karşılaşacağınız farklı hesap türlerini açıklamaktadır.

Yönetici hesabı

Yönetici hesabı, birden fazla Google Ads hesabını yönetmek için kullanılan birincil hesaptır.

• Eski adı: Daha önce "MM" (Müşteri Merkezim) olarak biliniyordu. Bu terimi eski belgelerde veya tartışmalarda görmeye devam edebilirsiniz.
• Amaç: Birden fazla hesabı tek bir hiyerarşi üzerinden bağlamak ve yönetmek istediğinizde yönetici hesabı kullanın.
• API temsili: customer.manager değerinin true olduğu bir Customer kaynağıyla tanımlanır.

Reklamveren (reklam sunma) hesabı

Reklamveren hesabı (veya reklam sunma hesabı), reklam kampanyaları yayınlayan bireysel bir Google Ads hesabıdır.

• Amaç: Kampanyalar, reklam grupları, öğe grupları ve reklamlar burada oluşturulur ve yayınlanır.
• API temsili: customer.manager değerinin false olduğu bir Customer kaynağıyla tanımlanır.

Müşteri hesabı

Müşteri hesabı, hiyerarşideki üst yönetici hesabına bağlı olan ve bu hesap tarafından yönetilen tüm hesaplardır (reklamveren hesabı veya başka bir yönetici hesabı).

• Bağlam: "Müşteri" terimi, hiyerarşideki ilişkiyi (bir yönetici tarafından yönetilen) ifade eder, ticari anlamda bir "müşteri" olması gerekmez.
• API gösterimi: Bir yöneticinin hiyerarşisindeki hesapları incelemek için CustomerClient sorgusunu kullanın ve yönetici ile müşteri hesapları arasındaki bağlantıları yönetmek için CustomerClientLink kullanın.

Müşteri

API bağlamında Müşteri, yönetici hesabı veya reklamveren hesabı fark etmeksizin herhangi bir Google Ads hesabını temsil eden kaynaktır.

• Temsil: Tüm hesaplar, customer_id ile tanımlanan bir Customer kaynağıyla temsil edilir.
• Rol: Hesabın niteliği (yönetici veya yayınlayan), belirli kaynağa bağlıdır.

Test hesabı

Test hesapları, özellikle API entegrasyonlarını test etmek için özel bir test yönetici hesabı altında düzenlenen özel reklamveren hesaplarıdır. Hem test yönetici hesabının hem de altındaki test reklamveren hesaplarının customer.test_account alanı true olarak ayarlanır. Test hesapları, üretim yönetici hesabı altında oluşturulamaz.

• Amaç: Test hesapları, canlı reklam yayınlamadan veya maliyet oluşturmadan API çağrılarını test etmenize olanak tanır. Canlı reklam yayınlamazlar.
• API gösterimi: Customer kaynağıyla tanımlanır. Burada customer.test_account, true değerine sahiptir (customer.manager, test yönetici hesabını test reklamveren hesabından ayırır).

Hiyerarşi örneği

Tipik bir hiyerarşi şu şekildedir:

• Yönetici Hesabı A (Üst düzey)
  • Müşteri Hesabı B (Reklamveren hesabı)
  • Müşteri Hesabı C (Başka bir yönetici hesabı)
    • Müşteri Hesabı D (Reklamveren hesabı)

Bu örnekte:

• A hesabı bir yönetici hesabıdır.
• B, C ve D hesapları, üst hesaplarına göre müşteri hesaplarıdır.
• B ve D hesapları reklamveren (reklam sunma) hesaplarıdır.
• C hesabı hem bir müşteri hesabı (A için) hem de bir yönetici hesabıdır (D için).