شروع کنید

این سند برای توسعه دهندگانی است که می خواهند از API مدیریت AdSense برای دریافت اطلاعات مربوط به حساب AdSense خود استفاده کنند. این سند فرض می کند که شما با مفاهیم برنامه نویسی وب و فرمت های داده های وب آشنا هستید.

قبل از اینکه تو شروع کنی

یک حساب AdSense دریافت کنید

برای شروع، ثبت نام کنید یا به حساب AdSense خود وارد شوید.

با AdSense آشنا شوید

اگر با مفاهیم AdSense آشنایی ندارید، اطلاعات مقدماتی AdSense را بخوانید و قبل از شروع به کدنویسی با AdSense UI آزمایش کنید.

کتابخانه مشتری خود را انتخاب کنید

در صفحه «کتابخانه‌ها و نمونه‌های مشتری» ، اطلاعاتی درباره کتابخانه‌ها و نمونه‌های موجود پیدا خواهید کرد. روی زبانه زبان انتخابی خود کلیک کنید و برای دانلود منبع پیوندها را دنبال کنید. کتابخانه های مشتری موارد زیر را برای شما انجام می دهند:

  • احراز هویت
  • کشف خدمات
  • ساخت درخواست ها به API
  • تجزیه پاسخ

دستورالعمل‌های نصب و پیکربندی کتابخانه مشتری انتخابی خود را که معمولاً در فایل README در فهرست اصلی مخزن یافت می‌شود، بخوانید.

اگر پیاده‌سازی شما نیازهای ویژه‌ای دارد، مانند استفاده از زبان پشتیبانی‌نشده، می‌توانید به‌جای استفاده از کتابخانه مشتری ، درخواست‌های مستقیم به API بدهید .

درخواست خود را ثبت کنید

برای استفاده از AdSense Management API، باید اپلیکیشنی را که در حال توسعه آن هستید، با ایجاد یک پروژه و ایجاد یک Client ID ثبت کنید.

اپلیکیشن خود را ثبت کنید

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

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

آموزش شروع سریع

مراحل زیر را برای اولین درخواست‌های خود دنبال کنید، توجه داشته باشید که این مراحل ممکن است بسته به کتابخانه یا زبانی که استفاده می‌کنید کمی متفاوت باشد:

  1. از نمونه مناسب برای بازیابی لیستی از مشتریان آگهی از حساب AdSense استفاده کنید. این درخواست فرآیندی یکباره را آغاز می کند که در آن کاربر AdSense پروژه شما را احراز هویت و مجوز می دهد.

    مشتریان تبلیغات نشان دهنده ارتباط بین یک حساب AdSense و یک محصول AdSense، مانند تبلیغات محتوا یا تبلیغات جستجو هستند. یک حساب AdSense می تواند یک یا چند مشتری تبلیغات داشته باشد.

    1. برای برنامه‌های کاربردی وب ، کاربران به سایتی هدایت می‌شوند که در آن می‌توانند اجازه دسترسی را انتخاب کنند. پس از مجوز، آنها به URL بازگشت به تماس تعریف شده در کنسول API ها هدایت می شوند.
    2. برنامه های نصب شده به طور مشابه کار می کنند. کتابخانه مشتری سعی می کند یک پنجره مرورگر را باز کند و از یک کد مجوز استفاده کند. برای برنامه های اندروید، کروم و iOS این روش مختص پلتفرم است.
  2. برای درخواست گزارش زیر از کاوشگر API برای reports.generate استفاده کنید:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    گزارش ها به شما بینشی در مورد آنچه که در حال کسب درآمد هستید، و همچنین آنچه که بر این درآمدها تأثیر می گذارد، می دهد. آنها را می توان بر روی یک حساب کامل یا در زیر مجموعه ای از واحدهای تبلیغاتی با استفاده از کانال ها اجرا کرد.

  3. سعی کنید همان گزارش را از برنامه خود درخواست کنید.
  4. می توانید گزارش ها را بر اساس واحدهای تبلیغاتی فیلتر کنید. لیست واحدهای تبلیغاتی را با استفاده از adunits.list واکشی کنید. توجه داشته باشید که یک شناسه مشتری آگهی مورد نیاز است (آن را از مرحله 1 دریافت کنید). پس از انتخاب واحد تبلیغات، از شناسه آن در پارامتر فیلتر برای reports.generate استفاده کنید:

    واحدهای تبلیغاتی مکان‌هایی برای تبلیغات پیکربندی شده توسط کاربر هستند که برخی ویژگی‌ها را برای تبلیغات نمایش داده شده (مانند اندازه و شکل) تعریف می‌کنند.

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. فیلتر کردن توسط کانال های سفارشی یا URL یا مخلوط کردن چندین فیلتر را امتحان کنید.

    کانال ها ابزارهایی هستند که به شما امکان می دهند عملکرد زیر مجموعه ای از واحدهای تبلیغاتی خود را ردیابی کنید. دو نوع کانال وجود دارد: URL و سفارشی. اولی به شما امکان می‌دهد عملکرد را در یک صفحه یا دامنه خاص ردیابی کنید، در حالی که دومی به شما کمک می‌کند عملکرد را در گروه‌های خاصی از واحدهای تبلیغاتی انتخاب شده توسط کاربر ردیابی کنید.

شما آماده هستید تا با کاوش بقیه تماس ها و منابع موجود در مستندات مرجع ، اجرای خود را شروع کنید.