שילוב של Moloco עם תהליך בחירת הרשת

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

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

מתאם הגישור של Moloco כולל את היכולות הבאות:

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

דרישות

  • יעד הפריסה של iOS הוא 12.0 ומעלה

  • גרסה 3.9.1.0 ומעלה של המתאם של Moloco

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

מתחברים ל-Moloco Publisher Portal.

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

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

אחרי שיוצרים את האפליקציה, בוחרים אותה בכרטיסייה Apps כדי לראות את הפרטים שלה ורושמים את App Key.

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

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

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

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

הגדרת הגדרות הגישור ליחידת המודעות

צריך להוסיף את Moloco Ads SDK להגדרות של תהליך בחירת הרשת עבור יחידת המודעות.

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

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת.

מזינים את פורמט המודעה והפלטפורמה ולוחצים על המשך.

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

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

עכשיו אמור להופיע כרטיס של יחידות מודעות עם יחידות המודעות שבחרתם:

הוספה של Moloco Ads SDK כמקור מודעות

בכרטיס Bidding שבקטע Ad Sources, בוחרים באפשרות Add ad source. לאחר מכן בוחרים באפשרות Moloco Ads SDK .

לוחצים על איך חותמים על הסכם שותפות ועל הגדרה של שותפות לבידינג עם Moloco Ads SDK.



לוחצים על אישור והסכמה ואז על המשך.



אם כבר יש לכם מיפוי ל-Moloco Ads SDK, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



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

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

כדי להוסיף את Moloco Ads לרשימת שותפי הפרסום שמספקים שירותים שקשורים לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות שקשורות לתקנות האירופאיות והגדרות שקשורות לתקנות במדינות בארה"ב.

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

  • מוסיפים את השורה הבאה לקובץ Podfile של הפרויקט:

    pod 'GoogleMobileAdsMediationMoloco'

  • מריצים את הפקודה הבאה משורת הפקודה:

    pod install --repo-update

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

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

‫Moloco SDK כולל את הדגל hasUserConsent להעברת פרטי הסכמה אל Moloco SDK.

קוד לדוגמה שמראה איך להעביר מידע על הסכמה ל-SDK של Moloco. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setHasUserConsent:YES];

מידע נוסף זמין במסמכי הפרטיות של Moloco.

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

חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.

‫Moloco SDK כולל את הדגל isDoNotSell להעברת מידע על הסכמה אל Moloco SDK.

קוד לדוגמה שמראה איך להעביר מידע על הסכמה ל-SDK של Moloco. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

מידע נוסף זמין במסמכי הפרטיות של Moloco.

שלב 5: בדיקת ההטמעה

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

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

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Moloco Ads SDK, אתם צריכים להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Moloco (Bidding).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Moloco, אפשר לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות GADResponseInfo.adNetworkInfoArray במחלקות הבאות:

MolocoSDK.MolocoError
GADMediationAdapterMoloco

אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם Moloco כשטעינת מודעה נכשלת:

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.moloco ‫Moloco SDK לא תומך בהצגת מודעות ב-iOS 12 ובגרסאות קודמות.
102 com.google.ads.mediation.moloco מפתח האפליקציה של Moloco חסר או לא תקין.
103 com.google.ads.mediation.moloco מזהה יחידת המודעות של Moloco חסר או לא תקין.
104 com.google.ads.mediation.moloco המודעה לא מוכנה להצגה.
105 com.google.ads.mediation.moloco המודעה לא הוצגה.
106 com.google.ads.mediation.moloco נתוני הרינדור לא זמינים כדי לרנדר את המודעה.
‫‎-1 עד 5000 נשלחה על ידי Moloco SDK ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco.

אימות בצד השרת של מודעות מתגמלות

אם מאמתים קריאות חוזרות (callback) של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.

יומן השינויים של מתאם הגישור של Moloco ל-iOS

גרסה 3.13.0.0 (בביצוע)

  • כולל את הקובץ Info.plist בתוך המסגרות.

גרסה 3.12.1.0

  • תאימות מאומתת לגרסה 3.12.1 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.8.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.12.1.

גרסה 3.12.0.0

  • תאימות מאומתת לגרסה 3.12.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.8.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.12.0.

גרסה 3.11.0.0

  • תאימות מאומתת לגרסה 3.11.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.11.0.

גרסה 3.10.1.0

  • תאימות מאומתת לגרסה 3.10.1 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.10.1.

גרסה 3.10.0.0

  • תאימות מאומתת לגרסה 3.10.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.5.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.10.0.

גרסה 3.9.1.0

  • נוספה תמיכה בסימן מים לפורמטים של מודעות לבידינג.
  • תוקנה בעיה בטעינת מודעות באנר MREC.
  • תאימות מאומתת לגרסה 3.9.1 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.9.1.

גרסה 3.9.0.0

  • השם של פלטפורמת תהליך בחירת הרשת (Mediation) מוגדר עכשיו כשמאתחלים את Moloco SDK.
  • תאימות מאומתת לגרסה 3.9.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.9.0.

גרסה 3.8.0.0

  • הדגלים -fobjc-arc ו--fstack-protector-all מופעלים.
  • תוקנה בעיה בקבלת דירוג הכוכבים של מודעות מותאמות.
  • תאימות מאומתת לגרסה 3.8.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.2.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.8.0.

גרסה 3.7.2.0

  • תאימות מאומתת לגרסה 3.7.2 של Moloco SDK.
  • נוספה תמיכה בבידינג על פורמט של מודעה מותאמת.

נבנה ונבדק באמצעות:

  • גרסה 12.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.2.

גרסה 3.7.1.0

  • תאימות מאומתת לגרסה 3.7.1 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.1.

גרסה 3.7.0.0

  • תאימות מאומתת לגרסה 3.7.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.0.

גרסה 3.6.0.1

  • המתאם עודכן כדי לאחזר את גרסת Moloco SDK מה-thread הראשי.
  • מעכשיו נדרשת גרסה 12.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.6.0.

גרסה 3.6.0.0

  • תאימות מאומתת לגרסה 3.6.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.6.0.

גרסה 3.5.0.0

  • זו הגרסה הראשונה.
  • נוספה תמיכה בבידינג בפורמטים של מודעות באנר (כולל MREC), מודעות מעברון ומודעות מתגמלות.
  • תאימות מאומתת לגרסה 3.5.0 של Moloco SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.5.0.