قياس أداء الحملات - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS

يقدّم هذا المستند نظرة عامة حول كيفية قياس الحملات ومصادر الزيارات باستخدام الإصدار الثالث من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS.

نظرة عامة

يسمح قياس الحملات في "إحصاءات Google" بإسناد الحملات ومصادر الزيارات إلى نشاط المستخدم داخل تطبيقك. تتوفّر هذه الخيارات لتحديد مصدر الزيارات ومصادر الزيارات في حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS:

قياس حملات عمليات التثبيت في iOS: يمكنك الاطّلاع على الحملات من التطبيقات الأخرى التي تحيل المستخدمين إلى iTunes لتنزيل تطبيقك المتوافق مع iOS.
تحديد مصدر الزيارات والحملة العامة - يمكنك الاطّلاع على الحملات أو المُحيلين الذين يطلقون تطبيقك بعد تثبيته.

ستوضّح الأقسام التالية وقت تنفيذ كل نوع من أنواع قياس الحملات في تطبيقك وكيفية تنفيذه.

معلمات الحملات

يتم استخدام مَعلمات الحملات لتمرير معلومات عن مصادر الزيارات والحملات التي تجذب المستخدمين إلى تطبيقك.

يحتوي الجدول أدناه على معلمات الحملة المتاحة التي يمكن استخدامها في القياس العام للحملات:

المَعلمة	الوصف	أمثلة
`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"، تُستخدم لقياس الإعلانات. يتم إنشاء هذه القيمة ديناميكيًا ويجب عدم تعديلها مطلقًا.

تحديد مصدر الزيارات والحملة العامة

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

تتمثل أسهل طريقة لإرسال بيانات الحملة في استخدام [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString]، حيث يكون urlString سلسلة تمثّل عنوان URL قد يحتوي على مَعلمات حملات "إحصاءات Google". في الأمثلة التالية، لا يتم ضبط بيانات الحملة على أداة التتبُّع مباشرةً، لأنّه يجب إرسالها مرة واحدة فقط:

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

بدلاً من ذلك، إذا كانت لديك معلومات الحملة في نموذج آخر غير مَعلمات الحملات في "إحصاءات Google"، يمكنك ضبطها على NSDictionary وإرسالها يدويًا:

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

قياس أداء حملات عمليات تثبيت تطبيقات iOS

تقدِّم "إحصاءات Google" دعمًا مبتكرًا لقياس "حملات التثبيت" على نظام التشغيل iOS للشبكات الشائعة، كما توفِّر إمكانية إنشاء عناوين URL مخصّصة لك لأي شبكات إضافية.

لتفعيل قياس حملات عمليات التثبيت على iOS، استخدِم أداة إنشاء عناوين URL لتتبّع حملات iOS أدناه لإنشاء عناوين URL مقصودة لإعلاناتك التي توجِّه المستخدِمين إلى App Store. لكي تعمل ميزة تتبع حملات iOS، يجب أن تكون قد نفّذت "إحصاءات Google" في تطبيق iOS، وفعّلت جمع معرّف المعلِنين (IDFA)، وأن تتتبّع واحدًا أو أكثر من مرات مشاهدة الشاشة أو الأحداث في تطبيقك. وستحتاج أيضًا إلى إضافة إطار عمل آخر إلى تطبيقك إذا كنت تريد استخدام القياس التلقائي لحملات iAd install.

تشخيص الخدمة الذاتية لتتبُّع الإحالات الناجحة على نظام التشغيل iOS

إذا لم تظهر لك إحالات ناجحة لحملات iOS، اتّبِع الخطوات التالية لتحديد المشاكل وحلّها:

التأكد من تفعيل تتبُّع حملات iOS
التأكّد من تطابق رقم تعريف الطلب
التأكّد من إرسال حزمة تطوير البرامج (SDK) في "إحصاءات Google" لمعرّف المعلِنين (IDFA)
اطّلِع على تقرير الخصائص الديمغرافية للتأكّد من إرسال معرّف المعلِنين (IDFA).
التأكد من صحة عناوين URL لتتبّع حملات iOS

الخطوة 1: التأكّد من تفعيل تتبُّع حملات iOS

للتأكد من تمكين تتبع حملات iOS للموقع المستهدف:

انقر على علامة التبويب المدير.
اختَر الموقع وانقر على إعدادات الموقع.
تأكد من تشغيل تتبّع حملات iOS.

ملاحظة: إذا لم تكن ميزة "تتبُّع حملات iOS" مفعّلة، لن تُنسب "إحصاءات Google" بيانات حملات iOS إلى بيانات التطبيق.

الخطوة 2: التأكّد من تطابق رقم تعريف الطلب

لتحديد مصدر حملة تتضمّن بيانات التطبيق بشكلٍ صحيح، يجب أن يستخدم عنوان URL لتتبُّع حملة iOS وتنفيذ تتبُّع التطبيقات نفس رقم تعريف التطبيق. لتحديد رقم تعريف التطبيق لأحد التطبيقات التي يتم تتبُّعها حاليًا، يمكنك إنشاء تقرير مخصّص في واجهة الويب على "إحصاءات Google" باستخدام رقم تعريف التطبيق كسمة و الجلسات كمقياس.

أثناء إنشاء عنوان URL لتتبُّع حملة iOS، استخدِم رقم تعريف التطبيق الذي يظهر في التقرير المخصَّص.

إنشاء تقرير مخصص

الخطوة 3: التأكّد من أنّ حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" ترسل معرّف المعلِنين (IDFA)

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

يستخدم تطبيقك حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS الإصدار 3.10 أو إصدار أحدث.
في حال استخدام تنزيل حزمة تطوير البرامج (SDK) المستقل:
- تم ربط تطبيقك بـ libAdIdAccess.a كجزء من إصدار "إحصاءات Google" لنظام التشغيل iOS.
- تم ربط تطبيقك بـ "AdSupport.framework".
إذا كنت تستخدم CocoaPods لتثبيت التبعيات وإدارتها، أضِف GoogleIDFASupport Cocoapod إلى Podfile:
```
pod 'GoogleIDFASupport'
```
.
لقد فعّلت جمع معرّف المعلِنين (IDFA) في كل جهاز تتبُّع:
```
tracker.allowIDFACollection = YES;
```
استخدِم تطبيق خادم وكيل لتصحيح الأخطاء إذا كان ذلك ممكنًا لعرض طلبات HTTP والتأكّد من تضمين معرّف المعلِنين (IDFA).

الخطوة 4: الاطّلاع على تقرير الخصائص الديمغرافية للتأكّد من إرسال معرّف المعلِنين (IDFA)

تستخدم "إحصاءات Google" معرّف المعلِنين (IDFA) لإنشاء تقارير الخصائص الديمغرافية. في إحصاءات Google، انقر على علامة التبويب إعداد التقارير، ثمّ انقر على الجمهور > الخصائص الديمغرافية > نظرة عامة للتحقّق من ظهور بيانات الخصائص الديمغرافية. في هذه الحالة، سيتم إرسال معرّف المعلِنين (IDFA) بشكل صحيح.

تقرير مخصّص

الخطوة 5: التأكّد من صحة عناوين URL لتتبّع حملات iOS

استخدِم أداة إنشاء عناوين URL لتتبّع حملات iOS للتحقّق من صحة عناوين URL لتتبّع حملات iOS.

عند تحديد الخيار مخصَّص لشبكة الإعلانات، تأكّد أيضًا من استشارة تلك الشبكة للتأكد من أنّها تتيح تتبُّع أرقام تعريف أجهزة فردية باستخدام عناوين URL لإعادة التوجيه. وفي حال عدم إجراء ذلك، لن تظهر لك أي بيانات في تقارير "إحصاءات Google".

أداة إنشاء عناوين URL لتتبّع حملات iOS

استخدِم الأداة أدناه لإنشاء عناوين URL لقياس مصدر عمليات تثبيت تطبيقات iOS.

ملاحظة مهمة: تتطلّب عناوين URL للتتبّع في Google AdMob معلَمة &hash=md5. تضيف "أداة إنشاء عناوين URL لنظام التشغيل iOS" هذه المَعلمة تلقائيًا. إذا أنشأت عناوين URL يدويًا، يجب إضافة هذه المَعلمة لتتبُّع تثبيت AdMob على نظام التشغيل iOS حتى تعمل بشكل صحيح. في حال اختيار شبكات مواقع إعلانية أخرى غير AdMob، لن تكون المَعلمة &hash=md5 مطلوبة.