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

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

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

המתאם של תהליך בחירת הרשת ב-Ad Manager ל-Pangle כולל את היכולות הבאות:

^‫1 מקורות המודעות לבידינג ב-Pangle שזמינים כוללים את Pangle US,‏ Pangle KR ו-Pangle ROW.

² הפורמט הזה לא נתמך במקורות המודעות הבאים לבידינג ב-Pangle: ‏Pangle US.

דרישות מוקדמות

• הגרסה העדכנית של Google Mobile Ads Flutter Plugin.
• ‫[לבידינג ב-Pangle בארה"ב]: צריך להשתמש בגרסה 3.1.0 של מתאם Pangle ואילך.
• ‫Flutter framework בגרסה 3.7.0 ואילך.
• כדי לפרוס ב-Android
  • רמת API ב-Android‏ 24 ואילך.
• כדי לפרוס ב-iOS
  • יעד פריסה 13.0 ומעלה ב-iOS.
• פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads Flutter Plugin. פרטים נוספים זמינים במאמר הגדרת Google Mobile Ads Flutter Plugin.

‫שלב 1: קובעים את ההגדרות בממשק המשתמש של Pangle

נרשמים או מתחברים לחשבון ב-Pangle.

הוספת אפליקציה חדשה

עוברים לכרטיסייה Applications ולוחצים על הכפתור Add App.

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

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

יצירת מיקום מודעה

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

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

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

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

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

כדי להפעיל מודעות לבדיקה של Pangle, פועלים לפי ההוראות במדריך How to add a Test Ad (איך להוסיף מודעת בדיקה) של Pangle.

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

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

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

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

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

שילוב דרך pub.dev

(ל-Android בלבד) מוסיפים את המאגרים הבאים לקובץ build.gradle בתוך הספרייה android של הפרויקט:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

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

dependencies:
  gma_mediation_pangle: ^4.2.1

שילוב ידני

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

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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

‫GDPR והסכמה בהתאם ולתקנות האירופאיות

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

בגרסה 3.6.0 ואילך של מתאם Flutter ל-Pangle, המערכת של Pangle קוראת באופן אוטומטי את ההסכמה בהתאם ל-GDPR שהוגדרה על ידי פלטפורמות לניהול הסכמה שתומכות במפרט ההסכמה הנוספת של Google, כולל UMP SDK.

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

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

בדוגמת קוד לדוגמה הבאה אפשר לראות איך מעבירים פרטי הסכמה ל-SDK של Pangle. צריך להגדיר את פרטי ההסכמה לפני ההפעלה של Google Mobile Ads Flutter Plugin כדי לוודא שהם יועברו בצורה תקינה אל Pangle SDK.

במדריך ההטמעה של Pangle מפורטים הערכים שאפשר לספק בכל שיטה.

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

שילוב של SKAdNetwork

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

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

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

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

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-Pangle, צריך להפעיל את הבדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Pangle (Waterfall),‏ Pangle US SDK (בידינג),‏ Pangle KR SDK (בידינג) ו-Pangle ROW SDK (בידינג).

קודי שגיאה

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

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

GADMediationAdapterPangle

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

יומן השינויים של המתאם של Pangle למנגנון בחירת הרשת ל-Flutter

גרסה 4.2.1

• תמיכה בגרסה 8.3.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.3.0.8.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 4.2.0

• תמיכה בגרסה 8.3.0.3.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.3.0.6.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 4.1.2

• תמיכה בגרסה 8.2.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.2.1.0.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 4.1.1

• נוספה תמיכה בגרסה 9.1.0 של Google Mobile Ads Flutter Plugin.
• נוספה תמיכה ב-Swift Package Manager.
• תמיכה בגרסה 8.2.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.2.0.9.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 4.1.0

• תמיכה בגרסה 8.2.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.2.0.8.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.

גרסה 4.0.0

• העדכון כולל תמיכה בגרסה 9.0.0 של Google Mobile Ads Flutter Plugin.
• תמיכה בגרסה 8.1.0.3.1 של מתאם Pangle ל-Android.
• תמיכה בגרסה 8.2.0.3.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 9.0.0 של Google Mobile Ads Flutter Plugin.

גרסה 3.6.0

• הגרסה המינימלית של Flutter עודכנה ל-3.38.1.
• העדכון תומך בגרסה 8.0.0 של Google Mobile Ads Flutter Plugin.
• תמיכה בגרסה 7.9.1.3.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.9.0.8.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 8.0.0.

גרסה 3.5.3

• תמיכה בגרסה 7.8.5.2.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.8.5.6.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 7.0.0.

גרסה 3.5.2

• גרסת Flutter המינימלית עודכנה ל-3.35.1
• עודכן כדי לתמוך בגרסה 7.0.0 של הפלאגין של Google Mobile Ads ל-Flutter
• תמיכה בגרסה 7.8.0.8.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.8.0.6.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 7.0.0.

גרסה 3.5.1

• תמיכה בגרסה 7.8.0.8.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.8.0.5.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.5.0

• תמיכה בגרסה 7.8.0.7.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.8.0.3.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

‫גרסה 3.4.0

• תמיכה בגרסה 7.7.0.2.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.7.0.5.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.3.0

• תמיכה בגרסה 7.6.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.6.0.5.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.2.1

• תמיכה בגרסה 7.3.0.5.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.4.1.0.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.2.0

• תמיכה בגרסה 7.3.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.4.0.9.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.1.1

• תמיכה בגרסה 7.2.0.6.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.2.0.5.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.1.0

• תמיכה בגרסה 7.2.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.2.0.4.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 3.0.0

• תמיכה בגרסה 7.1.0.8.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 7.1.1.1.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 2.2.0

• תמיכה בגרסה 6.5.0.8.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 6.5.0.9.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 2.1.0

• תמיכה בגרסה 6.5.0.4.1 של מתאם Pangle ל-Android.
• תמיכה בגרסה 6.5.0.8.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 2.0.0

• תמיכה בגרסה 6.4.0.6.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 6.4.1.1.0 של המתאם של Pangle ל-iOS.
• נבנה ונבדק עם גרסה 5.3.0 של Google Mobile Ads Flutter Plugin.

גרסה 1.1.0

• תמיכה בגרסה 5.9.0.4.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 5.9.0.7.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 5.1.0 של הפלאגין למודעות לנייד של Google ל-Flutter.

גרסה 1.0.0

• הגרסה הראשונה.
• תמיכה בגרסה 5.8.0.9.0 של מתאם Pangle ל-Android.
• תמיכה בגרסה 5.8.0.8.0 של מתאם Pangle ל-iOS.
• נבנה ונבדק עם גרסה 5.0.1 של Google Mobile Ads Flutter Plugin.