اشخاص ثالث کاربران مستقیم Ad Manager نیستند، زیرا ممکن است شبکه Ad Manager خود را نداشته باشند. در عوض، آنها خدمات یا ادغام هایی را با Ad Manager برای مشتریان خود که مشتریان Ad Manager هستند ایجاد می کنند. این راهنما با ارائه بهترین شیوه ها، نکات و ترفندها، اصول ادغام شخص ثالث را پوشش می دهد.
این راهنما فرض می‌کند که شما از API مدیر Ad Manager آگاهی دارید. اگر با 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 خود اضافه کند.
برای مرحله 1، می توانید یک حساب Google جداگانه برای هر مشتری ایجاد کنید یا یک حساب اصلی که برای همه مشتریان استفاده خواهید کرد. در صورتی که یکی از حساب‌های شما به خطر بیفتد، گزینه اول امن‌تر است. مورد دوم به این معنی است که شما فقط باید یک بار مرحله 1 را انجام دهید.
مهم نیست که برای مرحله 1 چه کاری انجام می دهید، در مرحله 2 باید از هر مشتری جدید بخواهید حساب Google مناسبی را که برای آنها به عنوان کاربر ایجاد کرده اید به شبکه Ad Manager خود اضافه کند.
1. ایجاد یک حساب کاربری گوگل
راه های مختلفی برای ایجاد یک حساب Google وجود دارد که می تواند به شبکه Ad Manager اضافه شود.
گزینه 1: یک حساب سرویس OAuth2 ایجاد کنید، که یک آدرس ایمیل حساب سرویس برای شما ایجاد می کند که به عنوان یک حساب Google عمل می کند. دستورالعمل ایجاد یک حساب سرویس جدید .
گزینه 2: می توانید با ثبت نام به عنوان یک کاربر جدید، یک حساب Google معمولی (حساب "Gmail") ایجاد کنید. اگر قبلاً یک حساب Google دارید، این ثبت نام را در یک پنجره ناشناس یا جلسه مرورگر جدید تکمیل کنید. یا اگر شرکت شما از Google Workspace استفاده می‌کند، می‌توانید یک حساب Google در دامنه شرکت خود ایجاد کنید و به جای آن از آن استفاده کنید. برای اهداف این راهنما، ما به هر دوی آنها به عنوان یک حساب Google "معمولی" اشاره خواهیم کرد.
2. از مشتری بخواهید حساب Google شما را به شبکه خود اضافه کند
پس از اینکه یک حساب Google برای دسترسی به شبکه مشتری خود به دست آوردید، از آنها بخواهید حساب را به عنوان یک کاربر جدید در شبکه Ad Manager خود اضافه کنند.
اگر آدرس ایمیل حساب سرویس OAuth2 را به آنها ارائه می دهید، از آنها بخواهید آن را به شبکه خود اضافه کنند .
اگر یک حساب Google معمولی به آنها ارائه می کنید، از آنها بخواهید حساب شما را به عنوان کاربر به شبکه خود اضافه کنند .
مهم نیست که کدام مسیر را انتخاب می کنید، مطمئن شوید که با مشتری خود درباره نقش ها و مجوزهایی که حساب شما باید داشته باشد صحبت می کنید تا برنامه شما بتواند به داده های مورد نیاز خود در شبکه مشتری دسترسی داشته باشد.
اکنون می توانید تماس های API را با شبکه Ad Manager مشتری خود شروع کنید. اطمینان حاصل کنید که هدر networkCode SOAP را روی کد شبکه مشتری که با آن تماس API برقرار می کنید، تنظیم کرده اید. همه کتابخانه های مشتری ما این امکان را به صورت برنامه ریزی می کنند. به عنوان مثال، در کتابخانه سرویس گیرنده تبلیغات جاوا، می توانید کد شبکه را هنگام ساختن یک نمونه DfpSession به صورت برنامه نویسی تنظیم کنید .
به روز نگه داشتن API
مهم است که در مورد نسخه‌های API منسوخ یا غروب آفتاب و زمان انتشار نسخه‌های جدید به‌روز باشید. شما نمی خواهید زمانی که یک نسخه غروب می کند غافلگیر شوید و در خطر شکستن مشتریان خود باشید. ما همیشه نمی‌توانیم همانطور که برای مشتریانمان انجام می‌دهیم، در مورد فسخ و غروب‌های قریب‌الوقوع با اشخاص ثالث ارتباط برقرار کنیم. بنابراین، این مسئولیت شماست که در یکی از سه کانال اصلی ما برای به‌روزرسانی‌های API مشترک شوید و تنظیمات اعلان خود را تنظیم کنید:
ما همچنین در سایت توسعه‌دهنده خود یک برنامه زمان‌بندی استهلاک ارائه می‌کنیم که باید مرتباً آن را کنترل کنید.
دریافت پشتیبانی
اگر در ادغام Ad Manager خود با مشکل مواجه شدید، بسته به مشکل شما کانال های پشتیبانی زیر را ارائه می دهیم. اگر سؤالی در سطح محصول دارید، لطفاً به انجمن های محصول Ad Manager بنویسید. اگر سؤال خاصی برای API دارید، لطفاً به انجمن های API Ad Manager بنویسید. لطفاً این پست وبلاگ را برای نکاتی در مورد تشخیص اینکه آیا چیزی یک سؤال در سطح محصول است یا یک سؤال خاص API، ببینید.