משלבים את Tapjoy בתהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Tapjoy באמצעות תהליך בחירת הרשת (Mediation), שמכסה גם שילובים של בידינג וגם שילובים של Waterfall. נסביר איך להוסיף את Tapjoy להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Tapjoy באפליקציית Unity.

שילובים נתמכים ופורמטים נתמכים של מודעות

המתאם של AdMob תהליך בחירת הרשת ב-Tagjoy כולל את היכולות הבאות:

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

דרישות

  • Unity 4 ואילך
  • ה-SDK העדכני של מודעות Google לנייד
  • [לבידינג]: פלאגין תהליך בחירת הרשת של Google Mobile Ads בגרסה 2.3.0 ואילך (מומלץ להשתמש בגרסה העדכנית)
  • כדי לפרוס ב-Android
    • Android API ברמת 19 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
  • השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

שלב 1: הגדרת הגדרות בממשק המשתמש של Tapjoy

נרשמים או מתחברים למרכז הבקרה של Tapjoy.

הוספת אפליקציה

מוסיפים את האפליקציה למרכז הבקרה של Tapjoy על ידי מעבר לרשימת האפליקציות בפינה השמאלית העליונה ולחיצה על Add App. לאחר מכן תתבקשו להזין את פרטי האפליקציה.

ממלאים את הטופס ולוחצים על Create Now על מנת להוסיף את האפליקציה למרכז הבקרה של Tapjoy.

תוכלו לדלג על שלבי השילוב שמוצגים על ידי Tapjoy, ולעבור ליצירת מיקומי מודעות לשימוש AdMob בתהליך בחירת הרשת.

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

Android

iOS

מיקום, מטבע וירטואלי ותוכן

מיקום המודעה

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

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

שם המיקום שהוזן כאן משמש להגדרה שלAdMob יחידת המודעות לתהליך בחירת הרשת (Mediation) בקטע הבא. "AdMob תהליך בחירת הרשת" שימש בדוגמה זו, אך תוכל לקרוא למיקום שלך בכל שם אחר.

מטבע וירטואלי

בפינה הימנית העליונה, עוברים אל מונטיזציה > מטבע וירטואלי ולוחצים על הלחצן יצירת מטבע וירטואלי.

ממלאים את הטופס ולוחצים על יצירה עכשיו. השתמשו ב-NO_CALLBACK בתור כתובת ה-URL לקריאה חוזרת. כך אפשר להבטיח ש-Tagjoy SDK יימנע מקריאה מיותרת לשרת.

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

Android

iOS

Content

כדי ליצור תוכן שיוצג עם מיקומי המודעות, לוחצים על מונטיזציה > יצירת תוכן.

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

בידינג

פרסומת מרווח ביניים

לחץ על הלחצן יצירה עבור התוכן של סרטון מעברון פרוגרמטי. נותנים שם לתוכן ובוחרים את הפלטפורמה. * {Android} * {iOS} יש לבחור את המטבע הווירטואלי שנוצר קודם לכן, בתור מטבע וירטואלי. בוחרים את מיקום המעברון שנוצר בשלב מוקדם יותר. כשמסיימים ליצור את התוכן, לוחצים על הלחצן Save [שמירה] בחלק התחתון.

ההטבה הופעלה

לוחצים על הלחצן יצירה לצד תוכן של סרטון מתגמל פרוגרמטי. * {Android} * {iOS} בוחרים במטבע הווירטואלי שנוצר קודם לכן בתור המטבע הווירטואלי. בוחרים את מיקום המודעה המתגמל שיצרתם קודם. כשמסיימים ליצור את התוכן, לוחצים על Save בחלק התחתון.

מפל

פרסומת מרווח ביניים

לוחצים על הלחצן יצירה עבור התוכן של סרטון מעברון. נותנים שם לתוכן ובוחרים את הפלטפורמה. * {Android} * {iOS} יש לבחור את המטבע הווירטואלי שנוצר קודם לכן, בתור מטבע וירטואלי. בוחרים את מיקום המעברון שנוצר בשלב מוקדם יותר. כשמסיימים ליצור את התוכן, לוחצים על הלחצן Save [שמירה] בחלק התחתון.

ההטבה הופעלה

לוחצים על הלחצן יצירה כדי להציג תוכן של סרטון מתגמל. נותנים שם לתוכן ובוחרים את הפלטפורמה. * {Android} * {iOS} יש לבחור את המטבע הווירטואלי שנוצר קודם לכן, בתור מטבע וירטואלי. בוחרים את מיקום המודעה המתגמל שיצרתם קודם. כשמסיימים ליצור את התוכן, לוחצים על Save בחלק התחתון.

איתור מפתח ה-SDK

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

עוברים אל הגדרות > הגדרות האפליקציה. את מפתח ה-SDK אפשר לקבל מפרטי האפליקציה בכרטיסייה Applications (פלטפורמות של אפליקציות).

Android

iOS

איך לאתר מפתחות דיווח

בידינג

לא צריך לבצע את השלב הזה בשילובי בידינג.

מפל

כדי להמשיך, אתה זקוק למפתח OAuth של בעל אתר ולמפתח תהליך בחירת הרשת. תוכלו לקבל את מפתח ה-OAuth של בעל האתר באותו דף בכרטיסייה מפתחות API.

מפתח גישור מופיע באותו דף בכרטיסייה מפתחות בתהליך בחירת הרשת בעמודה מפתח Reporting API. המפתח נקרא AdMob.

הפעלת מצב בדיקה

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

Android

כדי למצוא את מזהה הפרסום של המכשיר שלך, עבור אל Google > מודעות בהגדרות המכשיר.

iOS

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

Swift

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Objective-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

בשלב הבא, משנים את התוכן שיצרתם קודם.

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

בקטע Basic של התוכן, מסמנים את התיבה Only for Test Devices (רק למכשירי בדיקה). לאחר מכן, לוחצים על שמירה בחלק התחתון של הדף. זהו! עכשיו יש לכם שילוב פעיל של גישור עם Tapjoy.

Android

iOS

שלב 2: הגדרת 'ביקוש ב- Tapjoy' AdMob בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

הוספה של Tapjoy לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Tapjoy לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .

שלב 3: מייבאים את ה-SDK והמתאם של Tapjoy

מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור Tapjoy דרך קישור ההורדה ב-Changelog, ומחלצים את GoogleMobileAdsTapjoyMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקטים ב-Unity, בוחרים באפשרות נכסים > ייבוא חבילה > חבילה מותאמת אישית ובוחרים את GoogleMobileAdsTapjoyMediation.unitypackage הקובץ שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

שלב 4: מטמיעים את הגדרות הפרטיות ב-Tagjoy SDK

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.

הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads לגרסה 1.1.1 כולל את השיטות SetUserConsent() ו-SubjectToGDPR(). הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-Tagjoy SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUserConsent("myUserConsent");

אפשר גם להגדיר דגל כדי לציין אם המשתמש כפוף ל-GDPR.

Tapjoy.SubjectToGDPR(true);

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

חוקי הפרטיות במדינות בארה"ב

חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.

פלאגין תהליך בחירת הרשת של Google Mobile Ads בגרסה 2.9.1 כולל את השיטה SetUSPrivacy(). הקוד לדוגמה הבא מראה איך להעביר מידע על הסכמה ל-Tagjoy SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUSPrivacy("myUSPrivacyString");

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

שלב 5: מוסיפים את הקוד הנדרש:

Android

לא נדרש קוד נוסף כדי לשלב את Tapjoy.

iOS

שילוב של SKAdNetwork

פועלים לפי התיעוד של Tapjoy כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 6: בודקים את ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Tapjoy ממשק המשתמש.

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Tapjoy, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Tapjoy (Bidding) and Tapjoy (Waterfall) מקורות המודעות.

שלבים אופציונליים

Android

הרשאות

כדי להשיג ביצועים אופטימליים, ההמלצה של Tapjoy היא להוסיף את ההרשאות האופציונליות הבאות לקובץ AndroidManifest.xml של האפליקציה. משנים את הקובץ AndroidManifest.xml שנמצא בתיקייה Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation וכוללים את ההרשאות האופציונליות הבאות:

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

iOS

אין שלבים נוספים לשילוב עם iOS.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Tagjoy, בעלי אתרים יכולים לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo במחלקות הבאות:

Android

מבנה הקורס שם הכיתה
פרסומת מרווח ביניים TapjoyAdapter
ההטבה הופעלה TapjoyMediationAdapter

iOS

מבנה הקורס שם הכיתה
פרסומת מרווח ביניים GADMAdapterTapjoy
ההטבה הופעלה GADMAdapterTapjoy

ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם Tapjoy כשטעינת מודעה נכשלה:

Android

קוד שגיאה סיבה
101 הפרמטרים של השרת של Tapjoy מוגדרים AdMob בממשק המשתמש חסרים/לא חוקיים.
103 בעל האתר חייב לבקש מודעות עם הקשר Activity.
104 ההפעלה של Tapjoy SDK נכשלה.
105 אירעה שגיאה בהצגת Tapjoy במהלך הפעלת הסרטון.
106 ל-Tapjoy SDK אין אפשרות לטעון בו-זמנית שתי מודעות עבור אותו מזהה מיקום מודעה.
107 האפליקציה לא ביקשה להציג מודעות מותאמות.
108 ל-Tapjoy SDK אין תוכן מודעה זמין.

iOS

קוד שגיאה סיבה
101 הפרמטרים של השרת של Tapjoy מוגדרים AdMob בממשק המשתמש חסרים/לא חוקיים.
102 ההפעלה של Tapjoy SDK נכשלה.
103 המתאם של Tapjoy לא תומך בפורמט המודעה המבוקש.
104 Tapjoy שלח קריאה חוזרת (callback) של טעינה מוצלחת, אבל לא היה תוכן זמין.
105 כבר נטענה מודעה עבור תצורת הרשת הזו.
106 ה-SDK של Tapjoy החזיר קריאה חוזרת של שגיאה שקשורה לכשל בווידאו.

יומן שינויים של הפלאגין של Tapjoy Unity לתהליך בחירת הרשת (Mediation)

גרסה 3.2.0

גרסה 3.1.1

גרסה 3.1.0

גרסה 3.0.0

גרסה 2.10.1

גרסה 2.10.0

גרסה 2.9.1

גרסה 2.9.0

גרסה 2.8.2

גרסה 2.8.1

גרסה 2.8.0

גרסה 2.7.1

גרסה 2.7.0

גרסה 2.6.1

גרסה 2.6.0

גרסה 2.5.1

גרסה 2.5.0

גרסה 2.4.2

גרסה 2.4.1

גרסה

גרסה 2.3.1

גרסה

  • יש תמיכה במתאם Android של Tapjoy בגרסה 12.3.1.0.
  • יש תמיכה במתאם Tapjoy ל-iOS בגרסה 12.3.1.0.

גרסה

  • הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של מתגמלות.
  • יש תמיכה במתאם Android של Tapjoy בגרסה 12.2.1.0.
  • יש תמיכה במתאם Tapjoy ל-iOS בגרסה 12.2.1.0.

גרסה

  • יש תמיכה במתאם Android של Tapjoy בגרסה 12.2.0.0.
  • יש תמיכה במתאם Tapjoy ל-iOS בגרסה 12.1.0.0.

גרסה 2.0.1

  • יש תמיכה במתאם Android של Tapjoy בגרסה 12.0.0.1.
  • יש תמיכה במתאם Tapjoy ל-iOS בגרסה 12.0.0.0.

גרסה

  • יש תמיכה במתאם Android של Tapjoy בגרסה 12.0.0.0.
  • יש תמיכה במתאם Tapjoy ל-iOS בגרסה 12.0.0.0.

גרסה 1.1.1

  • יש תמיכה ב-Tagjoy Android SDK בגרסה 11.12.2.
  • יש תמיכה ב-Tagjoy iOS SDK בגרסה 11.12.2.
  • נוספה שיטת Tapjoy.SetUserConsent() כדי להעביר את סטטוס ההסכמה של המשתמש ל-Tagjoy SDK בצורת מחרוזת הסכמה.
  • נוספה שיטת Tapjoy.SubjectToGDPR() כדי לציין אם תקנת ה-GDPR חלה על המשתמש או לא.

גרסה 1.1.0

  • יש תמיכה ב-Tagjoy Android SDK בגרסה 11.12.1.
  • יש תמיכה ב-Tagjoy iOS SDK בגרסה 11.12.1.

גרסה 1.0.0

  • השקה ראשונה!
  • יש תמיכה ב-Tagjoy Android SDK בגרסה 11.11.1.
  • יש תמיכה ב-Tagjoy iOS SDK בגרסה 11.11.1.