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

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

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

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

דרישות

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

נרשמים או מתחברים לחשבון Liftoff Monetize.

לוחצים על הלחצן Add Application (הוספת אפליקציה) כדי להוסיף את האפליקציה ללוח הבקרה של Liftoff Monetize.

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

Android

iOS

אחרי שיוצרים את האפליקציה, בוחרים אותה מלוח הבקרה Applications (אפליקציות) ב-Liftoff Monetize.

Android

iOS

חשוב לשים לב למזהה האפליקציה.

Android

iOS

הוספת מיקומי מודעות חדשים

כדי ליצור מיקום מודעה חדש לשימוש בתהליך בחירת הרשתות ב-Ad Manager, עוברים אל לוח הבקרה של מיקומי המודעות ב-Liftoff Monetize, לוחצים על הלחצן Add Placement (הוספת מיקום מודעה) ובוחרים את האפליקציה מהתפריט הנפתח.

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

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

באנר 300x250

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

מעברון

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

ההטבה הופעלה

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

מודעות מעברון מתגמלות

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

מותאם

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

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

באנר 300x250

מעברון

ההטבה הופעלה

מודעות מעברון מתגמלות

מותאם

איתור מפתח Reporting API

בידינג

השלב הזה לא נדרש לשילובי בידינג.

מפל

בנוסף למזהה האפליקציה ולמזהה ההפניה, תצטרכו גם את מפתח Reporting API של Liftoff Monetize כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager. עוברים אל לוח הבקרה של הדוחות ב-Liftoff Monetize ולוחצים על הלחצן Reporting API Key (מפתח Reporting API) כדי לראות את מפתח Reporting API.

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt עבור Ad Manager.

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

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

כדי להפעיל מודעות לבדיקה, עוברים ללוח הבקרה של Liftoff Monetize ולוחצים על Applications (אפליקציות).

בקטע Placement Reference ID (מזהה מיקום להפניה) באפליקציה, בוחרים את האפליקציה שבה רוצים להפעיל מודעות בדיקה. כדי להפעיל מודעות בדיקה, בוחרים באפשרות Test Mode (מצב בדיקה) ואז באפשרות Show test ads only (הצגת מודעות בדיקה בלבד) בקטע Status (סטטוס).

Android

iOS

שלב 2: הגדרת הביקוש של Liftoff Monetize בממשק המשתמש של Ad Manager

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

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

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

כדי להוסיף את Liftoff לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager, פועלים לפי השלבים שמפורטים במאמרים בנושא הגדרות שקשורות לתקנות האירופאיות והגדרות שקשורות לתקנות במדינות בארה"ב.

שלב 3: מייבאים את Vungle SDK ואת מתאם Liftoff Monetize

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של Liftoff Monetize בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_liftoffmonetize: ^

שילוב ידני

מורידים את הגרסה העדכנית של פלאגין הגישור של Google Mobile Ads ל-Liftoff Monetize, מחלצים את הקובץ שהורד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

החל מגרסה 1.1.0 של הפלאגין Flutter ב-Liftoff Monetize, המערכת של Liftoff Monetize קוראת באופן אוטומטי את ההסכמה לתקנות GDPR שנקבעה בפלטפורמות לניהול הסכמה שתומכות במפרט של Google בנושא הסכמה נוספת, כולל UMP SDK. מידע נוסף זמין בהוראות המומלצות להטמעה של GDPR ב-Android וב-iOS.

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

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

התוסף של Google Mobile Ads לגישור עבור Liftoff Monetize כולל את השיטה GmaMediationLiftoffmonetize.setCCPAStatus(). הקוד לדוגמה הבא מראה איך להעביר מידע על הסכמה ל-Vungle SDK. אם בוחרים להפעיל את השיטה הזו, מומלץ להפעיל אותה לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

לפרטים נוספים ולערכים שאפשר לספק בשיטה, אפשר לעיין בהוראות ההטמעה המומלצות של CCPA ל-Android ול-iOS.

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

Android

לא נדרש קוד נוסף לשילוב עם Liftoff Monetize.

iOS

שילוב עם SKAdNetwork

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

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

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

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager והפעלתם את מצב הבדיקה בממשק המשתמש של Liftoff Monetize.

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Liftoff Monetize (Bidding)‎ ו-Liftoff Monetize (Waterfall)‎.

קודי שגיאה

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

Android

פורמט שם הכיתה
מודעות בפתיחת אפליקציה (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות בפתיחת אפליקציה (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter
באנר (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
באנר (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
מודעות מעברון (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעת מעברון (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
מודעות מתגמלות (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מתגמלות (Waterfall) com.vungle.mediation.VungleAdapter
מודעת מעברון מתגמלת (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעת מעברון מתגמלת (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

פורמט שם הכיתה
מודעות בפתיחת אפליקציה (בידינג) GADMediationAdapterVungle
מודעות בפתיחת אפליקציה (Waterfall) GADMediationAdapterVungle
באנר (בידינג) GADMediationAdapterVungle
באנר (Waterfall) GADMAdapterVungleInterstitial
מודעות מעברון (בידינג) GADMediationAdapterVungle
מודעת מעברון (Waterfall) GADMAdapterVungleInterstitial
מודעות מתגמלות (בידינג) GADMediationAdapterVungle
מודעות מתגמלות (Waterfall) GADMAdapterVungleRewardBasedVideoAd
מודעת מעברון מתגמלת (בידינג) GADMediationAdapterVungle
מודעת מעברון מתגמלת (Waterfall) GADMediationAdapterVungle

אלה הקודים וההודעות הנלוות שמוצגים על ידי מתאם Liftoff Monetize כשטעינת מודעה נכשלת:

Android

קוד שגיאה סיבה
101 פרמטרים לא תקינים של השרת (לדוגמה, מזהה אפליקציה או מזהה מיקום).
102 הגודל המבוקש של הבאנר לא תואם לגודל מודעה תקין ב-Liftoff Monetize.
103 מקור המודעות Liftoff Monetize דורש Activityהקשר כדי לשלוח בקשות להצגת מודעות.
104 ‫Vungle SDK לא יכול לטעון כמה מודעות לאותו מזהה מיקום מודעה.
105 האתחול של Vungle SDK נכשל.
106 ‫Vungle SDK החזיר קריאה חוזרת (callback) להצלחת הטעינה, אבל הפונקציות Banners.getBanner() או Vungle.getNativeAd() החזירו ערך null.
107 ‫Vungle SDK לא מוכן להפעלת המודעה.
108 ‫Vungle SDK החזיר טוקן בידינג לא תקין.

iOS

קוד שגיאה סיבה
101 פרמטרים לא תקינים של השרת (לדוגמה, מזהה אפליקציה או מזהה מיקום).
102 כבר נטענה מודעה להגדרת הרשת הזו. ‫Vungle SDK לא יכול לטעון מודעה שנייה לאותו מזהה מיקום מודעה.
103 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי Liftoff Monetize.
104 לא הייתה אפשרות להציג את מודעת הבאנר באמצעות Vungle SDK.
105 ספריית Vungle SDK תומכת בטעינה של מודעת באנר אחת בלבד בכל פעם, ללא קשר למזהה המיקום.
106 ‫Vungle SDK שלח קריאה חוזרת שאומרת שהמודעה לא ניתנת להפעלה.
107 ‫Vungle SDK לא מוכן להפעלת המודעה.

אם השגיאות מגיעות מ-Vungle SDK, אפשר לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ול-Android.

יומן השינויים של מתאם ה-Mediation של Liftoff Monetize Flutter

גרסה 1.2.1

גרסה 1.2.0

גרסה 1.1.1

גרסה 1.1.0

גרסה 1.0.0