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

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

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

איך מגדירים קובץ app-ads.txt באפליקציה

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

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

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

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

אם אין לכם אתר מתאים שמאפשר להעלות קובץ app-ads.txt ברמה הבסיסית (root), אתם יכולים להשתמש בתכונה "אירוח ב-Firebase" כדי לארח את קובץ app-ads.txt. איך לפרסם קובץ app-ads.txt באמצעות התכונה "אירוח ב-Firebase"

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

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

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

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

• ב-Google Play: מוסיפים את כתובת האתר בקטע של הפרטים ליצירת קשר בדף האפליקציה בחנות:
  1. נכנסים ל-Play Console.
  2. בוחרים באפליקציה.
  3. בתפריט הימני, לוחצים על נוכחות בחנות Play ואז על הגדרות החנות.
  4. גוללים לקטע פרטים ליצירת קשר בדף האפליקציה בחנות.
  5. מוסיפים את הכתובת של אתר המפתח. כדי לוודא שכתובת ה-URL נוספה, בודקים שיש קישור לכתובת של אתר המפתח בקטע "תמיכה באפליקציה" בדף האפליקציה ל-Android.
     הערה: אם מוסיפים או מעדכנים את אתר המפתח בתוך דף האפליקציה בחנות Google Play, יכול להיות שיעברו עד 24 שעות לפני שמערכת AdMob תזהה את השינויים האלה.

• ב-Apple App Store: מוסיפים את אתר המפַתח בשדה של כתובת ה-URL לשיווק שבדף האפליקציה בחנות. אפשר לערוך את השדה של כתובת ה-URL לשיווק בשדה פרטי האפליקציה – כשמפרסמים גרסה חדשה של האפליקציה ל-iOS או כשמשיקים אפליקציה חדשה בחנות האפליקציות. כדי לוודא שכתובת ה-URL נוספה, צריך לבדוק שהקישור "אתר המפתח" מוצג בחלק התחתון של דף האפליקציה ל-iOS.

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

אם אין באתר שלכם קובץ app-ads.txt, אתם יכולים ליצור אותו. כדי שהמערכת תוכל לאמת את הקובץ, הוא צריך להיות בפורמט הנכון ולכלול את מזהה בעל האפליקציה שלכם. כדי ליצור קובץ טקסט (‎.txt), תוכלו להשתמש בכלי לעריכת טקסט פשוט, כמו Notepad‏ (Windows) או TextEdit‏ (Mac). תצטרכו להוסיף את קטע הקוד המותאם אישית לקובץ 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, f08c47fec0942fa0

בדוגמה למעלה:

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

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

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

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

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

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

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

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

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

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

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

תיקיית השורש של האתר היא הספרייה או התיקייה שמופיעה אחרי הדומיין ברמה העליונה, לדוגמה: example.com/ads.txt (ב-example.com/ads.txt,‏ example.com היא תיקיית השורש שאליה מעלים את קובץ ads.txt.)

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

שלב 3ב': מוודאים שהקובץ פורסם בצורה תקינה

חשוב לבדוק אם התוכן של קובץ app-ads.txt זמין. בדפדפן האינטרנט, מזינים את כתובת ה-URL של קובץ app-ads.txt (לדוגמה: https://example.com/app-ads.txt). אם קובץ app-ads.txt מופיע בדפדפן האינטרנט, סביר להניח שמערכת AdMob תוכל למצוא אותו.

הסורק של קובצי app-ads.txt ב-AdMob

הסורק של קובצי 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 מוגדרים כללים ספציפיים לגבי תתי-דומיינים

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

סריקה עד לתת-דומיין ברמה הראשונה

כשסורקים יוצרים כתובת 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.‎

לפי המפרט, תתי-דומיינים מסוג 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://admob.google.com.
2. לוחצים על אפליקציות בסרגל הצד.
3. לוחצים על לכל האפליקציות.
4. לוחצים על הכרטיסייה app-ads.txt.

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

   

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

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

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

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

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

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