מתחילים

המסמך הזה מיועד למפתחים שרוצים להשתמש ב-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 לקריאה חוזרת שהוגדרה ב-Google API Console.
   2. אפליקציות מותקנות פועלות באופן דומה. ספריית הלקוח תנסה לפתוח חלון בדפדפן ולהשתמש בקוד הרשאה. באפליקציות ל-Android, ל-Chrome ול-iOS, השיטה הזו ספציפית לפלטפורמה.
2. משתמשים ב-Google APIs Explorer עבור reports.generate כדי לבקש את הדוח הבא:
   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS

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

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

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

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

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

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