الخطوة 1: تسجيل عمليات تسجيل الإحالات الناجحة على SKAdNetwork لإصدارات نظام التشغيل iOS ذات الصلة
اطّلِع على مستندات Apple لمزيد من المعلومات. بالنسبة إلى العملاء الذين يستخدِمون حزمة تطوير برامج (SDK) "إحصاءات Google لبرنامج Firebase"، تسجِّل حزمة تطوير البرامج (SDK) هذه العمليات تلقائيًا بالنيابة عن التطبيق، ويمكنك تخطّي هذه الخطوة.
الخطوة 2: التأكّد من تلقّي عمليات تسجيل الإحالات الناجحة على SKAdNetwork وفك ترميزها
اطّلِع على مستندات Apple لمزيد من المعلومات. في حال لم تكن أعددت نقطة نهاية SKAdNetwork، عليك إجراء ذلك باتّباع التعليمات الواردة في مستندات Apple.
إذا سبق لك إعداد نقطة نهاية باستخدام شريك إحالة تطبيقات معتمَد من Google أو حلّ تابع لشركتك، يمكنك التخطّي إلى الخطوة 3 التي سترشدك خلال خطوات عملية توجيه النتائج إلى "إحصاءات Google" باستخدام Measurement Protocol.
الخطوة 3: توجيه نتائج تسجيل الإحالات الناجحة إلى "إحصاءات Google" باستخدام Measurement Protocol
يتم ذلك عن طريق إرسال حدث مخصّص من نوع campaign_details إلى "إحصاءات Google" من خلال Measurement Protocol باستخدام المخطّط التالي (مثال على درس تطبيقي حول الترميز).
تنفيذ Measurement Protocol بشأن SKAdNetwork في "إحصاءات Google 4"
المَعلمات على مستوى الطلب
| المَعلمة | مزيد من المعلومات |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
|
| app_instance_id: {...} |
مَعلمة مطلوبة. عليك إنشاء سلسلة فريدة من الأرقام العشوائية. سيتم تجاهل سلسلة رقم التعريف هذه لأرقام تعريف مثيل التطبيق بعد استخدام هذه البيانات في وضع النماذج للإحالات الناجحة. |
حدث "إحصاءات Google"
| الحدث | مزيد من المعلومات |
| campaign_details | حدث مخصّص. |
مَعلمات "إحصاءات Google" (الحالية)
| المَعلمة | مزيد من المعلومات |
| source: {source} |
هذه هي المَعلمات التي يتم استخدامها في عملية وضع العلامات يدويًّا. يتم تنظيم إعداد تقارير "إحصاءات Google 4" باستخدام التصنيفات التلقائية للقنوات إلى مجموعات في "إحصاءات Google 4". وننصح باستخدامها كدليل لتصنيف كلّ مَعلمة. عليك إرسال هذه المَعلمات لجميع عمليات تسجيل الإحالات الناجحة التي لا تتبع Google. على سبيل المثال: تسجيل الإحالات الناجحة على Facebook:
بالنسبة إلى عمليات تسجيل الإحالات الناجحة على Google، سيتم فك ترميز الحملات استنادًا إلى دمج موقعك مع "إعلانات Google". ومن ثمّ، تكون المَعلمات الواردة أعلاه اختيارية لعمليات تسجيل الإحالات الناجحة على Google. يجب التأكّد من أنّ موقعك على "إحصاءات Google 4" مرتبط بحساباتك الإعلانية على "إعلانات Google". ملاحظة: من المهم إرسال جميع عمليات تسجيل الإحالات الناجحة على SKAdNetwork، وليس فقط عمليات تسجيل الإحالات الناجحة التي لا تتبع Google، إلى "إحصاءات Google 4". |
| medium: {medium} | |
| term: {term} اختيارية | |
| content: {content} اختيارية | |
| campaign_id: {campaign_id} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. |
| campaign: {campaign} اختيارية ولكن في حال عدم توفيرها، ستظهر القيمة على أنّها (not set) |
بالنسبة إلى الحملات على "إعلانات Google"، سيتم فك ترميز رقم التعريف وتقديم اسم الحملة استنادًا إلى رابط حسابَيك على "إحصاءات Google" و"إعلانات Google" وتعديل مَعلمتَي source وmedium. وفي حال عدم ربط الحسابَين، لن نفكّ ترميز أرقام تعريف حملات Google وسنستخدِم مَعلمتَي source وmedium المحدّدتَين. بالنسبة إلى الحملات التي لا تتبع "إعلانات Google"، يمكنك فك ترميز أسماء الحملات وتقديمها. وإذا كنت لا تعرفها، يمكنك نسخ المَعلمة campaign_id لحملتك على SKAdNetwork. ملاحظة: إذا لم يتم توفير هذه المَعلمة، ستظهر القيمة على أنّها (not set). |
| source_platform: "apple_skan" | ملاحظة مهمّة: عليك تحديد هذه السلسلة بالضبط، مع مراعاة الكتابة بالأحرف اللاتينية الكبيرة والشَرطات السفلية (_). |
| app_id: {app_id} |
القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. وستكون هذه القيمة هي رقم تعريف حِزمة التطبيق. |
| transaction_id: {transaction_id} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. |
المَعلمات الجديدة المطلوبة
ملاحظة: يمكن إعداد هذه المَعلمات الجديدة في واجهة مستخدِم "إحصاءات Google 4"، إلا أنّها ليست مطلوبة. إذا كنت تريد الاطّلاع على تقارير سمات مخصّصة معيّنة استنادًا إلى هذه المَعلمات، يجب أن تكون مسجَّلة في "إحصاءات Google 4".
| المَعلمة | مزيد من المعلومات |
| version: {version} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork |
| conversion_value: {conversion_value} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork |
| fidelity_type: {fidelity_type} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. |
| attribution_signature: {attribution_signature} |
القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. ملاحظة: تمثّل هذه ميزة أمان، وتكون عمليات تسجيل الإحالات الناجحة على SKAdNetwork مُوقّعَة بطريقة مشفّرة. |
| redownload: {redownload} | القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. |
| source_app_id: {source_app_id} |
القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. ملاحظة: هذه القيمة هي رقم تعريف التطبيق الذي تم النقر فيه على الإعلان الذي أدّى إلى عملية التثبيت. |
| did_win: {did_win} |
القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. ملاحظة: لا يتلقّى المعلِنون سوى عمليات تسجيل الإحالات الناجحة الفائزة. وتتلقّى تكنولوجيات الإعلان عمليات تسجيل الإحالات الناجحة الفائزة وكذلك عمليات تسجيل الإحالات الناجحة التي حلّت في المركز الثاني/الإحالات الناجحة الناتجة عن نقرة أو مرّة ظهور داعمة.
|
|
ad_network_id: {ad_network_id} تمثّل {ad_network_id} القيمة الواردة في عملية تسجيل الإحالات الناجحة. |
القيمة المستمَدة من عملية تسجيل الإحالات الناجحة على SKAdNetwork. يوضِّح ذلك شبكة الإعلانات التي ظهر عليها إعلانك. وستكون هذه معلومات مفيدة أيضًا لسمة الزيارات "المصدر". |
الخطوة 4: التأكّد من أنّه يتم تلقّي نتائج منصّة التسويق
إنّ أحداث campaign_details لا تظهر مباشرةً في "إحصاءات Google". وبدلاً من ذلك، يتم تحويل عمليات تسجيل الإحالات الناجحة على SKAdNetwork إلى أحداث ويتم دمجها في الأحداث الرئيسية من نوع first_open وإعداد تقارير الأحداث. ويمكن تقسيمها عن طريق إضافة السمة "منصّة المصدر" (منصّة المصدر = SKAN).
إذا كنت تريد التأكّد من أنّه يجري إرسال النتائج، ننصحك بتسجيل الأحداث الاختبارية من خلال تكرار أحداث campaign_details باستخدام اسم حدث مختلف (مثل campaign_details_skan_test). ويمكنك بعد ذلك التأكّد من ظهور الأحداث الاختبارية في تقرير الوقت الفعلي على "إحصاءات Google 4". في حال سجَّلت الحدث الاختباري والمَعلمات، ستظهر البيانات في التقارير المخصّصة بالإضافة إلى تقرير الوقت الفعلي.
- إذا كنت تريد عرض جميع عمليات تسجيل الإحالات الناجحة على SKAdNetwork في التقارير، بالإضافة إلى إرسال كلّ منها كحدث
campaign.details، عليك تسجيل الحدث والمَعلمات المكرّرة على النحو المذكور أعلاه. وإذا اختَرت إجراء ذلك، يجب إرسال عمليات تسجيل الإحالات الناجحة على SKAdNetwork باستخدام الحدثcampaign.details. وإلا لن تتعرَّف "إحصاءات Google" على تلك الإحالات الناجحة ولن تتمكّن من وضع نماذج للإحالات الناجحة من أجل تحسين إعداد تقاريرfirst_openعلى نظام التشغيل iOS. - يجب إرسال عمليات تسجيل الإحالات الناجحة على SKAdNetwork خلال 4 أيام من تلقّيها حتى تتمكّن "إحصاءات Google" من الاستفادة منها في عملية وضع النماذج للإحالات الناجحة وإعداد التقارير ذات الصلة.
اطّلِع على مزيد من المعلومات عن الخطوات العامة للتأكّد من صحة عملية التنفيذ.