يقدّم هذا المستند نظرة عامة حول كيفية قياس الحملات ومصادر الزيارات باستخدام الإصدار الثاني من حزمة SDK من "إحصاءات Google" لنظام التشغيل Android.
نظرة عامة
يمكن أن يساعدك قياس الحملات في "إحصاءات Google" على تحسين قيمة قنواتك التسويقية من خلال تفعيل إحالة الحملات ومصادر الزيارات إلى نشاط المستخدم داخل تطبيقك.
تتوفّر عدّة أنواع لقياس أداء الحملات في حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android:
- قياس حملات Google Play: يمكنك التعرّف على الحملات والمواقع الإلكترونية والتطبيقات التي أحالت المستخدم إلى صفحة تطبيقك على "متجر Google Play" لتنزيل تطبيقك.
- قياس الحملات العامة - يمكنك الاطّلاع على الحملات أو مصادر الزيارات التي أطلقت تطبيقك الذي تم تثبيته.
- قياس الإحالات: يمكنك الاطّلاع على مصدر الزيارات المُحيلة، مثل المواقع الإلكترونية أو التطبيقات الأخرى، التي شغَّلت تطبيقك بعد تثبيته.
ستوضّح الأقسام التالية وقت تنفيذ كل نوع من أنواع قياس الحملات في تطبيقك وكيفية تنفيذه.
قياس أداء الحملات على Google Play
يتيح لك قياس حملات Google Play معرفة الحملات ومصادر الزيارات التي ترسل المستخدمين لتنزيل تطبيقك من "متجر Google Play". ننصح جميع المطوّرين بتنفيذ عملية قياس أداء الحملات على "متجر Google Play"
طريقة عمل قياس الحملات على Google Play
يعتمد قياس حملات متجر Google Play على استخدام مَعلمات الحملة لتمرير معلومات مصادر الزيارات والحملات إلى تطبيقك في وقت تنزيلها من متجر Google Play.
في ما يلي وصف شامل لطريقة عمل "قياس الحملات على Google Play":
- ينقر المستخدِم على رابط من إعلان أو موقع إلكتروني أو تطبيق لنقله إلى صفحة تطبيقك على "متجر Google Play". تم وضع علامة على الرابط باستخدام مَعلمات الحملة.
- بعد أن ينزِّل المستخدم تطبيقك ويثبّته، سيبث "متجر Google Play"
هدف
INSTALL_REFERRER
على الجهاز الذي يتضمّن مَعلمات الحملة نفسها. - سيستجيب تطبيقك بعد ذلك لهذا الغرض باستخدام العنصر
BroadcastReceiver
المقدّم أدناه، وسيقرأ معلَمات الحملة ويستخدمها لتعديل معلومات الحملة على "إحصاءات Google".
يُعد تنفيذ عملية قياس الحملات في Google Play
لتنفيذ عملية قياس أداء الحملات على "متجر Google Play"، اتّبِع الخطوات التالية:
1. إضافة BroadcastSubmitr جديد إلى ملف AndroidManifest.xml
تسمح سياسة "BroadcastReceiver
" التالية لتطبيقك بالاستجابة
لبث غرض INSTALL_REFERRER
الذي يُجريه متجر Google Play عند تثبيت تطبيقك. قم بإضافتها إلى ملف AndroidManifest.xml
على النحو التالي:
<!-- Used for install referral measurement--> <service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
2. إضافة مَعلمات الحملة إلى روابط "متجر Google Play"
يتمّ استخدام مَعلمات الحملة لتمرير معلومات عن الحملة أو مصدر الزيارات الذي أحال المستخدِم إلى صفحة تطبيقك على "متجر Google Play" إلى عملية تنفيذ "إحصاءات Google" في تطبيقك.
لمعرفة كيفية إنشاء سلسلة مَعلمة حملة، استخدِم أداة إنشاء عناوين URL على Google Play، أو راجِع قسم مرجع مَعلمات الحملة.
بعد إنشاء سلسلة مَعلمة حملتك، أضِفها إلى عناوين URL في "متجر Google Play" كقيمة للمَعلمة referrer
، كما في المثال التالي:
https://play.google.com/store/apps/details?id=com.example.app &referrer=utm_source%3Dgoogle %26utm_medium%3Dcpc %26utm_term%3Drunning%252Bshoes %26utm_content%3DdisplayAd1 %26utm_campaign%3Dshoe%252Bcampaign
سيمرِّر متجر Google Play قيمة المعلَمة referrer
فقط إلى تنفيذ "إحصاءات Google" في تطبيقك، لذا من المهم
التأكّد من توفّرها في روابط "متجر Google Play".
قياس الحملات العامة
يمكن استخدام القياس العام للحملات لربط حملة أو مصدر زيارات بمستخدم بعد تثبيت تطبيقك مسبقًا.
على سبيل المثال، إذا كنت تُطلق حملة مدفوعة للوصول إلى المستخدمين الحاليين الذين ثبّتوا تطبيقك من قبل، يمكنك استخدام قياس عام للحملات لقياس عمليات إطلاق التطبيقات التي حدثت نتيجة تلك الحملة.
تنفيذ القياس العام للحملة
لضبط قيم حملة لحملة عامة، استدعِ
setCampaign()
ومرِّر سلسلة مَعلمة
الحملة كوسيطة.
قد يستدعي التنفيذ النموذجي setCampaign()
عند إطلاق التطبيق، ويتحقّق من الغرض الذي أطلقه لمعرفة ما إذا كانت هناك معلمات صالحة للحملة:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before calling activityStart(). EasyTracker.getInstance().setContext(this); if (intent.getData() != null) { EasyTracker.getTracker().setCampaign(uri.getPath()); } ... // The rest of your onCreate() code. } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
قياس الإحالات
يشبه قياس الإحالة الأنواع الأخرى لقياس الحملات من حيث أنّه يسمح لك بقياس مصدر الإحالة الذي أطلق تطبيقك على جهاز المستخدِم. مع ذلك، يستخدم قياس الإحالات الناجحة سلسلة بسيطة مثل "google.com" أو "myOtherApp"، بدلاً من سلسلة من مَعلمات الحملة.
عند ضبط مصدر إحالة، مثل "google.com"، يتم ضبط سمة المصدر على "google.com"، في حين يتم ضبط سمة الوسيط ضمنيًا على "المُحيل"
كما هو الحال في قياس أداء الحملات، يؤدي تحديد مصدر إحالة تلقائيًا إلى بدء جلسة جديدة من خلال مكالمة الإرسال التالية.
في مقتطف الرمز التالي، نفترض أنّك وضعت علامات على أي روابط من شأنها أن تفتح تطبيقك باستخدام مَعلمات حملات "إحصاءات Google"، أو باستخدام مَعلمة referrer
بسيطة تصف مصدر الإحالة. في حال توفّر المَعلمة referrer
في حال عدم توفّر مَعلمات حملة أخرى، يتم تعديل معلومات حملة المستخدِم باستخدام مصدر إحالة جديد:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before activityStart() is called. EasyTracker.getInstance().setContext(this); if (uri != null) { if(uri.getQueryParmeter("utm_source") != null) { // Use campaign parameters if avaialble. EasyTracker.getTracker().setCampaign(uri.getPath()); } else if (uri.getQueryParameter("referrer") != null) { // Otherwise, try to find a referrer parameter. EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer")); } } } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
المشاكل المعروفة
- يستخدم javadoc
CampaignTrackingReceiver
مسار فئة غير صحيح في مثال استخدامه. اطّلِع على تنفيذ قياس الحملات على Google Play لمعرفة الاستخدام الصحيح. - يمكن تحديد فئة
BroadcastReceiver
واحدة فقط لكل تطبيق. وإذا كنت بحاجة إلى دمج فئتَين أو أكثر منBroadcastReceivers
من حِزم تطوير برامج (SDK) مختلفة، عليك إنشاء صفBroadcastReceiver
خاص بك يتم من خلاله تلقّي جميع عمليات البث وطلبBroadcastReceivers
المناسب لكل نوع من أنواع البث. - لا يتيح قياس حملات Google Play حاليًا عمليات التثبيت من الويب إلى الجهاز التي تبدأ من "متجر Play" الإلكتروني.
مَعلمات الحملة
يتم استخدام مَعلمات الحملات لتمرير معلومات عن مصادر الزيارات والحملات التي تجذب المستخدمين إلى تطبيقك.
- بوجهٍ عام، يتم تمرير سلسلة مَعلمة الحملة غير المرمّزة كوسيطة إلى
setCampaign()
. - في أداة "قياس الحملات على Google Play"، يتم إلحاق مَعلمة
referrer
مع سلسلة مَعلمة حملة مرمّزة كقيمتها، بأي عناوين URL تشير إلى صفحة تطبيقك على "متجر Play".
في ما يلي مثال على سلسلة حملة صالحة وغير مرمّزة يمكن استخدامها لقياس عام للحملة:
"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"
يوضّح الجدول أدناه قائمة كاملة بمَعلمات الحملات المتوفّرة التي يمكن استخدامها في Google Play أو القياس العام للحملات.
المَعلمة | الوصف | أمثلة |
---|---|---|
utm_campaign |
اسم الحملة الذي يُستخدم لتحليل الكلمات الرئيسية لتحديد ترويج منتج معيّن أو حملة استراتيجية معيّنة | utm_campaign=spring_sale |
utm_source |
مصدر الحملة: يُستخدم لتحديد محرك بحث أو نشرة إخبارية أو مصدر آخر | utm_source=google |
utm_medium |
وسيط الحملة؛ يُستخدم لتحديد وسيط مثل البريد الإلكتروني أو تكلفة النقرة (CPC) | utm_medium=cpc |
utm_term |
عبارة الحملة؛ تُستخدم مع نتائج البحث المدفوعة لتوفير الكلمات الرئيسية للإعلانات | utm_term=running+shoes |
utm_content |
محتوى الحملة؛ يُستخدم لاختبار A/B والإعلانات التي تستهدف المحتوى للتمييز بين الإعلانات أو الروابط التي تشير إلى عنوان URL نفسه. |
utm_content=logolink
utm_content=textlink
|
gclid |
معلَمة وضع العلامات التلقائي في "إعلانات Google"، تُستخدم لقياس "إعلانات Google". يتم إنشاء هذه القيمة ديناميكيًا ويجب عدم تعديلها مطلقًا. |
أداة إنشاء عناوين URL في Google Play
استخدِم أداة إنشاء عناوين URL على Google Play لإنشاء عناوين URL لقياس الحملات على Google Play.