שילוב AdColony עם תהליך בחירת הרשת (Mediation)

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

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

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

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

דרישות

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

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

נרשמים ומתחברים לחשבון AdColony. הוסף את האפליקציה למרכז השליטה של AdColony לבעלי אתרים בלחיצה על הלחצן Setup New App (הגדרת אפליקציה חדשה).

הגדרה של אפליקציה חדשה ב-AdColony

ממלאים את הטופס ולוחצים על Create בחלק התחתון של הדף כדי להוסיף את האפליקציה ל-AdColony.

Android

אפליקציה ליצירת AdColony

iOS

אפליקציה ליצירת AdColony

אחרי יצירת האפליקציה, אפשר למצוא את מזהה האפליקציה בקטע מונטיזציה > אפליקציות בקטע מידע בסיסי על האפליקציה של האפליקציה.

Android

מזהה האפליקציה ב-AdColony

iOS

מזהה האפליקציה ב-AdColony

בשלב הבא, יוצרים אזור מודעות חדש בלחיצה על הלחצן Setup New Ad Zone (הגדרת אזור מודעות חדש) בקטע Ad Zones בדף האפליקציה. אנחנו ממליצים ליצור אזור מודעות חדש לגישור באמצעות AdMob גם אם כבר יש לכם אותו.

Android

אזור הגדרה של AdColony

iOS

אזור הגדרה של AdColony

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

  1. בהגדרה Zone is Active? (האזור פעיל?) בתור Yes (כן).

  2. מזינים שם לאזור המודעות.

  3. בחר באפשרות מודעת באנר בתור גודל אזור המודעה.

  4. מזינים ערך למכסת ההפעלה היומית.

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

  1. בהגדרה Zone is Active? (האזור פעיל?) בתור Yes (כן).

  2. מזינים שם לאזור המודעות.

  3. בוחרים באפשרות לפני סרטון/מעברון בתור סוג האזור.

  4. מזינים ערך למכסת ההפעלה היומית.

ההטבה הופעלה

  1. בהגדרה Zone is Active? (האזור פעיל?) בתור Yes (כן).

  2. מזינים שם לאזור המודעות.

  3. בוחרים באפשרות Value Exchange/V4VC בתור Zone Type (סוג אזור).

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

  5. מזינים ערך למכסת ההפעלה היומית.

בסיום יצירת אזור המודעות, לוחצים על הלחצן יצירה.

אחרי שיוצרים את אזור המודעות, אפשר לאתר את מזהה האזור בקטע Integration (שילוב) באזור Ad Zone. בשלב הבא נשתמש במזהה האזור.

מזהה אזור של AdColony

איתור מפתח ה-API של AdColony

בידינג

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

מפל

כדי להגדיר אתAdMob מזהה יחידת המודעות, תצטרכו את מפתח ה-API של AdColony. מנווטים אל Account Settings (הגדרות החשבון) במרכז הבקרה של AdColony לבעלי אתרים כדי לאתר את מפתח ה-API.

הגדרות AdColony

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

כדי להפעיל מודעות בדיקה ב-AdColony, עליך לעבור למרכז הבקרה של AdColony ולעבור אל מונטיזציה > אפליקציות. בקטע Ad zones באפליקציה, בוחרים את האזור שעבורו רוצים להפעיל את מודעות הבדיקה. כדי להפעיל מודעות בדיקה, מסמנים את האפשרות Yes ומסמנים Show test ads only? (הצגת מודעות בדיקה בלבד?) בקטע Development.

בדיקת AdColony

שלב 2: הגדרת הביקוש של AdColony AdMob בממשק המשתמש

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

Android

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

iOS

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

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

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

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

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

בעורך הפרויקטים ב-Unity, לוחצים על Assets > Import Package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsAdColonyMediation.unitypackage שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. הספרייה External Dependency Manager (מנהל התלות החיצונית) יבצע מאפס את הגדרות התלות ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

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

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

בפלאגין של תהליך בחירת הרשת (Mediation) במודעות Google לנייד, עבור AdColony בגרסה 2.6.1, נוסף המחלקה AdColonyAppOptions עם השיטות SetPrivacyFrameworkRequired() ו-SetPrivacyConsentString(), כדי לאפשר לך להעביר את ההסכמה ל-AdColony SDK. הקוד לדוגמה הבא מדגים איך להעביר מידע על הסכמה למתאם AdColony, ולאחר מכן להשתמש בהם בשיטת האתחול של AdColony. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את ה-SDK של מודעות Google לנייד, כדי לוודא שהן מועברות כראוי ל-SDK של AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

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

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

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

בפלאגין של תהליך בחירת הרשת (Mediation) במודעות Google לנייד, עבור AdColony בגרסה 2.6.1, נוסף המחלקה AdColonyAppOptions עם השיטות SetPrivacyFrameworkRequired() ו-SetPrivacyConsentString(), כדי לאפשר לך להעביר את ההסכמה ל-AdColony SDK. הקוד לדוגמה הבא מדגים איך להעביר את פרטי ההסכמה למתאם AdColony, ולאחר מכן להשתמש בהם בשיטת האתחול של AdColony. חשוב להגדיר את האפשרויות האלה לפני שמאתחלים את Google Mobile Ads SDK כדי לוודא שהן מועברות כראוי ל-SDK של AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

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

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

Android

לא נדרש קוד נוסף לשילוב של AdColony.

iOS

שילוב של SKAdNetwork

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

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

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

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

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

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

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

Android

הרשאות

לביצועים אופטימליים, AdColony ממליצה להוסיף את ההרשאות האופציונליות הבאות לקובץ AndroidManifest.xml שנמצא בספרייה Assets/Plugins/Android/GoogleMobileAdsPlugin בפרויקט Unity.

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

iOS

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

פרמטרים ספציפיים לרשת

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

המחלקה AdColonyMediationExtras כוללת את השיטות הבאות:

SetShowPrePopup(bool)
ההגדרה קובעת אם להציג חלון קופץ לפני הצגת מודעה. צריך להגדיר את הערך כ-false אם אתם לא רוצים להציג חלון קופץ לפני הצגת המודעות.
SetShowPostPopup(bool)
ההגדרה קובעת אם להציג חלון קופץ אחרי הצגת מודעה. יש להגדיר את הערך כ-false אם אתם לא רוצים להציג חלון קופץ לאחר הצגת המודעות.

המחלקה AdColonyAppOptions כוללת את השיטות הבאות:

SetUserId(string)
מגדיר את מזהה המשתמש ל-AdColony SDK שמספק ניתוח נוסף של שרת המודעות של AdColony.
SetTestMode(bool)
ההגדרה קובעת אם להפעיל או לא להפעיל מצב בדיקה עבור AdColony SDK.

הנה דוגמה לקוד של הגדרת ההגדרות האלה ופרמטרים של בקשות להצגת מודעות:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

קודי שגיאה

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

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

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

Android

קוד שגיאה סיבה
100 AdColony SDK החזיר שגיאה.
101 פרמטרים לא חוקיים של השרת (למשל, מזהה אזור חסר).
102 כבר נשלחה בקשה למודעה עבור אותו מזהה אזור.
103 AdColony SDK החזיר שגיאת אתחול.
104 גודל הבאנר המבוקש לא ממופה לגודל חוקי של מודעת AdColony.
105 שגיאה בהצגה כי המודעה לא נטענה.
106 ההקשר ששימש להפעלת ה-SDK של AdColony לא היה מופע של Activity.

iOS

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

יומן שינויים של תוסף הגישור של AdColony Unity

גרסה 2.6.3 (בתהליך)

  • תוקנה אזהרה של הגדרת כפילות עבור MediationExtras.

גרסה 2.6.2

גרסה 2.6.1

  • ממשקי ה-API של הפרטיות עודכנו מהמחלקה AdColonyAppOptions לשיטות הבאות:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • יש תמיכה במתאם AdColony Android בגרסה 4.8.0.1.
  • יש תמיכה במתאם AdColony iOS בגרסה 4.9.0.2.
  • נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.

גרסה 2.6.0

גרסה 2.5.0

גרסה 2.4.1

גרסה 2.4.0

גרסה 2.3.0

גרסה 2.2.0

גרסה 2.1.0

גרסה 2.0.3

גרסה 2.0.2

גרסה 2.0.1

גרסה

גרסה 1.0.6

גרסה 1.0.5

  • העברנו את השיטות הבאות ממחלקה AdColonyMediationExtras של Builder למחלקה AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • נוספו למחלקה AdColonyAppOptions את השיטות הבאות:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • הסרתי את השיטה SetZoneId() ממחלקת ה-builder של AdColonyMediationExtras.
  • יש תמיכה במתאם AdColony Android בגרסה 3.3.10.1.
  • יש תמיכה במתאם AdColony iOS בגרסה 3.3.7.2.

גרסה 1.0.4

  • הפלאגין עודכן ועכשיו הוא יתמוך ב-API החדש של תוכנית הבטא הפתוחה.
  • יש תמיכה במתאם Android של AdColony בגרסה 3.3.8.1.
  • יש תמיכה במתאם AdColony iOS בגרסה 3.3.6.1.

גרסה 1.0.3

  • יש תמיכה במתאם AdColony Android בגרסה 3.3.5.1.
  • יש תמיכה במתאם AdColony iOS בגרסה 3.3.5.0.

גרסה 1.0.2

  • יש תמיכה ב-AdColony Android SDK בגרסה 3.3.4.
  • יש תמיכה ב-AdColony iOS SDK בגרסה 3.3.4.
  • מעכשיו, ב-Android המערכת תתעלם מ-SetTestMode() ממחלקת ה-builder של AdColonyMediationExtras. בעלי תוכן דיגיטלי יכולים עכשיו לבקש מודעות בדיקה מ-AdColony ל-Android על ידי ציון מכשיר בדיקה דרך AddTestDevice() מהמחלקה AdRequest Builder.
  • הוספנו את השיטות הבאות למחלקה AdColonyMediationExtras ב-builder:
    • SetGDPRRequired()
    • SetGDPRConsentString()

גרסה 1.0.1

  • יש תמיכה ב-AdColony Android SDK בגרסה 3.3.0-unity.
  • יש תמיכה ב-AdColony iOS SDK בגרסה 3.3.0.

גרסה 1.0.0

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