قياس الإحالات الناجحة المتكامل

تستخدِم ميزة قياس الإحالات الناجحة المتكامل أداة "القياس على الجهاز فقط" (ODM): حزمة تطوير البرامج (SDK) لبيانات الأحداث من أجل تحسين قياس الإحالات الناجحة على أجهزة iOS. يمكنك الوصول إلى حزمة تطوير البرامج (SDK) الخاصة بميزة "القياس عند الطلب" من المصادر التالية:

مزيد من المعلومات عن إعداد ميزة "قياس الإحالات الناجحة على الجهاز فقط" باستخدام حزمة تطوير برامج (SDK) مستقلة

توضّح الخطوات التالية كيفية الاستفادة من حزمة تطوير البرامج (SDK) الخاصة بمصنّع الجهاز الأصلي.

دمج حزمة تطوير البرامج (SDK) المستقلة

يمكنك الوصول إلى حزمة تطوير البرامج (SDK) المستقلة لقياس الإحالات الناجحة على الجهاز فقط من خلال CocoaPods وSwift Package Manager.

Swift Package Manager

  1. في Xcode، انتقِل إلى ملف (File)، ثم إضافة حِزم (Add Packages).
  2. اختَر مستودع GoogleAdsOnDeviceConversion على GitHub‏ (GoogleAdsOnDeviceConversion GitHub repository) في الطلب.

بعد الانتهاء، سيبدأ Xcode في حلّ التبعيات المرتبطة بحِزمك وتنزيلها في الخلفية.

CocoaPods

  1. أضِف مجموعة الإعلانات المتسلسلة GoogleAdsOnDeviceConversion إلى ملف Podfile.

    pod 'GoogleAdsOnDeviceConversion'

  2. نفِّذ الأمر pod install --repo-update.

استخدام حزمة تطوير البرامج (SDK) الخاصة بميزة "القياس على الجهاز فقط" (ODM): بيانات الأحداث

بعد استرداد حِزمة تطوير البرامج (SDK) الخاصة بـ ODM، يمكنك استرجاع معلومات الإحالات الناجحة بعد فترة قصيرة من تشغيل التطبيق لأول مرة، وذلك قبل إرسال حدث الإحالة الناجحة first_open إلى واجهة برمجة التطبيقات App Conversion API.

Swift

  1. استيراد GoogleAdsOnDeviceConversion

    import GoogleAdsOnDeviceConversion

  2. تحديد وقت تشغيل التطبيق لأول مرة

    ConversionManager.sharedInstance.setFirstLaunchTime(Date())

  3. استرجِع معلومات الإحالات الناجحة.

    ConversionManager.sharedInstance.fetchAggregateConversionInfo(
    for: .installation) { aggregateConversionInfo, error in
   guard error == nil else { return }
   guard let info = aggregateConversionInfo else { return }
   guard info.count > 0 else { return }
   print("Conversion info \(info)")
}

لتحديد المشكلة وحلّها:

  1. تحقَّق من أنّ التاريخ الذي تم إرساله إلى setFirstLaunchTime() هو تاريخ إطلاق التطبيق لأول مرة.
  2. تأكَّد من أنّ تطبيقك قيد التشغيل في منطقة معتمَدة.

استخدِم info كقيمة في مَعلمة طلب البحث odm_info في App Conversion API. على سبيل المثال، إذا كانت المعلومات هي "abcdEfadGdaf"، سيكون odm_info=abcdEfadGdaf.

Objective-C

  1. استيراد GoogleAdsOnDeviceConversion

    @import GoogleAdsOnDeviceConversion;

  2. تحديد وقت تشغيل التطبيق لأول مرة

    [[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]];

  3. استرجِع معلومات الإحالات الناجحة.

    [[ODCConversionManager sharedInstance]
  fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation
  completion:^(NSString * _Nullable aggregateConversionInfo,
               NSError * _Nullable error)
{
  if (error) {
    return;
  }
  if (aggregateConversionInfo.length == 0) {
    return;
  }

  NSLog(@"Conversion info %@", aggregateConversionInfo);

  // Use aggregateConversionInfo as the value in the odm_info query
  // parameter in the App Conversion API.
  // For example, if aggregateConversionInfo is "abcdEfadGdaf",
  // then odm_info=abcdEfadGdaf.
}];

لتحديد المشكلة وحلّها:

  1. تحقَّق من أنّ NSDate الذي تم تمريره إلى setFirstLaunchTime() هو تاريخ إطلاق التطبيق لأول مرة.
  2. تأكَّد من أنّ تطبيقك قيد التشغيل في منطقة معتمَدة.