إسناد تثبيت التطبيقات بدون معرّف GAID: إسناد عمليات التثبيت بدون معرّفات الإعلانات

كيفية التعامل مع إسناد تطبيقات الجوال بدون إمكانية الوصول إلى معرّفات الإعلانات؟ يمكنك إسناد عمليات تثبيت التطبيقات بدون معرّف GAID أو IDFA، ولكن البنية الأساسية تتغير: فبدلاً من الاعتماد على معرّف إعلاني دائم، تجمع البنى الحديثة بين أطر عمل الإسناد التي تتوسط فيها المنصات، وGoogle Play Install Referrer، وتوجيه المعلمات السياقية للطرف الأول، والتحقق من جانب الخادم.

معرّف الإعلانات هو معرّف برمجيات قابل لإعادة التعيين توفره منصة الجوال لأغراض الإعلانات والقياس. ففي نظام أندرويد، هذا هو معرّف الإعلانات المُقدّم من خدمات Google Play؛ أما في منصات أפל، فيخضع الوصول إلى معرّف IDFA لإطار عمل شفافية تتبع التطبيقات.

باختصار: ملخص إسناد الجوال الخالي من المعرّفات

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

• تقارير حملات الإعلانات المدفوعة (أندرويد): استخدم واجهة برمجة تطبيقات Google Play Install Referrer لاسترداد معلمات الحملة التي تتوسط فيها المتجر لعمليات التثبيت المُوزّعة عبر متجر بلاي.

• تقارير حملات الإعلانات المدفوعة (آي أو إس): استخدم Apple AdAttributionKit وSKAdNetwork للحصول على إشعارات لاحقة موقعة من المنصة وتحافظ على الخصوصية.

• الإعداد الشامل من الويب إلى التطبيق والإحالات: استخدم طبقة استعادة سياق التثبيت للطرف الأول (مثل OpoInstall) لاستعادة رموز العروض الترويجية، ومعرّفات الغرف، ورموز المُحيل عند الإطلاق الأول.

• إعادة الاستهداف عبر التطبيقات: يتطلب معرّفاً أو آلية قياس مرخصة ومدعومة من المنصة، مع الالتزام بسياسات المنصة المعمول بها، وضوابط المستخدم، ومتطلبات الموافقة.

مصفوفة قرار البنية: اختيار وحدة الإسناد المناسبة

لتحديد الآلية التقنية المناسبة لتطبيقك، قم بتقييم متطلباتك التشغيلية المحددة في مقابل إمكانيات المنصة:

بدائل GAID: ما الذي يعمل بالفعل

عندما تبحث فرق الهندسة عن «بديل لـ GAID»، فإنها غالباً ما تحاول حل مشكلات تشغيلية متعددة ومنفصلة باستخدام أداة واحدة. في بيئة الإنتاج، يجب تفكيك الهُياكل المعتمدة على GAID إلى أربعة حلول مستقلة:

                        Legacy GAID Workflows
                                 │
     ┌───────────────────────────┼───────────────────────────┐
     │                           │                           │
     ▼                           ▼                           ▼
Paid Campaign ROI           Web-to-App Routing          Referral Binding
     │                           │                           │
     ▼                           ▼                           ▼
Play Install Referrer /     First-Party Context       First-Party Referral
AdAttributionKit            Parameter Routing         Token Restoration

• استبدال استرداد سياق التثبيت المستند إلى GAID: استخدم Google Play Install Referrer حيثما كان ذلك منطقياً لعمليات التثبيت المُوزّعة عبر متجر بلاي، إلى جانب عمليات دمج شبكات الإعلانات واجهات برمجة تطبيقات الإسناد المدعومة من المنصة. توفر هذه الأطر سياق أصل التثبيت دون الكشف عن أجهزة ثابتة أو معرّفات إعلانية.

• استبدال GAID للإعداد والروابط العميقة: انشر طبقة استعادة سياق التثبيت للطرف الأول (مثل OpoInstall). فبدلاً من الاستعلام عن معرّف إعلاني للانضمام إلى سجلات النقر، قم تمرير المعلمات الديناميكية عبر عناوين URL للحملات المملوكة واستعادتها عند الإطلاق الأول للتطبيق عبر حزمة تطوير البرمجيات (SDK) للعميل.

• استبدال GAID لهوية المستخدم: استخدم أنظمة حسابات الطرف الأول المصادق عليها (مثل OAuth أو معرفات UUID الداخلية للمستخدم) بدلاً من مفاتيح الإعلانات على مستوى الجهاز.

التصنيف المعماري الأساسي: ما تقدمه الوحدات الأساسية المختلفة

مقارنة بين GAID وInstall Referrer واستعادة معلمات الطرف الأول

بدائل GAID لإسناد تطبيقات أندرويد

عند التشغيل على أجهزة أندرويد بدون إمكانية الوصول إلى معرّف إعلانات جوجل، تنشر الفرق الهندسية آليات بديلة مصممة خصيصاً لقنوات الحملات:

كيف تتعامل منصات إسناد الجوال وMMPs مع القياس بدون GAID

قامت شركاء قياس الجوال (MMPs) مثل AppsFlyer وAdjust وSingular وBranch بتكييف بنيتها التقنية لدعم القياس عندما تفتقر المعرّفات الإعلانية:

من خلال إقران شريك قياس (MMP) لتقارير شبكات الإعلانات الشاملة مع طبقة توجيه سياقية للطرف الأول لتخصيص الإعداد الدقيق، يمكن للفرق الهندسية إنشاء مجموعة قياس وإعداد متكاملة ومتبادلة دون انتهاك أضخم الخصوصية لأنظمة التشغيل.

لماذا تؤدي قيود معرّفات الإعلانات إلى تعطيل إسناد الجوال الحتمي

الاعتماد التاريخي على معرّفات الإعلانات الدائمة

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

أدى البحث البسيط في التساوي من جانب الخادم ($GAID*{\\text{click}} == GAID*{\\text{install}}$) إلى إنشاء رابط واضح بين الإنفاق الإعلاني وتثبيت التطبيق. أتاحت هذه الآلية إسناد شبكات متعددة حتمية، وتنميط الناشرين عبر التطبيقات، وإعادة الاستهداف الآلي دون الحاجة إلى حالة جلسة في الوقت الفعلي أو نقل معلمات سياقية.

آلية تصفير المعرّفات وقيود المنصة

تطورت بنيات أنظمة تشغيل الجوال لتقييد تتبع الأجهزة عبر التطبيقات بدون موافقة صريحة من المستخدم.

على منصات أפל، تتطلب إرشادات شفافية تتبع التطبيقات من أפל أن تطلب التطبيقات إذن التتبع عبر ATTrackingManager.requestTrackingAuthorization. وعند غياب الإذن، يحجب نظام التشغيل معرّف IDFA. يجب أن تتعامل التطبيقات مع حالات denied (مرفوض) وrestricted (مُقيد) وnotDetermined (غير محدد) بوضوح ودون افتراض إمكانية الوصول إلى معرّف الإعلانات.

وعلى أندرويد، وفقاً لـ وثائق تغييرات سلوك أندرويد 13، قدمت جوجل عناصر تحكم صريحة في الأذونات داخل خدمات Google Play. بالنسبة للتطبيقات التي تستهدف أندرويد 13 (مستوى واجهة برمجة التطبيقات 33) أو أعلى، يجب على المطورين الإعلان عن إذن com.google.android.gms.permission.AD_ID في بيانهم للوصول إلى معرّف الإعلانات. وعند إغفال هذا الإذن، أو عندما يحد المستخدم من تتبع الإعلانات أو يحذف معرّف الإعلانات الخاص به، قد تقيد خدمات Google Play معرّفاً مسفراً (00000000-0000-0000-0000-000000000000) أو تشير إلى أن المعرّف غير متوفر اعتماداً على حالة الجهاز وسلوك خدمات Google Play.

فشل مسارات إسناد الإعلانات الحتمية

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

للحفاظ على قياس الحملات وتتبع التحويل، يجب على الفرق الهندسية الانتقال بعيداً عن الاعتماد على معرّفات الإعلانات. تفصل البنى الحديثة إسناد التثبيت عن معرّفات الأجهزة الدائمة، وتعتمد بدلاً من ذلك على التوجيه السياقي للطرف الأول وأطر القياس المقدمة من المنصة.

في هذه البنية، يُعرض OpoInstall كطبقة لاستعادة سياق التثبيت للطرف الأول / الروابط العميقة المؤجلة بدلاً من أن يكون بديلاً عالمياً لـ Google Play Install Referrer أو AdAttributionKit أو SKAdNetwork أو غيرها من أنظمة إسناد الإعلانات التي تتوسط فيها المنصة.

كيف تؤثر أذونات معرّف إعلانات أندرويد وشفافية تتبع التطبيقات من أפל (ATT) على الإسناد

سياسات إذن AD_ID لمتجر جوجل بلاي على أندرويد 13 والأعلى

يفرض جوجل بلاي حوكمة سياسة تفصيلية لاستخراج معرّفات الإعلانات:

• متطلبات إعلان البيان: يجب أن تعلن التطبيقات التي تستهدف أندرويد 13 (مستوى واجهة برمجة التطبيقات 33) أو أعلى عن <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> في بيانها. في حالة الإغفال، تعود استدعاءات AdvertisingIdClient.getAdvertisingIdInfo(context) بأصفار أو تشير إلى حالة غير متوفرة.

• ضوابط خصوصية المستخدم: عندما يحد المستخدم من تتبع الإعلانات أو يحذف معرّف الإعلانات الخاص به، تعود خدمات Google Play بأصفار أو حالة غير متوفرة. تحظر سياسات مطوري جوجل بلاي صراحةً سد أو إعادة بناء معرّف الإعلانات المُعاد تعيينه باستخدام معرّفات الأجهزة الدائمة الأخرى.

• استثناءات السياسة للتطبيقات الحساسة: تحظر سياسات جوجل بلاي الإعلان عن إذن AD_ID في التطبيقات التي تستهدف الأطفال أو الخاضعة لقيود سياسة العائلة، مما يتطلب من المطورين اعتماد مسارات قياس خالية من المعرّفات.

إطار عمل شفافية تتبع التطبيقات من أפל وحالات الإذن

على نظام آي أو إس (iOS)، يُدار الوصول إلى المعرّفات بواسطة حالة نظام ATTrackingManager.AuthorizationStatus:

• notDetermined (0): لم يستجب المستخدم بعد لطلب إذن ATT. يجب ألا يفترض التطبيق أن الوصول إلى معرّف IDFA متاح.

• restricted (1): الجهاز مقيد بواسطة عناصر تحكم الوالدين أو ملفات تعريف إدارة الجهاز؛ التتبع معطل على مستوى النظام بأكمله.

• denied (2): اختار المستخدم صراحةً «طلب عدم تتبع التطبيق» في المطالبة أو عطل طلبات التتبع بشكل عام في إعدادات خصوصية آي أو إس. يجب ألا يعتمد التطبيق على معرّف IDFA.

• authorized (3): منح المستخدم صراحةً الإذن بالتتبع عبر تطبيقات ومواقع الطرف الثالث، مما يسمح بالوصول إلى معرّف IDFA خاضعاً لسياسات منصة أפל.

بيان الحد المعماري الهام

تمييز هام: إزالة معرّف GAID أو IDFA من بنية الإسناد لا تجعل كل تقنية تتبع بديلة آمنة للخصوصية أو متوافقة مع السياسة تلقائياً. وفقاً لإرشادات إطار عمل شفافية تتبع التطبيقات من أפל، تعرّف أפל التتبع بأنه ربط بيانات المستخدم أو الجهاز التي تم جمعها من تطبيقك ببيانات الطرف الثالث للاستهداف الإعلاني أو القياس، أو مشاركة البيانات مع وسيط بيانات. إذا قام مسار هندسي بجمع خصائص الأجهزة لإعادة بناء هُوية دائمة عبر التطبيقات، فإنه يظل خاضعاً لسياسات تتبع المنصة بغض النظر عما إذا تم الوصول إلى معرّف إعلاني. يجب أن يبقى توجيه المعلمات للطرف الأول مقصوراً على سياق الإعداد الفوري والتحويل لرحلة المستخدم التي بدأها.

ما لا يعنيه الإسناد الخالي من المعرّفات

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

ثلاث مشكلات إسناد يجب عدم الخلط بينها

عند تصميم بنية إسناد للجوال بدون معرّفات إعلانية، يجب على الفرق الهندسية التمييز بين ثلاثة أهداف تشغيلية متميزة:

يمكن لآلية توجيه الطرف الأول حل الروابط العميقة المؤجلة وإسناد الإحالة دون الحاجة إلى معرّف GAID أو IDFA، ولكن ينبغي عدم تقديمها كبديل شامل لإسناد الإعلانات الذي تتوسط فيه المنصة.

متى يجب على فرق النمو نشر طبقة إسناد للطرف الأول؟

يوصى بنشر طبقة إسناد مستقلة للطرف الأول للتطبيقات التي تشغل سير عمل منتجات محددة:

• تطبيقاتSaaS والاشتراكات: منصات الأعمال التجارية (B2B) حيث تبدأ حركة مرور التسويق على سطح المكتب أو الويب للجوال وتتحول إلى حسابات تطبيقات أصلية تتطلب استعادة جلسة مصادق عليها مسبقاً.

• تطبيقات الألعاب: الألعاب متعددة اللاعبين أو الاجتماعية حيث يجب على اللاعبين الجدد الانضمام تلقائياً إلى مباراة المُحيل أو نقابته أو غرفته عند الإطلاق الأول دون رموز غرف يدوية.

• منصات التجارة الإلكترونية: تطبيقات التسوق التي تقدم خصومات ترحيبية مخصصة أو تستعيد حالات عربة التسوق النشطة من حملات ويب الجوال مباشرة إلى عروض الدفع الأصلية.

• منصات الإحالة والولاء: المنتجات التي تقود حلقات فيروسية عضوية تتطلب ربطاً موثوقاً لرمز المُحيل والمُحال دون إجبار المستخدمين على نسخ ولصق سلاسل القسائم.

المخطط المعماري لتوجيه المعلمات للطرف الأول الخالي من المعرّفات

فصل الإسناد عن معرّفات الأجهزة الدائمة

في هذه المقالة، نستخدم توجيه المعلمات السياقية (المعروف أيضاً باسم الإسناد المؤجل للطرف الأول أو استعادة سياق التثبيت) لوصف النقل الخاص بالطرف الأول لسياق الحملة أو الإحالة من خلال رحلة ويب إلى تطبيق بادر بها المستخدم.

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

تنتقل هذه الحمولة عبر مسار التحويل جنباً إلى جنب مع رحلة المستخدم، مما يسمح لتطبيق الجوال باستعادة النية السياقية عند الإطلاق دون الاستعلام عن معرّفات الإعلانات على مستوى النظام.

بنية إسناد ذات طبقتين

تفصل بنية إسناد المؤسسات الروابط العميقة المباشرة عن تدفقات التثبيت التي تتوسط فيها المتاجر:

                User Marketing Interaction
                          │
         ┌────────────────┴────────────────┐
         │                                       │
   Direct App Link                        Store / Ad Flow
         │                                       │
 Universal Links /                  ┌──────┴───────┐
    App Links                       │                           │
         │                       Android                       Apple
         │                   Play Install                   Platform Ad
         │                      Referrer                    Attribution
         │                            │                              │
         └──────────────┬────────┴──────┬───────┘
                                       │                              │
                                         Attribution / Routing Signals
                                                        │
                                             Server-Side Validation
                                                        │
                                    ┌─────────┴─────────┐
                                    │                                      │
                              Context Found                            No Signal
                                   │                                      │
                             Route / Bind                               Organic /
                             First-Party                           Graceful Fallback

الميكانيكا التقنية لتوجيه المعلمات السياقية والخيارات الاحتياطية

دور نقل معلمات الطرف الأول

يعتمد نقل معلمات الطرف الأول على تحليل استعلام الويب القياسي التخزين المؤقت الآمن للجلسة من جانب الخادم. يمكن للمطورين الرجوع إلى وثائق مجموعة تطوير برمجيات OpoInstall SDK للاطلاع على المواصفات التقنية المتعلقة بنماذج ربط المعلمات.

لا يتطلب توجيه معلمات الطرف الأول المستخدم حصرياً للإعداد المباشر إذن ATT بالضرورة عندما لا يفي التنفيذ بتعريف أפל للتتبع؛ يجب على الفرق تقييم تدفق البيانات الفعلي والهدف مقابل سياسات أפל الحالية.

خيارات إسناد التثبيت الخاصة بالمنصة

عند مقاطعة الروابط العميقة المباشرة بواسطة تثبيت المتجر، توفر الوحدات الخاصة بالمنصة بيانات إسناد منظمة:

• أندرويد (Google Play Install Referrer): يكشف دليل واجهة برمجة تطبيقات Google Play Install Referrer عن معلومات المُحيل المرتبطة بتثبيت متجر بلاي ويوفر الطوابع الزمنية للنقر والتثبيت. تحدد وثائق واجهة برمجة التطبيقات نافذة توفر مدتها 90 يوماً لبيانات المُحيل. يجب على التطبيقات الاحتفاظ بهذه القيمة ومعالجتها وفقاً لقواعد الإسناد الخاصة بها ومعالجة إعادة التثبيت بدلاً من التعامل معها كمعرّف تثبيت دائم. لاحظ أنه يجب تمرير المعلمات صراحةً عبر جوجل بلاي؛ ولا تملأ معلمات استعلام صفحة الهبوط الاعتباطية واجهة برمجة التطبيقات هذه تلقائياً.

• إسناد منصة أפל: تتضمن حزمة إسناد تطبيقات أפל الحديثة إطار عمل Apple AdAttributionKit، إلى جانب التشغيل البيني مع SKAdNetwork لسحب سير عمل الإعلانات المدعومة. لا يتطلب AdAttributionKit بحد ذاته مطالبة إذن ATT؛ ومع ذلك، قد تظل تدفقات البيانات الأخرى في نفس التطبيق تشكل تتبعاً وبالتالي تتطلب إذن ATT. يعمل AdAttributionKit ضمن إطار عمل الإعلانات الموقع من أפל مع شبكات الإعلانات المؤهلة المسجلة في أطر إسناد أפל.

لماذا لا يجب أن يكون الإسناد المستند إلى الحافظة استراتيجية أساسية

يجب عموماً التعامل مع نقل الحافظة أو اللصق كآلية احتياطية استثنائية بدلاً من تصميم إسناد أساسي. يُدخل الوصول إلى الحافظة إشعارات خصوصية مرئية للمستخدم، وقيود المنصة، وتوفراً غير متسق عبر إصدارات أنظمة التشغيل. عند تقييم تخزين الحافظة:

• النطاق الصريح: يجب أن تكون الحمولات قصيرة الأجل ومحددة بالحد الأدنى من بيانات التطبيق المحددة المطلوبة لتدفق الطرف الأول المقصود. يجب حماية القيم الحساسة بشكل مناسب أثناء النقل وفي وضع السكون.

• التنظيف الفوري: يجب على التطبيقات مسح أو الكتابة فوق رموز المعلمات المؤقتة فور استهلاكها أثناء تسلسل الإطلاق الأولي.

• الامتثال للسياسة: استخدم آليات الحافظة فقط عندما يوجد تدفق مستخدم محدد بوضوح للطرف الأول وبعد مراجعة سياسة المنصة المعمول بها.

الخيار الاحتياطي السلس والحالات غير المسندة

لا تحاول بنية الخصوصية المرنة فرض مطابقات إسناد من خلال بصمات الأجهزة التداخلية:

• الرابط العميق المباشر / الرابط الشامل: تنشيط التطبيق الأصلي الفوري عندما يكون التطبيق مثبتاً بالفعل على الجهاز.

• تمرير المعلمات عبر المتجر: استرداد معلمات الحملة عبر واجهات برمجة التطبيقات للمنصة (مثل Google Play Install Referrer) عند توفرها.

• استعادة معلمات الطرف الأول: مطابقة جلسات التثبيت الجديدة مع تفاعلات صفحة هبوط الويب النشطة خلال نافذة زمنية ضيقة.

• بلا إشارة (غير مسندة): عندما تتغير ظروف الشبكة، أو تنتهي صلاحية الجلسات، أو لا يوجد سياق متطابق، يتدهور التطبيق بأمان إلى حالة افتراضية نظيفة دون مقاطعة تجربة إعداد المستخدم.

سيناريو تنفيذ توضيحي: استعادة السياق باستخدام OpoInstall

لفهم كيفية عمل هذه الوحدات في الإنتاج، ضع في اعتبارك تطبيق ألعاب جوال متعدد الأساسيات ينفذ قناتي استحواذ متزامنتين:

• القناة أ (إعلانات برمجية مدفوعة): حملة إعلانية تعمل على شبكات إعلانات خارجية تعيد التوجيه إلى متجر التطبيقات (App Store) ومتجر جوجل بلاي (Google Play).

• القناة ب (المشاركة الفيروسية للمستخدمين): اللاعبون الحاليون يشاركون روابط دعوة مخصصة (https://game.example.com/join?room=9876&inviter=usr_432) عبر تطبيقات المراسلة الاجتماعية.

*   

[Channel A: Paid Ad] ──> [Store Download] ──> [Play Referrer / AdAttributionKit] ──> [Aggregated Ad ROI]
[Channel B: Invite]  ──> [Web Landing]    ──> [First-Party Token Restoration]    ──> [Auto-Join Game Room]

عندما يقوم مستخدم جديد بالتثبيت عبر القناة أ، يعتمد التطبيق على واجهة برمجة تطبيقات Google Play Install Referrer أو Apple AdAttributionKit للإبلاغ عن أداء الحملة إلى لوحات معلومات التسويق. وعندما يقوم مستخدم بالتثبيت عبر القناة ب، تلتقط حزمة تطوير برمجيات توجيه الطرف الأول رمز الدعوة الديناميكي عند الإطلاق الأول، مما يؤدي فوراً إلى انضمام اللاعب الجديد إلى الغرفة 9876 دون الاستعلام عن معرّفات الإعلانات أو تشغيل مطالبات ATT.

حالات فشل الإنتاج الشائعة في إسناد الجوال الخالي من المعرّفات

عند نشر بنية إسناد لا تعتمد على معرّفات إعلانات دائمة، تواجه الفرق الهندسية بشكل متكرر أوضاع فشل تشغيلية محددة:

• حالة الفشل 1: فقدان معلمات صفحة الهبوط بعد إعادة توجيه المتجر: إذا أعادت روابط الحملة التوجيه عبر مختصرات عناوين URL وسيطة غير مشفرة، فقد يتم تجريد معلمات الاستعلام مثل channelCode أو referrer قبل الوصول إلى نص برمجي لصفحة الهبوط أو وجهة متجر التطبيقات.

• حالة الفشل 2: استرداد الإحالة المزدوجة وأقفال التماثل المفقودة: في الإنتاج، إذا استدعى عميل الجوال استعادة المعلمات عند كل حدث Activity.onResume أو مقدمة التطبيق دون التحقق من علامة استمرارية محلية، فقد يؤدي المستخدمون إلى تشغيل مطالبات مكافآت مزدوجة أو التنقل المتكرر للروابط العميقة.

• حالة الفشل 3: سوء إدارة حالة إعادة التثبيت: بينما يحتفظ Google Play Install Referrer ببيانات المُحيل التاريخية لمدة تصل إلى 90 يوماً، قد تتلقى التطبيقات المعاد تثبيتها بيانات إسناد قديمة من دورة حياة تثبيت سابقة ما لم يتحقق خادم العميل الخلفي من أن الحساب قد أكمل التسجيل بالفعل.

• حالة الفشل 4: تصنيف التثبيتات العضوية خطأ عبر نوافذ المطابقة الواسعة: إذا تم تكوين نوافذ مطابقة الجلسة من جانب الخادم على نطاق واسع جداً في بيئات بها شبكات مشترك فيها أو كثافة عالية للمستخدمين، فقد تتصادم عمليات التثبيت العضوية مع جلسات نقر الويب غير المرتبطة.

نمط تكامل حزمة تطوير برمجيات توضيحي لاستعادة سياق تثبيت الطرف الأول

نظرة عامة على التكامل من جانب العميل

يمكن استخدام حزمة تطوير برمجيات استعادة سياق التثبيت للطرف الأول لتنفيذ استعادة المعلمات السياقية دون الحاجة إلى معرّف إعلاني. يمكن فرق التطوير تنزيل حزم OpoInstall mobile SDK وموارد التكامل.

ملاحظة واجهة برمجة تطبيقات SDK: دورة حياة التهيئة والاسترداد الموضحة أدناه هي تنفيذ تجريبي توضيحي. أسماء واجهات برمجة التطبيقات أدناه توضيحية عن قصد ولا ينبغي معاملتها كوثائق للموردين. في الإنتاج، يفضل تهيئة مستوى التطبيق الموثقة لـ SDK ودورة حياة سياق التثبيت بدلاً من ربط استرداد الإسناد مباشرة بدورة حياة نشاط فردي. تحقق من جميع الفئات، وأسماء الطرق، وأنواع رد الاتصال، ومفاتيح التكوين مقابل الوثائق الحالية للمورد قبل الاستخدام في الإنتاج.

// Android Implementation: ID-Free Parameter Extraction (Architecture Pattern)
// Location in Part A: [CODE_BLOCK_01]
// Note: Illustrative pseudo implementation based on OpoInstall SDK contracts.

// ----------------------------------------------------------------------------
// 1. AndroidManifest.xml (Sample excerpt)
// ----------------------------------------------------------------------------
/*
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp">
    <uses-permission android:name="android.permission.INTERNET"/>
    <application android:name=".CustomApplication" android:label="@string/app_name">
        <!-- Configure the application key using the method specified in vendor documentation -->
        <meta-data android:name="com.opoinstall.APP_KEY" android:value="YOUR_APPKEY"/>
    </application>
</manifest>
*/

// ----------------------------------------------------------------------------
// 2. CustomApplication.kt: Application-Level State-Machine Lifecycle
// ----------------------------------------------------------------------------
package com.example.myapp

import android.app.Application
import android.util.Log
import com.opoinstall.api.OpoData
import com.opoinstall.api.OpoError
import com.opoinstall.api.OpoInstall
import com.opoinstall.api.ResultCallBack

class CustomApplication : Application() {

    enum class AttributionState {
        NOT_STARTED,
        FETCHING,
        PROCESSED
    }

    override fun onCreate() {
        super.onCreate()
        
        // Initialize the first-party routing SDK in the main process
        OpoInstall.initialize(this)

        // Retrieve install context once at the application layer
        if (getAttributionState() == AttributionState.NOT_STARTED) {
            fetchInstallContext()
        }
    }

    private fun fetchInstallContext() {
        setAttributionState(AttributionState.FETCHING)

        OpoInstall.getInstance().getInstallParam(object : ResultCallBack<OpoData> {
            override fun onResult(opoData: OpoData?) {
                setAttributionState(AttributionState.PROCESSED)
                if (opoData != null) {
                    val channelCode = opoData.channelCode
                    val customData = opoData.data
                    Log.d("InstallContext", "Restored context: Channel=$channelCode, Data=$customData")
                    handleInstallContext(channelCode, customData)
                }
            }

            override fun onError(opoError: OpoError?) {
                // If a temporary network failure occurs, state can remain retryable or fallback cleanly
                Log.w("InstallContext", "Attribution query completed with status: ${opoError?.errorMsg}")
                setAttributionState(AttributionState.PROCESSED)
            }
        })
    }

    private fun getAttributionState(): AttributionState {
        val raw = getSharedPreferences("attribution_prefs", MODE_PRIVATE)
            .getString("state", AttributionState.NOT_STARTED.name)
        return AttributionState.valueOf(raw ?: AttributionState.NOT_STARTED.name)
    }

    private fun setAttributionState(state: AttributionState) {
        getSharedPreferences("attribution_prefs", MODE_PRIVATE)
            .edit()
            .putString("state", state.name)
            .apply()
    }

    private fun handleInstallContext(channelCode: String?, customData: String?) {
        // Dispatch restored context to internal account/routing services
    }
}

تكامل آي أو إس: تكامل دورة حياة سويفت (Swift)

على نظام آي أو إس، يدمج التطبيق مجموعة تطوير برمجيات داخل مفوض دورة حياة التطبيق. تسترد مجموعة تطوير برمجيات معلمات التثبيت غير المتزامنة على خيط التنفيذ الرئيسي دون استدعاء طلبات إذن AppTrackingTransparency عند عدم إجراء تتبع عبر التطبيقات.

يوضح تنفيذ سويفت أدناه تدفق التهيئة والاستخراج التجريبي للمعلمات:

// iOS Integration Pattern: Application-Level Install Context Retrieval
// Location in Part A: [CODE_BLOCK_02]
// Note: PSEUDOCODE ONLY. Type and method names are illustrative placeholders.

// ----------------------------------------------------------------------------
// 1. Info.plist (Sample excerpt)
// ----------------------------------------------------------------------------
/*
<!-- Configure the application key using the method specified in vendor documentation -->
<key>com.opoinstall.APP_KEY</key>
<string>YOUR_APPKEY</string>
*/

// ----------------------------------------------------------------------------
// 2. AppDelegate.swift: Lifecycle Initialization and Context Retrieval
// ----------------------------------------------------------------------------
import UIKit
// Note: SDK module import omitted intentionally; use the module name supplied by your package manager.

enum InstallContextState: String {
    case notStarted = "NOT_STARTED"
    case fetching = "FETCHING"
    case processed = "PROCESSED"
}

@main
class AppDelegate: UIResponder, UIApplicationDelegate, OpoInstallDelegate {

    var window: UIWindow?

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        
        // Initialize the first-party routing SDK without invoking ATT authorization
        OpoInstallSDK.initWith(self)

        // Guard retrieval with state-machine check at the application entry point
        if getInstallContextState() == .notStarted {
            fetchInstallContext()
        }

        return true
    }

    private func fetchInstallContext() {
        setInstallContextState(.fetching)

        // Retrieve deferred install parameters asynchronously
        OpoInstallSDK.defaultManager()?.getInstallParmsCompleted({ [weak self] (appData: OpoinstallData?) in
            DispatchQueue.main.async {
                self?.setInstallContextState(.processed)

                if let data = appData?.data {
                    let channel = appData?.channelCode
                    self?.handleInstallContext(channelCode: channel, customData: data)
                }
            }
        })
    }

    private func getInstallContextState() -> InstallContextState {
        let raw = UserDefaults.standard.string(forKey: "install_context_state") ?? InstallContextState.notStarted.rawValue
        return InstallContextState(rawValue: raw) ?? .notStarted
    }

    private func setInstallContextState(_ state: InstallContextState) {
        UserDefaults.standard.set(state.rawValue, forKey: "install_context_state")
    }

    private func handleInstallContext(channelCode: String?, customData: String) {
        // Dispatch restored context to internal account/routing services
    }

    // Universal Link delegate callback for deep linking
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
    ) -> Bool {
        OpoInstallSDK.continue(userActivity)
        return true
    }
}

اعتبارات هندسية لتنفيذ العميل

• دورات حياة واجهة المستخدم غير المانعة: قم دائماً بتهيئة حزم تطوير برمجيات الإسناد بشكل غير متزامن والاستعلام عن المعلمات دون منع خيط واجهة المستخدم الرئيسي أثناء إطلاق التطبيق.

• معالجة التماثل المحلي: حافظ على آلة حالة أو علامة مستمرة (مثل NOT_STARTED وFETCHING وPROCESSED) لإدارة استخراج المعلمات بوضوح ومنع استعلامات واجهة برمجة التطبيقات الزائدة.

• الدفاع ضد إعادة تشغيل الخادم: تحقق من حمولات المعلمات الديناميكية مقابل سجلات معاملات الخادم الخلفي لضمان عدم إمكانية إعادة تشغيل رموز الإحالة أو الرموز الترويجية بشكل خبيث.

واجهات برمجة تطبيقات إسناد المنصة وانتقال صندوق حماية الخصوصية

إسناد منصة أندرويد وانتقال صندوق حماية الخصوصية

تم تصميم واجهات برمجة تطبيقات إسناد أندرويد لدعم القياس الذي يحافظ على الخصوصية عبر التطبيقات والويب دون الاعتماد على معرّفات الأطراف الأخرى.

واجهات برمجة تطبيقات إسناد أندرويد متاحة لتكاملات صندوق حماية الخصوصية المدعومة، ولكنها ليست بديلاً شاملاً لـ Install Referrer أو تكامل MMP. يعتمد قابلية تطبيق الإنتاج على إصدار أندرويد المحدد، وتكامل تكنولوجيا الإعلانات، ومتطلبات التسجيل، ودعم النظام البيئي. يجب على الفرق التحقق من وثائق صندوق حماية الخصوصية لأندرويد الحالية قبل جعل إسناد التقارير تبعية إنتاج.

بالنسبة لتطبيقات أندرويد المُوزّعة عبر متجر بلاي، يظل Google Play Install Referrer آلية عملية للطرف الأول لاستعادة معلمات الحملة المرتبطة بتثبيت متجر بلاي. قد توفر شبكات الإعلانات ومقدمو الإسناد أيضاً تكاملات قياس مدعومة من المنصة.

إسناد منصة أפל: AdAttributionKit وSKAdNetwork

على نظام آي أو إس، توفر أפל آليات إسناد تحافظ على الخصوصية متركزة على AdAttributionKit، والتي تدعم حملات إعلانات التطبيقات عبر متجر التطبيقات والأسواق البديلة، إلى جانب التشغيل البيني مع SKAdNetwork. توفر هذه الأطر إشارات إسناد تتوسط فيها المنصة دون الكشف عن معرّف إعلاني دائم للجهاز. تظل دقة التقارير وتوقيتها خاضعة لعتبات خصوصية أפל ونوافذ الإسناد.

تعايش توجيه الطرف الأول واجهات برمجة تطبيقات المنصة

تحل واجهات برمجة تطبيقات خصوصية المنصة والتوجيه السياقي للطرف الأول متطلبات هندسية مختلفة:

• واجهات برمجة تطبيقات خصوصية المنصة: مصممة لقياس الإعلانات على نطاق واسع، وحساب عائد الاستثمار لشبكة الإعلانات، وتحسين الحملات البرمجية بدون معرّفات دائمة.

• توجيه معلمات الطرف الأول: مصمم للإعداد المصغر للتطبيقات، والربط الفوري لمكافآت إحالة المستخدمين للمستخدمين، وتوجيه الروابط العميقة، ورحلات التحويل المباشرة من الويب إلى التطبيق.

كيفية التحقق من دقة الإسناد في بيئات الحماية (Sandbox)

اختبار إسناد التثبيت عندما يكون الوصول إلى معرّف الإعلانات غير متوفر

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

• حالة AD_ID المفقودة: انشر نسخة اختبار لأندرويد تستبعد إذن com.google.android.gms.permission.AD_ID من AndroidManifest.xml وتأكد من أن التطبيق يتم تهيئته بشكل نظيف.

• قيود معرّف المستخدم: على جهاز اختبار أندرويد به خدمات Google Play، قم بتمكين قيود الإعلانات أو حذف معرّف الإعلانات في إعدادات النظام لضمان عدم تعطل استخراج المعلمات أو توقفه.

• محاكاة حملة متجر بلاي: قم بتشغيل رحلة تثبيت باستخدام عنوان URL لحملة اختبار يمرر صراحةً القيمة المتوقعة من خلال آلية Google Play Install Referrer. لا تفترض أن معلمة استعلام صفحة هبوط اعتباطية ستصبح تلقائياً قيمة Install Referrer.

• تحقق إعادة التثبيت: قم بإعادة تثبيت التطبيق بعد تثبيت مسند سابق وتأكد من أن تدفق الإسناد لا يعيد استخدام حالة التثبيت الأول القديمة بشكل خاطئ.

• التحقق من الخيار الاحتياطي العضوي: أطلق نسخة غير مرتبطة للتأكد من أن getInstallParam يتم حله بشكل نظيف إلى قيمة فارغة أو خيار احتياطي عضوي دون تعليق.

محاكاة حالات ATT المرفوضة على أجهزة آي أو إس الفعلية

لاختبار استخراج معلمات آي أو إس عندما يتم رفض التتبع:

• ثبت نسخة الاختبار على جهاز آي أو إس فعلي عبر Xcode.

• تأكد من أن طريقة استخراج معلمات SDK تنفذ بشكل غير متزامن وتحل المعلمات بنجاح دون مطالبات ATT أو الاستعلام عن واجهات برمجة تطبيقات IDFA.

• اختبر سلوكيات إطلاق التطبيق عبر دورات حياة البدء البارد وإيقاظ الخلفية.

تدقيق حزم شبكة لتقليل البيانات

يجب على فرق الأمان والامتثال فحص حركة مرور شبكة العميل باستخدام وكيل HTTP:

• تأكيد استبعاد المعرّف: تحقق من أن طلبات الإسناد الصادرة لا تتضمن معرّفات دائمة مثل IMEI، أو عناوين MAC، أو معرّف أندرويد (SSAID)، أو سلاسل IDFA غير المرخصة.

• أمان النقل: تأكد من أن الاتصال بواجهة برمجة تطبيقات الإسناد يستخدم HTTPS مع تكوينات TLS الحالية والتحقق القياسي من الشهادات.

• حماية الحمولة: تأكد من أن الرموز الديناميكية المخزنة أثناء النقل أو المخازن المؤقتة تستخدم معايير الحماية المناسبة.

بنية إسناد خالية من المعرّفات باستخدام OpoInstall

تتطلب الفرق الهندسية التي تقيم مجموعة نمو مستقلة عن معرّفات الإعلانات ثلاث قدرات تقنية أساسية:

1. استعادة السياق السلس: تمرير البيانات التعريفية المخصصة من صفحات هبوط الويب إلى التطبيقات الأصلية بدون رموز إحالة يدوية أو جمع معرفات الأجهزة.

2. إدارة سياق الحملات عبر الأساسيات: إدارة حملات الويب إلى التطبيق والجوال عبر المنصات دون الحاجة إلى تصميمات تطبيقات متعددة.

3. الامتثال الصارم للمنصة: العمل بالكامل داخل أضخم تطبيقات الطرف الأول واحترام قيود خصوصية نظام التشغيل.

لاكتشاف أنماط التنفيذ لقياس الجوال والتوجيه، ارجع إلى وثائق OpoInstall أو قم بالوصول إلى وحدة تحكم مطوري OpoInstall.

الملخص ومسودة القرار

لبناء بنيات نمو مستدامة للجوال وسط القيود المتزايدة لمعرّفات الإعلانات، يجب على الفرق الهندسية الانتقال بعيداً عن اعتماديات GAID وIDFA القديمة. يؤدي الاعتماد على معرّفات الأجهزة الدائمة إلى هشاشة هيكلية مع استمرار أنظمة التشغيل والسياسات التنظيمية في تقييد التتبع عبر التطبيقات.

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

المواد ذات الصلة

• المفاهيم: قيود معرّفات الإعلانات، توجيه المعلمات السياقية، Install Referrer، AdAttributionKit، شفافية تتبع التطبيقات

• التقنيات: واجهة برمجة تطبيقات Google Play Install Referrer، واجهة برمجة تطبيقات الإعلانات لخدمات Google Play، إطار عمل ATT من أפל، Apple AdAttributionKit، حزمة تطوير برمجيات OpoInstall للجوال

• مواضيع الأمان: تقليل بيانات الجوال، الحماية ضد إعادة التشغيل، أمان النقل

• واجهات برمجة التطبيقات: واجهة برمجة تطبيقات Google Play Install Referrer، واجهات برمجة تطبيقات معرّف إعلانات جوجل، واجهات برمجة تطبيقات شفافية تتبع التطبيقات من أפל، واجهات برمجة تطبيقات معلمات تثبيت OpoInstall

الوثائق الرسمية

أندرويد

• وثائق معرّف إعلانات خدمات Google Play

• تغييرات سلوك أندرويد 13 لمعرّف الإعلانات

• دليل واجهة برمجة تطبيقات Google Play Install Referrer

أפל

• وثائق مطوري أפל حول شفافية تتبع التطبيقات

• وثائق مطوري أפל حول AdAttributionKit

• وثائق مطوري أפל حول إسناد الإعلانات

• فهم التشغيل البيني بين AdAttributionKit وSKAdNetwork

الإسناد الذي يحافظ على الخصوصية

• نظرة عامة على صندوق حماية الخصوصية من جوجل