הגדרה של קובץ app-ads.txt עבור האפליקציה

כדי שמערכת AdMob תוכל לאתר ולאמת את קובץ app-ads.txt שלכם:

• האפליקציה צריכה להיות רשומה בחנות Google Play או ב-Apple App Store.
• דף האפליקציה בחנות חייב לכלול קישור לאתר המפתחים, כפי שמוסבר במאמר הזה בשלב 1א'.

הנושאים במאמר:

• שלב 1: יוצרים אתר מפתחים
• שלב 2: יוצרים קובץ app-ads.txt
• שלב 3: מפרסמים את קובץ app-ads.txt באתר המפתחים
• שלב 4: ממתינים עד שמערכת AdMob תסיים לסרוק ולאמת את קובץ app-ads.txt
• שלב 5: מוודאים שקובץ app-ads.txt מאומת בחשבון AdMob

שלב 1: יוצרים אתר מפתחים

אתר מפתחים מאפשר למשתמשים לקבל מידע נוסף על האפליקציות שלכם ועל תוכן אחר. זו גם הדרך שבה תקן app-ads.txt בודק מי הבעלים של האפליקציה. דפי האפליקציות שלכם בחנות Google Play או ב-App Store צריכים לכלול קישור לאתר המפתחים כדי ש-AdMob ופלטפורמות פרסום אחרות יוכלו לבדוק מי הבעלים של האפליקציה.

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

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

הערה: אין צורך לציין בדף האפליקציה בחנות את כתובת ה-URL המלאה של הקובץ app-ads.txt. מערכת AdMob מבצעת סריקה לאיתור קובץ app-ads.txt שלכם על סמך שם המארח (הדומיין) של כתובת האתר. בשלב 3 מוסבר איך מערכת AdMob מאתרת את קובץ app-ads.txt שלכם. 

שלב 1א': מוסיפים את אתר המפתחים לדף האפליקציה בחנות

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

• ב-Google Play: מוסיפים את הכתובת של האתר בקטע שבו מוצגים הפרטים ליצירת קשר בדף האפליקציה:
  1. נכנסים ל-Play Console.
  2. בוחרים אפליקציה.
  3. בתפריט השמאלי, לוחצים על Store presence (נוכחות בחנות) > Store listing (דף האפליקציה בחנות).
  4. גוללים אל Contact Details (פרטים ליצירת קשר).
  5. מוסיפים את הכתובת של אתר המפתחים.
• ב-Apple App Store: מוסיפים את אתר המפתחים בשדה של כתובת ה-URL לשיווק בדף האפליקציה בחנות. 

אם תוסיפו אתר מפתחים או תעדכנו אותו בדף האפליקציה ב-Google Play, ייתכן שיחלפו עד 24 שעות לפני שמערכת AdMob תזהה את השינויים האלה.

שלב 2: יוצרים קובץ app-ads.txt

קובץ app-ads.txt לדוגמה:

‪# app-ads.txt example file:

‪greenadexchange.com, 12345, DIRECT, d75815a79

‪silverssp.com, 9675, RESELLER, 496211

‪blueadexchange.com, XF436, DIRECT

‪orangeexchange.com, 45678, RESELLER

‪silverssp.com, ABE679, RESELLER

‪google.com, pub-0000000000000000, DIRECT, f08047fec0942fa0

בדוגמה הזו:

• ‫google.com היא בורסת פרסום (ad exchange)
• ‫pub-0000000000000000 הוא מזהה בעל האפליקציה / מזהה החשבון
• ‫DIRECT הוא סוג הקשר
• ‫f08047fec0942fa0 הוא רשות האישורים (TAG)

 

הערה: חובה ליצור קובץ ads.txt בפורמט שהוגדר על ידי IAB Tech Lab כדי שאפשר יהיה לאמת אותו. אם אתם זקוקים לעזרה נוספת, תוכלו לעיין במפרט Authorized Sellers for Apps של IAB Tech Lab. 

שלב 2א': מוסיפים קטע קוד מותאם אישית לקובץ app-ads.txt

מערכת AdMob מספקת קטע קוד מותאם אישית שעוזר להגדיר את הקובץ app-ads.txt יותר בקלות. קטע הקוד המותאם אישית מכיל את מזהה בעל האפליקציה שלכם. 

כדי שמערכת AdMob תוכל לאמת את קובץ app-ads.txt שלכם, הוא צריך להיות בפורמט הנכון ולכלול את מזהה בעל האפליקציה.

כך תקבלו קטע קוד מותאם אישית, שכולל את מזהה בעל האפליקציה שלכם:

1. נכנסים לחשבון AdMob בכתובת https://apps.admob.com.
2. לוחצים על אפליקציות בסרגל הצד.
3. לחץ על All apps‏.
4. לוחצים על הכרטיסייה app-ads.txt.
5. לוחצים על איך להגדיר את app-ads.txt. 
6. לוחצים על  לצד קטע הקוד שרוצים להעתיק. 
7. מדביקים את קטע הקוד בקובץ app-ads.txt. 

שלב 2ב': (אופציונלי) מוסיפים מזהים של בתי עסק מורשים נוספים לקובץ app-ads.txt

אם אתם משתמשים ברשת מודעות נוספת, זכרו להוסיף אותה לקובץ app-ads.txt שלכם. הוספת הרשת תאפשר לספקים מצד שלישי לאתר ולאמת את קובץ app-ads.txt. תוכלו ליצור קשר עם רשת המודעות כדי לקבל ממנה פרטים לגבי קובץ app-ads.txt. 

שלב 3: מפרסמים את קובץ app-ads.txt באתר המפתחים

הסורק של AdMob מחפש את קובץ app-ads.txt שלכם על סמך אתר המפתחים שציינתם בדף האפליקציה בחנות. בהתאם למפרט של קובץ app-ads.txt, הסורקים מחפשים קבצים לפי תבניות ה-URL הבאות:

• https://<<hostname>>/app-ads.txt
• http://<<hostname>>/app-ads.txt

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

בטבלה הבאה מוצגות דוגמאות כלליות למקומות שבהם הסורק של AdMob מחפש קובץ app-ads.txt לפי כתובות שונות של אתרי מפתחים.

אם אתר המפתחים הוא:	הסורק מחפש בסדר הבא:
https://example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
http://help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt

 

במפרט של קובץ app-ads.txt מוגדרים כללים ספציפיים לגבי תתי-דומיינים. כשסורקים בונים כתובת URL של app-ads.txt, הם בודקים רמת תת-דומיין אחת לכל היותר מתוך הכתובת של אתר המפתחים.

למשל:

אם אתר המפתחים הוא:	הסורק מחפש בסדר הבא:
http://support.help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt הערה: help.example.com נמצא ברמת תת-הדומיין הראשונה ומשמש לסריקה, ואילו support.help.example.com נמצא ברמת התת-דומיין השנייה ולא משמש לסריקה.

 

לפי המפרט, תתי-דומיינים מסוג www.‎ ו-m.‎ מוחרגים ולא מוגדרים כמיקומים שבהם הסורקים מחפשים קבצים.

אם אתר המפתחים הוא:	הסורק מחפש בסדר הבא:
https://www.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
https://m.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt

 

שרת האינטרנט עשוי להפנות את הסורק באופן אוטומטי לקובץ app-ads.txt שמתארח במקום אחר (כולל בתת-דומיין מסוג www.‎).

אם הסורק מחפש קובץ כאן:	האפשרויות הבאות עשויות להיות יעדים תקפים להפניה אוטומטית:
https://example.com/app-ads.txt	תת-הדומיין מסוג www.‎ של האתר: https://www.example.com/app-ads.txt תת-דומיין וספריית משנה נוספים: https://static.example.com/files/app-ads.txt תת-דומיין, ספריית משנה או שם קובץ נוספים: https://static.example.com/files/app-ads-1.txt דומיין נוסף, שכולל מספר תתי-דומיינים: https://www.cdn.files.example.com/app-ads.txt

כדי לבדוק אם הקובץ פורסם בצורה נכונה, עליכם לוודא שתוכן הקובץ מופיע כשנכנסים לכתובת ה-URL של קובץ app-ads.txt בדפדפן האינטרנט. אם הקובץ מופיע בדפדפן האינטרנט, סביר להניח שהסורקים יצליחו למצוא אותו.

בחשבון AdMob תוכלו לראות פרטים על הניסיונות של מערכת AdMob לסרוק את קובץ app-ads.txt.

שלב 4: ממתינים עד שמערכת AdMob תסיים לסרוק ולאמת את קובץ app-ads.txt

תהליך הסריקה והאימות של קובצי app-ads.txt על ידי מערכת AdMob עשוי להימשך עד 24 שעות. מערכת AdMob בודקת באופן שגרתי את הקובץ העדכני ביותר, אבל אתם יכולים גם לבקש שהיא תסרוק את האפליקציה כדי לקבל תשובה מהירה יותר:

1. נכנסים לחשבון AdMob בכתובת https://apps.admob.com.
2. לוחצים על אפליקציות בסרגל הצד.
3. לחץ על All apps‏.
4. לוחצים על הכרטיסייה app-ads.txt.

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

   

6. לוחצים על חיפוש עדכונים. כשמבקשים שמערכת AdMob תבצע סריקה לחיפוש קובץ app-ads.txt, מערכת AdMob מעדכנת את הסטטוס של כל האפליקציות שקובץ app-ads.txt הזה משותף להן.
   • במקרים מסוימים הלחצן 'חיפוש עדכונים' לא יהיה זמין. חשוב לזכור שמערכת AdMob סורקת באופן שגרתי את הקובץ העדכני ביותר כדי לבדוק אם יש עדכונים.

תהליך הסריקה והאימות של קובצי app-ads.txt על ידי מערכת AdMob עשוי להימשך עד 24 שעות. צריך להמתין 24 שעות לפחות עד לעדכון הסטטוס של קובץ app-ads.txt.

אם הוספתם לאחרונה אתר מפתחים או עדכנתם לאחרונה את דף האפליקציה ב-Google Play, ייתכן שיחלפו עד 24 שעות לפני שמערכת AdMob תזהה את השינויים האלה.

שלב 5: מוודאים שקובץ app-ads.txt מאומת בחשבון AdMob

בחשבון AdMob אפשר לראות הסטטוס ואת הפרטים של קובץ app-ads.txt של כל האפליקציות. 

במקרה שהקובץ לא נמצא או לא מאומת, אפשר לעיין במידע שמופיע בחשבון AdMob או לקבל מידע נוסף על פתרון לבעיות שקשורות לקובץ app-ads.txt.