Yandex direct api یک تبلیغ را به یک کاربر نشان می دهد. انواع وابسته به مثال تعامل با Yandex.Direct API. اثر این توافق

این توافقنامه بر روابط بین شما (از این پس شما یا کاربر نامیده می شود) و YANDEX LLC (از این پس Yandex نامیده می شود) در رابطه با استفاده از API (از این پس API نامیده می شود) سرویس Yandex.Direct (از این پس به آن اشاره می شود) حاکم است. به عنوان سرویس).

Yandex به شما این امکان را می دهد که از API Service برای مدیریت کمپین های تبلیغاتی با استفاده از برنامه هایی که با سرویس تعامل دارند و همچنین از API به روش های دیگری که با این توافق نامه مغایرت ندارد استفاده کنید. استفاده از API در سرویس تحت کنترل این قرارداد، پیشنهاد سرویس واقع در و قرارداد کاربر Yandex است که در دسترس است.

با استفاده از API، بدینوسیله با تمام شرایط این توافقنامه و اسناد فوق موافقت می کنید و متعهد می شوید که از آنها پیروی کنید یا استفاده از API را متوقف کنید.

برای اهداف این موافقتنامه، از اصطلاحات زیر استفاده می شود:

Yandex.Direct Service API، API- یک رابط برنامه نویسی برای تعامل برنامه ها (همانطور که این اصطلاح در زیر تعریف شده است) با سرویس Yandex.Direct.

کلید API (توکن OAuth)- یک شناسه منحصر به فرد صادر شده برای کاربر که اجازه دسترسی به عملکردهای سرویس را می دهد.

شرایط استفاده از API:

1. ایمنی شما

شما مسئول امنیت کلید API خود هستید و همچنین مسئولیت تمام کارهایی که با استفاده از برنامه و کلید API استفاده می کنید در سرویس انجام می شود. تمام اقدامات انجام شده در سرویس با استفاده از کلید API شما انجام شده توسط شما در نظر گرفته می شود. شما موافقت می کنید که باید فوراً Yandex را از هرگونه دسترسی غیرمجاز (غیر مجاز) به کلید API خود و/یا هرگونه نقض امنیت مطلع کنید. Yandex مسئولیتی در قبال از دست دادن یا تغییر داده هایی که ممکن است به دلیل نقض مفاد این بخش از UA رخ دهد، ندارد. Yandex شما را تشویق می کند تا از همه اقدامات برای اطمینان از امنیت API استفاده کنید، از جمله اقداماتی برای حفظ محرمانه بودن کلید API.

2. دسترسی خودکار.

شما موافقت می کنید که، به استثنای برنامه های کاربردی برای تعامل با API، از استفاده از سایر ابزارهای دسترسی خودکار (روبات ها و غیره) به سرویس منع شده اید.

3. نظارت.

شما می‌دانید و موافقت می‌کنید که Yandex تمام فعالیت‌ها را با استفاده از API نظارت می‌کند و ممکن است آمار اقدامات کاربر انجام شده با استفاده از API را جمع‌آوری و تجزیه و تحلیل کند.

4. دسترسی تضمین شده.

شما موافقت می کنید که شرایط سرویس (از جمله API) ممکن است توسط Yandex در هر زمان بدون اطلاع قبلی به کاربران تغییر کند. بنابراین، Yandex ادامه در دسترس بودن سرویس (از جمله API) یا هر یک از اجزای آن را تضمین نمی کند. خدمات (از جمله API) "همانطور که هست" ارائه می شود. Yandex مطابقت سرویس یا اجزای آن (از جمله API) با اهداف و انتظارات کاربر، عملکرد بدون وقفه و بدون خطا آن را تضمین نمی کند. Yandex هیچ مسئولیتی در قبال اقدامات انجام شده توسط شما یا سایر کاربران در سرویس با استفاده از API ندارد. Yandex هیچ گونه خسارت مستقیم یا غیرمستقیم را که به کاربر یا اشخاص ثالث در نتیجه استفاده یا ناتوانی در استفاده از سرویس یا اجزای جداگانه آن (از جمله API) وارد شده است، جبران نمی کند.

شما موافقت می کنید که Yandex ممکن است دسترسی به API را به حالت تعلیق درآورد یا به طور کامل ببندد، پروتکل ها و روش های دسترسی را بدون ذکر دلیل و بدون مسئولیت از جانب خود تغییر دهد. شما مسئول ایمنی همه داده های خود هستید و باید برای مدیریت کمپین ها از طریق رابط وب مشتری آماده باشید.

5. محدودیت ها.

شما موافقت می کنید که Yandex ممکن است به صلاحدید خود، بسته به بسیاری از شاخص ها، از جمله، از جمله، حجم خدمات ارائه شده به کاربر برنامه، شاخص های فنی، محدودیت هایی (سهمیه) برای استفاده از API یا اجزای جداگانه آن تعیین کند. از کمپین تبلیغاتی (میانگین CTR، آگهی‌های در دسترس رد شده در طول تعدیل و غیره).

قوانین اعمال چنین محدودیت‌هایی در «پرسش‌ها و پاسخ‌ها» ارسال شده در پیوند «API» در حساب شما توضیح داده شده است.

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

همچنین تمامی مسئولیت و خطر عواقب نامطلوب مرتبط با محدودیت و/یا ممنوعیت دسترسی برنامه‌ها به API به دلایلی که توسط قرارداد کاربر برای توسعه‌دهندگان تعیین شده است، بر عهده شماست.

6. اشخاص ثالث.

در صورتی که از API برای مدیریت کمپین های تبلیغاتی اشخاص ثالث بر اساس قرارداد یا قرارداد دیگری بین خود استفاده می کنید، باید بدانید که تمام داده های مربوط به حساب ها (حساب های) این مشتریان و سایر اطلاعات مربوط به کمپین های تبلیغاتی چنین مشتریانی که با استفاده از کلید API شما انجام می شوند محرمانه تلقی می شوند. شما نمی توانید خودتان از آنها استفاده کنید یا آنها را بدون رضایت کتبی صاحبان آنها به اشخاص ثالث منتقل کنید.

اگر دسترسی به API را برای هر شخص ثالثی فراهم کنید (از جمله با ایجاد یک حساب کاربری برای آنها مرتبط با حساب خود)، مسئولیت کامل تمام اقدامات این اشخاص ثالث مانند اقدامات خود را بر عهده دارید.

7. اعتبار این قرارداد.

Yandex این حق را برای خود محفوظ می دارد که در صورت عدم رعایت شرایط آن، این توافقنامه را با توجه به شما تعلیق کند. در صورت تعلیق، باید استفاده بیشتر از API را متوقف کنید.

8. مقررات نهایی.

این توافقنامه و کلیه روابط مربوط به استفاده از سرویس و API توسط قوانین فدراسیون روسیه کنترل می شود.

تمام ادعاهای مربوط به استفاده/ناتوانی در استفاده از API در سرویس باید به آن هدایت شود [ایمیل محافظت شده].

Yandex ممکن است متن این توافقنامه و/یا سایر شرایط استفاده از سرویس را در هر زمانی بدون اطلاع کاربر تغییر دهد. متن فعلی این توافقنامه در آدرس زیر قرار دارد.

_____________________________

تاریخ انتشار 1398/04/05

نسخه قبلی سند: .

در این دوره به بررسی خواهیم پرداخت خدمات مدیریت مناقصه در Yandex.Direct کارگزار آر- http://r-broker.ru/.

خدمات مشابه زیادی وجود دارد. R-broker یکی از رهبران بازار است.

در صورت ایجاد کمپین در حساب آنها می توانید از این سرویس به صورت رایگان استفاده کنید. فقط با آنها تماس بگیرید و آنها یک حساب تمیز جدید برای شما ایجاد می کنند (این یک حساب فرعی از حساب عامل اصلی آنها خواهد بود).

اگر می خواهید سرویس را به حساب خود متصل کنید، یک شبکه تعرفه وجود دارد. قیمت استفاده از ویژگی های سرویس به تعداد عبارات و تنظیمات بستگی دارد.

R-broker چگونه کار می کند؟

R-broker از طریق Direct API کار می کند: http://direct.yandex.ru/help/?id=1113180

به کمپین متصل می شود و به فیلدهای مناقصه دسترسی دارد.

این سرویس روزانه تا 96 اصلاح خودکار (هر 15 دقیقه) انجام می دهد.

با کمک دایرکت، نرخ های جدید از 5 تا 60 دقیقه فعال می شوند. اما میانگین زمان پردازش این عمل 10 دقیقه است!

معنی R-broker

1. محافظت در برابر نشست

P-broker در برابر آب پشت سر / پساب محافظت می کند (شما می توانید آن را متفاوت نامید).

بیایید یک مثال بزنیم.

1 ویژه = 5 دلار
2 عدد ویژه = 2 دلار
ورودی ویژه = 0.5 دلار

شما در جایگاه اول ظاهر می شوید.

مبلغ شارژ شده شما به ازای هر کلیک 2.01 دلار است.

رقیب در جایگاه دوم شما را برمی دارد و به شما کمک می کند و به شما پیشنهاد 4.99 دلار می دهد.

همه. اکنون یک کلیک برای شما 5 دلار هزینه دارد، نه 2.01 دلار.

وقتی صدها عبارت در کمپین خود داشته باشید، هرگز نمی توانید وقوع چنین موقعیت هایی را خودتان کنترل کنید..

اکنون برخی از روبات ها عملکرد مشابهی دارند.

یک مثال www.magazion.ru است.

بر اساس استراتژی انتخاب شده، "Magazion" با تعیین نرخ های بالاتر، به نرخ های رقبا حمله می کند. ارزش حق بیمه حمله به تنظیمات تهاجمی بستگی دارد (می توان آن را هم برای کل کمپین تبلیغاتی و هم برای عبارات فردی تنظیم کرد).

خوب، همه ربات های مدرن کافی دارای عملکرد محافظتی هستند.

موقعیت های مشابه در موضوعات بسیار رقابتی همیشه به وجود می آید.

به عنوان مثال - پنجره های پلاستیکی، توسعه وب سایت و غیره.

بدون خودکارسازی پیشنهادها از طریق RK API در این موضوعات، نمی‌تواند واقعاً موفق باشد.

2. پیشنهادات را مدیریت کنید

R-broker یک ربات است. او بر اجرای صحیح استراتژی انتخاب شده نظارت دارد.

R-broker گاهی اوقات به سادگی غیر قابل تعویض است.

ویژگی اصلی حفظ موقعیت های بدون سقوط است.

قیمت ها در طول روز بالا و پایین می شوند.

اگر می خواهید در ورودی متخصص باشید، می توانیم به صورت دستی نرخ ها را در رابط Yandex.Direct برای ورود به بلوک تنظیم کنیم.

هر نوسان 1 سنت و ما از آنجا خارج خواهیم شد.

در ابتدا، ما بیشتر (در محدوده خود) قرار می دهیم - غلاف ها امکان پذیر است.

ما می توانیم تمام روز را بنشینیم و نرخ ها را خودمان تنظیم کنیم، اما به زودی خود را در یک بیمارستان روانی خواهیم یافت.

R-broker خودش می تواند نرخ ها را چندین بار در ساعت تنظیم کند.

در حالی که رقبا چندین بار در روز از طریق API نرخ ها را به طور خودکار تغییر می دهند، این افراد یک بار در روز صبح آنها را به صورت دستی تغییر می دهند. رقابت مطلقاً برابر نیست.

تفاوت های ظریف

اتصال R-broker به استراتژی های خودکار Yandex.Direct غیرممکن است، زیرا زمینه های مناقصه در دسترس نیست.

P-broker برای استفاده برای بالاترین موقعیت موجود (به سادگی نرخ مکان مورد نظر را تعیین می کند) و ورودی های بلوک ها با دقیقه ایده آل است. قیمت

Autobroker Direct همیشه نرخ را به پایین ترین حد ممکن در حال حاضر و همین جا کاهش می دهد.

کارگزار خودکار و استراتژی در Yandex.Direct در تعیین موقعیت در جستجو اهمیت تعیین کننده ای دارند.

این بد است - R-broker گاهی اوقات برای بارگیری زمان زیادی طول می کشد.

راه اندازی یک بروکر R

R-broker ممکن است در نگاه اول پیچیده به نظر برسد. اما، من به شما اطمینان می دهم، هیچ چیز پیچیده ای در آن وجود ندارد.

اگر هنوز به طور کامل نحوه کار Direct را درک نکرده اید، پس تا زمانی که آن را متوجه نشده اید، بهتر است ادامه مطلب را مطالعه نکنید، در غیر این صورت درک آن بسیار دشوار خواهد بود. بهتر است مطالب گذشته را مرور کنید.

دستورالعمل های R-broker باید خوانده شود!

R-broker موارد اضافی زیادی دارد. چیزی را خواهم نوشت که ارزش توجه دارد.

گزارش رویداد / آمار و تجزیه و تحلیل

من هرگز از طریق R-broker به آمار نگاه نمی کنم. مجله یا مفید است یا نه.

اینها بخش های متوسطی هستند. اکنون می توانید آنها را به کلی نادیده بگیرید.

گزینه های کنترل

از نوار لغزنده (در سمت چپ) برای روشن کردن کنترل و تنظیم برنامه برای تنظیمات پیشنهاد استفاده کنید. زمانی را که تبلیغ شما در آن اجرا می شود علامت بزنید.

کنترل کیفیت کمپین

بهتر است به چیزی دست نزنید.

بازآفرینی یک عبارت برای یک STR پایین عموما راهی به سمت گور است.

ما باید مشکل را درمان کنیم، نه بازسازی آن. یاندکس همه چیز را به خاطر می آورد.

اتصال خودکار عبارات جدید برای کنترل

اگر تنها یک تاکتیک برای کل جمهوری قزاقستان وجود داشته باشد، ممکن است. و اگر نه، پس باید هر عبارت را خودتان وارد کنید.

تنظیمات تاکتیک های AC

R-max حداکثر قیمتی است که ما حاضریم برای هر کلیک بپردازیم. نه آن چیزی که در رابط Yandex.Direct خواهد بود. این اطلاعات برای R-broker است.

پارامترهای رایج

روی مورد دوم علامت بزنید: «پیشنهاد را همیشه کمتر از حداقل برای نمایش در جستجو تنظیم کنید».

من معمولا اولی را غیرفعال می کنم.

با گنجاندن نقطه 3، ما محدودیت r-max نخواهیم داشت و قیمت پیشنهادی را می توان حتی 50 دلار تعیین کرد - نکته اصلی این است که بودجه اجازه می دهد. بهتر است آن را از گناه روشن نکنیم.

به هر حال، 50 دلار حداکثر نرخ مجاز در Yandex.Direct است. وحشت. من نمی دانم چه کسی حاضر است برای 1 کلیک این همه هزینه بپردازد. شما آماده ای؟

گزینه ها را برای همه عبارات یک کمپین تغییر دهید

در اینجا می توانید تاکتیک های کلی را تنظیم کنید.

درباره استراتژی ها در دستورالعمل ها بیشتر بخوانید..

تاکتیک های اساسی:

1>2>3 (ما یک مکان خاص را اشغال می کنیم، به نزدیکترین پایین سقوط می کنیم)

1>Y>D(در بلوک جایی می گیریم، به بلوک بعدی می افتیم)

بقیه واقعاً مورد نیاز نیستند. این تاکتیک ها را تا حدی تکرار می کنند.

مثال

بیایید تصور کنیم که تاکتیک هایی در رابط Yandex.Direct داریم - بلوک ورودی با دقیقه. قیمت (ویژه + گارانتی).

R-broker را برای 1>G>D CP (جایگاه ویژه) با مقداری R-max تنظیم کنید.

در نتیجه، هر چیزی که می تواند، در ویژه (در ورودی)، اگر تصادف کند، در ورودی گارانتی نشان داده می شود.

هر چیزی که در گارانتی است، در اسرع وقت - به ویژه می شکند.

اقتصادی، عصبانی.

به یاد داشته باشید: یک RK خوب تنظیم شده در جستجو بسیار آسان است، بنابراین تاکتیک ها و راه اندازی مناسب بسیار مهم هستند.

سلام.

محبوبیت انواع وابسته برای برنامه نویسی توسط کتابخانه Servant بسیار تسهیل می شود، که هم برای ارائه یک API تایپ شده (سرور-سرور) و هم برای نوشتن درخواست ها به یک موجود (servant-client) استفاده می شود. ما از این کتابخانه استفاده خواهیم کرد (توضیح نحوه عملکرد آن خارج از حوصله این پست است، کسانی که مایلند می توانند گزارش را مطالعه کنند). با این حال، موضوع به انواع وابسته تعبیه شده در Servant محدود نمی شود و ما موارد دیگری را نیز اضافه خواهیم کرد.

طرح

ما چندین موجودیت اصلی API Yandex.Direct را شرح خواهیم داد: روش (افزودن، دریافت)، عملیات، نتیجه عملیات، شی (نام فرهنگ لغت، تبلیغات، کمپین) و یک تابع تایپ شده وابسته تعریف می کنیم که به شما امکان می دهد هر روشی را که با پارامتر تعیین شده است فراخوانی کنید. مقداری شی و پاسخی را می پذیرند که نوع آن به روش فراخوانی شده و نوع شی بستگی دارد.

عملیات

اشیاء

Yandex.Direct API بسیار گسترده است: می توان از آن برای پردازش تبلیغات، گروه های تبلیغاتی، کمپین ها، برنامه های افزودنی، کلمات کلیدی و موارد دیگر استفاده کرد. ما یک تابع عمومی خواهیم نوشت که به ما امکان می دهد هر یک از این اشیاء را به متد فراخوانی شده منتقل کنیم.

ابتدا چند مثال. تبلیغات:

کمپین ها:

آدرس پردازش درخواست‌های مرتبط با تبلیغات «https://api.direct.yandex.com/json/v5/ads» و آدرس پردازش درخواست‌های مربوط به کمپین‌ها «https://api. direct.yandex» است. com/json/v5/campaigns. تمام اشیاء دیگر نیز آدرس های خود را برای پردازش درخواست ها دارند. پس بیایید یک کلاس تایپ بگیریم

به این معنا که هر شی باید به صورت سریالی برای JSON باشد تا بتواند از طریق شبکه منتقل شود و نامی داشته باشد که بخشی از آدرس درخواست ها را تشکیل می دهد.

API

بیایید Yandex.Direct API را با استفاده از ابزارهای ارائه شده توسط Servant توصیف کنیم:

a نوع پارامتر متد فراخوانی شده، r نوع نتیجه برگشتی است. عملیات به طور خودکار به JSON سریال می شود، نتیجه به طور خودکار از JSON خارج می شود.

ما همچنین به یک پیکربندی خاص Direct نیاز داریم:

و در نهایت می توانیم همه چیز را کنار هم بگذاریم و تابع اصلی برای برقراری ارتباط با Yandex.Direct API را تعریف کنیم:

(در نسخه‌های جدید، Servant Manager بخشی از ClientM است، اما در زمان نگارش، آخرین عکس فوری LTS در Stackage از نسخه قدیمی استفاده می‌کند.) perform یک پیکربندی خاص Direct، یک مدیر اتصال، یک متد برای فراخوانی به شکل singleton و یک شی که باید به متد ارسال شود، نیاز دارد. از امضای perform می توان دریافت که نوع مقدار بازگشتی (ResultOf m a) واقعاً به متدی که (m در SMethod m) نامیده می شود و به نوع پارامتر (a) که به آن ارسال می شود بستگی دارد. در غیر این صورت، ما فقط از عملکرد اولیه ارائه شده توسط Servant استفاده می کنیم.

نتیجه

با کمک یک Servant وابسته به تایپ، می‌توانید API را به‌طور شفاف توصیف کنید و از نیاز به سریال‌سازی-دستی‌سازی داده‌ها خلاص شوید. با این حال، انواع داده‌هایی که در پاسخ به یک درخواست می‌آیند ممکن است به محتوای درخواست بستگی داشته باشد، اما انواع وابسته به ما اجازه می‌دهند تا همه متغیرهای لازم را در اینجا نیز بیان کنیم.