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

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

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

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

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

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

Swift Package Manager

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

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

CocoaPods

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

    pod 'GoogleAdsOnDeviceConversion'

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

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

بعد استرداد حزمة تطوير البرامج (SDK) لقياس الإحالات الناجحة على الجهاز فقط، يمكنك استرجاع معلومات الإحالات الناجحة بعد فترة قصيرة من تشغيل التطبيق لأول مرة، وذلك قبل إرسال حدث الإحالة الناجحة 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. تأكَّد من أنّ تطبيقك يعمل في منطقة معتمَدة.