اشخاص ثالث کاربران مستقیم Ad Manager نیستند، به این معنی که ممکن است شبکه Ad Manager خودشان را نداشته باشند. درعوض، آنها خدمات یا ادغامهایی با «مدیر آگهی» برای کارخواهانشان که مشتریان «مدیر آگهی» هستند ایجاد میکنند. این راهنما اصول اولیه ادغامهای طرف سوم را با ارائه روالهای مطلوب، نکات، و ترفندها پوشش میدهد.
این راهنما فرض میکند که شما دانش کاری از Ad Manager API دارید. اگر با Ad Manager API آشنا نیستید، اسناد شروع به کار ما را ببینید.
شروع کار بهعنوان شخص ثالث
برای استفاده از Ad Manager API جهت دسترسی به شبکه مشتری Ad Manager، کافی است رهنمودهای زیر را دنبال کنید. تأیید دیگری ازسوی Google لازم نیست، اما توجه داشته باشید که با دسترسی به Ad Manager API و/یا استفاده از آن، با شرایط خدمات Ad Manager API موافقت میکنید.
نحوه آزمایش کردن ادغام Ad Manager بهعنوان طرف سوم
بهعنوان شخص ثالث، ممکن است بخواهید بدانید چگونه ادغام Ad Manager خود را قبلاز اجرا در شبکههای تولید مشتریانتان آزمایش کنید. رویکرد توصیهشده ایجاد شبکه آزمایشی است. برای انجام این کار لازم نیست مشتری Ad Manager باشید. هرکسی که «حساب Google» داشته باشد میتواند شبکه آزمایشی ایجاد کند.
بااینحال، به تفاوتهای بین شبکههای آزمایشی و تولیدی توجه کنید. شبکههای آزمایشی نمیتوانند آگهی ارائه دهند. شبکههای آزمایشی همچنین لزوماً شامل همه ویژگیهایی که ممکن است مشتریانتان در شبکههای تولیدی خود داشته باشند نیستند. اگر لازم است ویژگیهای Ad Manager را که در شبکه آزمایشیتان دردسترس نیست آزمایش کنید، یک گزینه این است که ازطریق فروشنده Ad Manager، دسترسی به شبکه غیرآزمایشی را خریداری کنید.
علاوهبراین، باید برای مشتریانتان روشن کنید که برای اینکه برنامهتان بهدرستی کار کند، چه ویژگیهایی باید در شبکه تولید آنها دردسترس باشد. برنامه شما باید مواردی را که ممکن است ویژگیها وجود نداشته باشند با گرفتن استثناها و ازکار افتادن بهصورت مناسب یا نگهداری فهرستی از کارخواههایتان و اینکه هرکدام چه ویژگیهایی دارند یا ندارند، مدیریت کند. مشتری شما باید مسئولیت همکاری با مخاطب خود در Google را برای مدیریت ویژگیها در شبکهاش برعهده بگیرد.
اصالتسنجی: نحوه دسترسی صحیح به شبکه Ad Manager مشتری
برای اینکه برنامهتان بتواند به شبکه Ad Manager مشتریتان دسترسی پیدا کند، باید گردش کار اصالتسنجیتان را بهصورت ایمن راهاندازی کنید.
این کار شامل دو مرحله است:
- نشانی ایمیل «حساب Google» ایجاد کنید که از آن برای دسترسی به شبکه مشتریتان استفاده خواهید کرد.
- از مشتری بخواهید این حساب را بهعنوان کاربر به شبکه Ad Manager خود اضافه کند.
برای مرحله ۱، میتوانید برای هر مشتری یک «حساب Google» جداگانه ایجاد کنید، یا یک حساب اصلی که برای همه مشتریان استفاده خواهید کرد. گزینه اول درصورتیکه یکی از حسابهایتان لو برود، ایمنتر است. مورد دوم یعنی فقط یکبار باید مرحله ۱ را انجام دهید.
مهم نیست در مرحله ۱ چه کاری انجام میدهید، در مرحله ۲ باید از هر مشتری جدید بخواهید «حساب Google» مناسبی را که برای او ایجاد کردهاید بهعنوان کاربر به شبکه Ad Manager خود اضافه کند.
۱. ایجاد کردن «حساب Google»
روشهای مختلفی برای ایجاد «حساب Google» وجود دارد که میتوان آن را به شبکه Ad Manager اضافه کرد.
گزینه ۱: حساب سرویس OAuth2 ایجاد کنید که نشانی ایمیل حساب سرویسی برای شما تولید میکند که بهعنوان «حساب Google» عمل میکند. دستورالعملهای ایجاد حساب سرویس جدید.
گزینه ۲: میتوانید با ثبتنام بهعنوان کاربر جدید، «حساب Google» معمولی (حساب Gmail) ایجاد کنید. اگر ازقبل «حساب Google» دارید، این ثبتنام را در پنجره ناشناس یا جلسه مرورگر جدیدی تکمیل کنید. یا اگر شرکتتان از Google Workspace استفاده میکند، میتوانید «حساب Google» در دامنه شرکتتان ایجاد کنید و بهجای آن از آن استفاده کنید. برای اهداف این راهنما، به هر دو این حسابها بهعنوان «حساب Google» معمولی اشاره میکنیم.
۲. از مشتری بخواهید «حساب Google» شما را به شبکهاش اضافه کند
پساز اینکه «حساب Google» را برای دسترسی به شبکه مشتریتان دریافت کردید، از او بخواهید حساب را بهعنوان کاربر جدید در شبکه Ad Manager خود اضافه کند.
اگر نشانی ایمیل حساب سرویس OAuth2 را به آنها ارائه میدهید، از آنها بخواهید آن را به شبکهشان اضافه کنند.
اگر «حساب Google» معمولی به آنها ارائه میدهید، از آنها بخواهید حساب شما را بهعنوان کاربر به شبکهشان اضافه کنند.
مهم نیست کدام مسیر را انتخاب میکنید، حتماً با کارخواهتان درباره اینکه حسابتان باید چه نقشها و اجازههایی داشته باشد صحبت کنید تا برنامهتان بتواند به دادههای موردنیازش در شبکه کارخواهتان دسترسی پیدا کند.
اکنون میتوانید تماسهای API را با شبکه Ad Manager مشتریتان شروع کنید. مطمئن شوید که سرصفحه SOAP کد شبکه را روی کد شبکه مشتریای تنظیم کنید که فراخوانی API را برای او انجام میدهید. همه کتابخانههای مشتری ما امکان تنظیم این مورد را بهصورت برنامهنویسی فراهم میکنند. برای مثال، در کتابخانه کارخواه Java آگهیها، میتوانید هنگام ساختن نمونه DfpSession، کد شبکه را بهصورت برنامهنویسیشده تنظیم کنید.
بهروز ماندن با API
مهم است که از نسخههای API منسوخشده یا ازکارافتاده و زمان انتشار نسخههای جدید مطلع باشید. نمیخواهید وقتی نسخهای منسوخ میشود غافلگیر شوید و کارخواهانتان را درمعرض خطر خرابی قرار دهید. ما همیشه نمیتوانیم درباره منسوخ شدن و توقفهای قریبالوقوع با اشخاص ثالث تماس بگیریم، همانطور که برای مشتریان خود انجام میدهیم. بنابراین، مسئولیت مشترک شدن در یکی از سه کانال اصلی ما برای بهروزرسانیهای API و تنظیم تنظیمات اعلان بر عهده شماست:
همچنین زمانبندی منسوخ شدن را در سایت توسعهدهنده خود ارائه میدهیم که باید بهطور منظم آن را نظارت کنید.