שנתחיל?

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

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

פותחים חשבון AdSense

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

היכרות עם AdSense

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

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

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

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

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

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

רישום הבקשה

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

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

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

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

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

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

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

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

   1. כשמדובר באפליקציות אינטרנט, המשתמשים יופנו לכתובת אתר שבה הם יוכלו לבחור להעניק גישה. לאחר ההרשאה, המערכת תפנה אותם לכתובת ה-URL לקריאה חוזרת (callback) שהוגדרה במסוף ממשקי ה-API.
   2. אפליקציות מותקנות פועלות באופן דומה. ספריית הלקוח תנסה לפתוח חלון דפדפן ולהשתמש בקוד הרשאה. ל-Android, אפליקציות Chrome ו-iOS הן שיטה ספציפית לפלטפורמה.
2. צריך להשתמש בכלי ניתוח ה-API עבור 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 או לשלב כמה מסננים.

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

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