انواع حساب در Google Ads API

این سند اصطلاحات مختلفی را که برای توصیف حساب‌ها در Google Ads API استفاده می‌شود و نحوه ارتباط آن‌ها با یکدیگر را توضیح می‌دهد.

نمای کلی

Google Ads API از چندین اصطلاح برای توصیف حساب‌ها استفاده می‌کند که گاهی‌اوقات می‌تواند باعث سردرگمی شود. درک این تفاوت‌ها برای مدیریت حساب‌ها و تفسیر پاسخ‌های میانای برنامه‌سازی کاربردی مهم است.

انواع حساب

تعاریف زیر انواع مختلف حساب‌هایی را که هنگام کار با Google Ads API با آن‌ها مواجه خواهید شد، روشن می‌کند.

حساب مدیر

حساب مدیر حساب اصلی‌ای است که برای مدیریت چندین حساب Google Ads استفاده می‌شود.

• نام قبلی: این ویژگی قبلاً با نام «MCC» (مرکز مدیریت مشتریان) شناخته می‌شد. ممکن است همچنان این اصطلاح را در مستندات یا بحث‌های قدیمی ببینید.
• هدف: وقتی می‌خواهید چند حساب را ازطریق یک سلسله‌مراتب پیوند دهید و مدیریت کنید، از حساب مدیر استفاده کنید.
• نمایش میانای برنامه‌سازی کاربردی: با منبع Customer شناسایی می‌شود که در آن customer.manager برابر با true است.

حساب تبلیغ‌کننده (ارائه‌ای)

حساب آگهی‌دهنده (یا حساب ارائه‌دهنده) یک حساب Google Ads تکی است که کمپین‌های آگهی را اجرا می‌کند.

• هدف: اینجاست که پویش‌ها، گروه‌های آگهی، گروه‌های دارایی، و آگهی‌ها ایجاد و ارائه می‌شوند.
• نمایش میانای برنامه‌سازی کاربردی: با منبع Customer شناسایی می‌شود که در آن customer.manager برابر با false است.

حساب مشتری

حساب مشتری هر حسابی (حساب تبلیغ‌کننده یا حساب مدیر دیگر) است که به حساب مدیر برتر در سلسله‌مراتب پیوند داده شده است و توسط آن مدیریت می‌شود.

• بافت: اصطلاح «مشتری» به رابطه در سلسله‌مراتب اشاره دارد (که توسط مدیر مدیریت می‌شود)، نه لزوماً «مشتری» در مفهوم کسب‌وکار.
• نمایش میانای برنامه‌سازی کاربردی: برای بررسی حساب‌ها در سلسله‌مراتب مدیر، CustomerClient را پُرسمان کنید و برای مدیریت پیوندها بین حساب‌های مدیر و مشتری، از CustomerClientLink استفاده کنید.

مشتری

در زمینه API، مشتری منبعی است که نشان‌دهنده هر حساب Google Ads است، چه حساب مدیر باشد چه حساب تبلیغ‌کننده.

• نمایش: همه حساب‌ها با منبع Customer نمایش داده می‌شوند که با customer_id شناسایی می‌شود.
• نقش: ماهیت حساب (مدیر یا ارائه‌دهنده) به منبع خاص بستگی دارد.

حساب آزمایشی

حساب‌های آزمایشی حساب‌های تبلیغ‌کننده ویژه‌ای هستند که تحت یک حساب مدیر آزمایشی اختصاصی به‌طور خاص برای آزمایش کردن ادغام‌های میانای برنامه‌سازی کاربردی سازمان‌دهی شده‌اند. هم حساب مدیر آزمایشی و هم حساب‌های تبلیغ‌کننده آزمایشی تحت آن فیلد customer.test_account را روی true تنظیم کرده‌اند. حساب‌های آزمایشی را نمی‌توان تحت حساب مدیر تولید ایجاد کرد.

• هدف: حساب‌های آزمایشی به شما امکان می‌دهند فراخوانی‌های میانای برنامه‌سازی کاربردی را بدون ارائه آگهی‌های زنده یا متحمل شدن هزینه آزمایش کنید. آن‌ها آگهی‌های زنده ارائه نمی‌دهند.
• نمایش API: با منبع Customer شناسایی می‌شود که در آن customer.test_account برابر با true است (با customer.manager که حساب مدیر آزمایش را از حساب تبلیغ‌کننده آزمایش متمایز می‌کند).

نمونه سلسله‌مراتب

سلسله مراتب معمول به این شکل است:

• حساب مدیر الف (سطح بالا)
  • حساب مشتری B (حساب تبلیغ‌کننده)
  • حساب مشتری ج (حساب مدیر دیگر)
    • حساب مشتری D (حساب تبلیغ‌کننده)

در این مثال:

• حساب الف یک حساب مدیر است.
• حساب‌های B،‏ C، و D حساب‌های مشتری نسبت به حساب‌های اصلی‌شان هستند.
• حساب‌های B و D حساب‌های آگهی‌دهنده (ارائه‌دهنده) هستند.
• حساب C هم حساب مشتری (برای A) و هم حساب مدیر (برای D) است.