שנתחיל?

המסמך הזה מיועד למפתחים שרוצים להשתמש ב-AdSense Management API כדי לקבל מידע על חשבון AdSense שלהם. ההנחה במאמר זה היא שאתם מכירים מושגים בתכנות אתרים ופורמטים של נתוני אתרים.

לפני שמתחילים

קבלת חשבון AdSense

כדי להתחיל, הירשמו או היכנסו אל חשבון AdSense.

היכרות עם AdSense

אם אתם לא מתמצאים במושגים של AdSense, קראו את מידע המבוא על AdSense והתחילו להתנסות בממשק המשתמש של AdSense לפני שתתחילו לתכנת.

בחירה של ספריית הלקוח

בדף ספריות לקוח ודוגמאות תוכלו למצוא מידע על הספריות והדוגמאות הזמינות. לוחצים על הכרטיסייה של השפה שנבחרה ולוחצים על הקישורים להורדת המקור. ספריות הלקוח מטפלות עבורכם בנושאים הבאים:

  • אימות
  • גילוי שירותים
  • ליצור את הבקשות ל-API
  • ניתוח תשובות

קוראים את ההוראות להתקנה ולהגדרה של ספריית הלקוח שבחרתם. בדרך כלל אפשר למצוא את ההוראות בקובץ ה-README שבספריית השורש של המאגר.

אם להטמעה יש צרכים מיוחדים, כמו שימוש בשפה שלא נתמכת, תוכלו לשלוח בקשות ישירות ל-API במקום להשתמש בספריית לקוח.

רישום הבקשה

כדי להשתמש ב-AdSense Management API, עליכם לרשום את האפליקציה שאתם מפתחים באמצעות יצירת פרויקט ויצירה של מזהה לקוח.

לרישום האפליקציה

עורכים את קובצי התצורה של פרויקט ספריית הלקוח עם פרטי הכניסה החדשים שיצרתם. לפרטים נוספים, עיינו במסמכי התיעוד של ספריית הלקוח.

הערה: חשבון Google שמשמש להרשמה צריך להיות חשבון המפתח שלכם. כלומר, החשבון שאתם רוצים שהמשתמשים באפליקציה יראו כמפתחי האפליקציה. אין צורך לקשר את החשבון הזה לפרטי התחברות ל-AdSense, כי המשתמשים יעניקו גישה לחשבונות שלהם תוך כדי השימוש באפליקציה.

מדריך למתחילים

עליכם לבצע את השלבים הבאים כדי לשלוח את הבקשות הראשונות. שימו לב שהשלבים האלה עשויים להשתנות מעט בהתאם לספרייה או לשפה שבה אתם משתמשים:

  1. משתמשים בדוגמה המתאימה כדי לאחזר רשימה של לקוחות מודעות מחשבון AdSense. הבקשה הזו מתחילה בתהליך חד-פעמי שבו משתמש AdSense מאמת ומאשר את הפרויקט שלך.

    לקוחות של מודעות מייצגים שיוך בין חשבון AdSense למוצר AdSense, כמו מודעות תוכן או מודעות לרשת החיפוש. חשבון AdSense יכול להיות עם לקוח פרסום אחד או יותר.

    1. באפליקציות אינטרנט, המשתמשים יופנו לאתר שבו הם יוכלו להעניק גישה. לאחר קבלת ההרשאה, הם יופנו לכתובת ה-URL לקריאה חוזרת (callback) שהוגדרה במסוף ממשקי ה-API.
    2. אפליקציות מותקנות פועלות באופן דומה. ספריית הלקוח תנסה לפתוח חלון דפדפן ולהשתמש בקוד הרשאה. באפליקציות ל-Android, ל-Chrome ול-iOS, השיטה הזו ספציפית לפלטפורמה.
  2. משתמשים ב-API Explorer עבור reports.generate כדי לבקש את הדוח הבא:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    דוחות מספקים תובנות לגבי הרווחים שלך ולגבי הגורמים שמשפיעים על הרווחים. אפשר להציג אותן בחשבון כולו או בקבוצת משנה של יחידות מודעות, באמצעות ערוצים.

  3. כדאי לנסות לבקש את אותו דוח גם מהאפליקציה.
  4. אפשר לסנן את הדוחות לפי יחידות של מודעות. אחזור הרשימה של יחידות המודעות באמצעות adunits.list. שימו לב שנדרש מזהה לקוח של מודעה (מקבלים אותו בשלב 1). אחרי שבוחרים יחידת מודעות, צריך להשתמש במזהה שלה בפרמטר filter עבור reports.generate:

    יחידות של מודעות הן placeholders שהוגדרו על ידי המשתמש, והם מגדירים מאפיינים מסוימים של המודעות שמוצגות (כמו גודל וצורה).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. אפשר לנסות לסנן לפי ערוצים מותאמים אישית או ערוצים של כתובות אתרים, או לשלב כמה מסננים.

    ערוצים הם כלים שמאפשרים לך לעקוב אחר הביצועים של קבוצת משנה של יחידות המודעות שלך. יש שני סוגי ערוצים: כתובת URL וערוצים מותאמים אישית. הכלי הראשון מאפשר לך לעקוב אחר הביצועים בדף או בדומיין ספציפיים, והשיטה השנייה מאפשרת לך לעקוב אחר הביצועים בקבוצות ספציפיות של יחידות מודעות שנבחרו על ידי המשתמשים.

כדי להתחיל בהטמעה, כדאי לעיין בשאר הקריאות והמשאבים הזמינים במסמכי התיעוד.