تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج Meta Audience Network مع عروض الأسعار

يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من Meta Audience Network باستخدام توسّط AdMob، التي تتناول عمليات دمج عروض الأسعار يتناول كيفية إضافة Meta Audience Network إلى تهيئة التوسط للوحدة الإعلانية وكيفية دمج Meta Audience حزمة تطوير البرامج (SDK) والمحوّل للشبكة في iOS تطبيق.

أشكال الإعلانات وعمليات الدمج المتوافقة

يتضمّن محوِّل التوسّط في Meta Audience Network الإمكانات التالية:

الدمج
عروض الأسعار
شلال ¹
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
إعلان بيني يضم مكافأة
مدمجة مع المحتوى

¹ Meta Audience Network أصبح عروض الأسعار فقط في عام 2021.

المتطلبات

أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

الإصدار 10.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
محوّل Meta Audience Network الإصدار 5.10.0.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)
عادةً ما تتطلب أحدث حزمة تطوير برامج (SDK) من Meta Audience Network أحدث المعلومات إصدار Xcode

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network

الاشتراك وتسجيل الدخول إلى صفحة بدء "مركز إدارة النشاط التجاري"

انقر على البدء ثم إنشاء حساب جديد.

املأ الحقول المطلوبة بتفاصيل نشاطك التجاري، ثم انقر على التالي.

إنشاء موقع

بعد ملء المعلومات المطلوبة، يُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم الذي تريده للموقع الخاص بتطبيقك وانقر على التالي.

الخطوة التالية هي اختيار المنصّة لتحقيق الربح.

أضِف تفاصيل التطبيق وانقر على التالي.

يمكنك إعداد حساب الدفعات بالنقر على إضافة حساب دفعات جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع الخاصة بك. املأ التفاصيل اللازمة، ثم انقر على التالي.

اختر Google AdMob باعتباره منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.

اختَر تنسيقًا واملأ النموذج وانقر على إنشاء.

دوِّن رقم تعريف موضع الإعلان.

انقر على تم.

تفعيل وضع الاختبار

اطّلع على دليل تنفيذ شبكة جمهور اختبار للحصول على تعليمات تفصيلية حول كيفية تفعيل الإعلانات الاختبارية "شبكة جمهور Meta".

الخطوة 2: إعداد طلب شبكة Meta Audience Network في واجهة مستخدم AdMob

ضبط إعدادات التوسّط لوحدتك الإعلانية

عليك إضافة Meta Audience Network إلى إعداد التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط لتعديلها، ثم انتقِل مباشرةً إلى إضافة Meta Audience Network كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر مواقع جغرافية لاستهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعَّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية AdMob الحالية. بعد ذلك، انقر على تمّ.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

إضافة Meta Audience Network كمصدر إعلان

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر Meta Audience Network.

انقر على كيفية توقيع اتّفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Meta Audience Network.

انقر على إقرار وموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين بالفعل لـ Meta Audience Network، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل Placement ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

إضافة Facebook إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Facebook إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.

الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لمنصة Meta Audience Network

استخدام CocoaPods (يُنصح به)

أضف السطر التالي إلى Podfile لمشروعك:
```
pod 'GoogleMobileAdsMediationFacebook'
```
من سطر الأوامر، قم بتشغيل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بشبكة Meta Audience Network للنطاق iOS وربط FBAudienceNetwork.framework في مشروعك.
نزِّل أحدث إصدار من محوّل Meta Audience Network من رابط التنزيل في سجل التغييرات وربط MetaAdapter.framework في مشروعك.

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بشبكة Meta Audience Network

موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات

بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

اتّبِع الإرشادات الواردة في مستندات Meta. للّائحة العامة لحماية البيانات والإعلانات الوصفية

قوانين الخصوصية في الولايات الأمريكية

الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.

اتّبِع الإرشادات الواردة في مستندات Meta لخيارات معالجة البيانات للمستخدمين في كاليفورنيا.

الخطوة 5: إضافة الرمز المطلوب

أخطاء التجميع

Swift

ليس عليك استخدام رمز إضافي لدمج Swift.

Objective-C

بالنسبة إلى محوّل Meta Audience Network الإصدار 6.9.0.0 أو الإصدارات الأحدث، يجب اتّباع لإضافة مسارات Swift إلى إعدادات الإصدار ضمن هدفك لمنع حدوث أخطاء في التجميع.

أضِف المسارات التالية إلى إعدادات الإصدار للاستهداف ضمن المكتبة. مسارات البحث:

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(SDKROOT)/usr/lib/swift

أضف المسار التالي إلى إعدادات الإصدار للهدف ضمن مسارات البحث في Runpath:

/usr/lib/swift

تم تفعيل تتبُّع الإعلانات

إذا كنت بصدد إنشاء نظام التشغيل iOS 14 أو إصدار أحدث، تتطلب Meta Audience Network ما يلي: قد قمت بتعيين تتبع الإعلانات مفعَّلة باستخدام الرمز التالي:

Swift

// Set the flag as true
FBAdSettings.setAdvertiserTrackingEnabled(true)

Objective-C

// Set the flag as true.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

دمج SKAdNetwork

اتّباع مستندات Meta Audience Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

الخطوة 6: اختبار عملية التنفيذ

تفعيل الإعلانات التجريبية

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Meta Audience Network (Bidding) مصادر الإعلانات.

خطوات اختيارية

إعلانات مدمجة مع المحتوى

بعض الإشعارات الإعلان المدمج مع المحتوى على شبكة Audience Network لم يتم ربط مواد العرض واحد لواحد بمواد عرض الإعلانات المدمجة مع المحتوى من Google. تم تمرير مواد العرض هذه إلى الناشر في السمة extraAssets ضمن GADNativeAd. تشير رسالة الأشكال البيانية يتيح تمرير الأصول التالية:

طلب المعلَمات والقيم
`GADFBSubtitle`	سلسلة: العنوان الفرعي للإعلان
`GADFBSocialContext`	سلسلة: السياق الاجتماعي للإعلان

في ما يلي مثال على رمز برمجي يوضّح كيفية استخراج مواد العرض هذه:

Swift

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

استخدام الإعلانات المدمجة مع المحتوى على شبكة Meta Audience بدون MediaView

يتطلب شكل الإعلان المدمج مع المحتوى في Meta Audience Network عرض GADMediaView مادة العرض. إذا كنت تخطط لعرض إعلانات مدمجة مع المحتوى بدون مادة العرض هذه، احرص على استخدام لشركة Meta Audience Network إعلان بانر مدمج مع المحتوى شكل الإعلان هذا.

لاستخدام إعلانات البانر المدمجة مع المحتوى على Meta Audience Network بدلاً من ذلك، يجب اختيار تنسيق Native Banner عند إعداد Meta Audience Network سيعمل تلقائيًا على تحميل شكل الإعلان المدمج مع المحتوى المقابل له.

عرض الإعلانات

يعرض محوّل شبكة الجمهور إعلاناته المدمجة مع المحتوى في شكل GADNativeAd الأخرى. يملأ ما يلي أوصاف حقول الإعلانات المدمجة مع المحتوى لمدة GADNativeAd

الحقل	تتم التعبئة بواسطة محوّل Meta Audience Network
العنوان
صورة	1
النص الأساسي
رمز التطبيق
الحث على اتخاذ إجراء
اسم المعلن
التقييم النجمي
المتجر
السعر

¹ محوّل Meta Audience Network لا توفّر إمكانية الوصول المباشر إلى مادة عرض الصورة الرئيسية لإعلاناتها المدمجة مع المحتوى وبدلاً من ذلك، يملأ المحول GADMediaView مع فيديو أو صورة.

تتبُّع مرّات الظهور والنقرات

يوضّح الجدول التالي أوقات تسجيل مرات ظهور الإعلانات المدمجة مع المحتوى والنقرات عليها حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

تسجيل مرّات الظهور	النقر على التسجيل
1 بكسل من مادة عرض الإعلان المدمج مع المحتوى على الشاشة في Meta Audience Network + متطلبات عرض مادة العرض	معاودة الاتصال بحزمة تطوير البرامج (SDK) لشبكة Audience Network

تفرض Meta Audience Network متطلبات محدّدة لعرض مواد العرض من أجل مرة الظهور ليتم اعتبارها صالحة، اعتمادًا على ما إذا كنت قد اخترت شكل إعلان مدمج مع المحتوى أو إعلان بانر مدمج مع المحتوى عند إعداد Meta Audience الشبكة.

شكل الإعلان المدمج مع المحتوى في Meta Audience Network	مادة العرض المطلوبة	فئة العرض المطلوبة
مدمجة مع المحتوى	عرض الوسائط	`GADMediaView`
إعلان بانر مدمج مع المحتوى	رمز التطبيق	`UIImageView`

رموز الخطأ

إذا تعذّر على المحوّل استلام إعلان من شبكة Audience Network، يمكنك التحقّق من خطأ أساسي من استجابة الإعلان باستخدام GADResponseInfo.adNetworkInfoArray ضمن الفئات التالية:

GADMAdapterFacebook
GADMediationAdapterFacebook

في ما يلي الرموز والرسائل المصاحبة التي طرحتها شبكة الجمهور المحول عند إخفاق تحميل الإعلان:

رمز الخطأ	السبب
101	معلمات الخادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان مفقود).
102	لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Meta Audience Network.
103	تعذّر إعداد عنصر الإعلان Meta Audience Network.
104	تعذّر على حزمة تطوير البرامج (SDK) الخاصة بشبكة Meta Audience Network عرض الإعلان البيني/الإعلان بمكافأة.
105	وحدة التحكّم في العرض الجذري لإعلان البانر هي `nil`.
106	تعذّر إعداد حزمة تطوير البرامج (SDK) لشبكة Meta Audience Network.
1000-9999	عرضت Meta Audience Network خطأً خاصًا بحزمة تطوير البرامج (SDK). عرض مستندات Meta Audience Network لمزيد من التفاصيل.