يقدّم هذا المستند نظرة عامة حول كيفية قياس الدفعات المضمّنة في الأرباح والأرباح باستخدام الإصدار 2.2 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google".
نظرة عامة
يسمح لك قياس التجارة الإلكترونية بإرسال المبيعات وعمليات الشراء داخل التطبيقات إلى "إحصاءات Google". تتألف بيانات التجارة الإلكترونية في "إحصاءات Google" بوجهٍ عام من المعاملات والعناصر المرتبطة برقم تعريف التحويل المشترك. وفي حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android، يتم إنشاء هذه العلاقة من خلال إنشاء كائن معاملة وإضافة العناصر إليها.
يتم استخدام بيانات التجارة الإلكترونية بشكل أساسي في التقارير التالية:
- نظرة عامة على التجارة الإلكترونية
- أداء المنتج
- أداء المبيعات
- المعاملات
- الوقت حتى الشراء
التنفيذ
تتوفّر ثلاث خطوات لقياس معاملة باستخدام "إحصاءات Google":
- إنشاء كائن معاملة.
- إنشاء عناصر العنصر وإضافتها إلى كائن المعاملة.
- أرسِل المعاملة باستخدام
sendTransaction(Transaction transObject).
في المثال التالي، نفترض أنّه يتم طلب
onPurchaseCompleted()
بعد إكمال المستخدم لعملية شراء داخل التطبيق.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
أنواع العملات
في حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android، يجب أن تكون حقول عملة التجارة الإلكترونية بوحدات المايكرو (بالملايين من العملات).
على سبيل المثال، لإرسال قيمة عملة 4.5991، يجب تحويل هذه القيمة إلى وحدات المايكرو (أي 4599100) عند إرسال المعاملة إلى "إحصاءات Google"، كما في الأمثلة أعلاه. وعندما ترسل حزمة تطوير البرامج (SDK) هذه المعاملة إلى"إحصاءات Google"، يتم تحويل هذه القيمة تلقائيًا إلى قيمة عشرية ذات قيمة ثابتة وإرسالها باعتبارها 4.5991.
يجب عدم إدراج رموز العملات في رمز التجارة الإلكترونية، ويجب عدم استخدام الفواصل.
وتتيح حقول عملة التجارة الإلكترونية أيضًا استخدام قيم سالبة للعملات، وقد تكون ضرورية في حالة عمليات ردّ الأموال أو الإرجاع.
تحديد العملات
بشكل تلقائي، يُفترض أن تكون قيم المعاملات بعملة الملف الشخصي التي يتم الإبلاغ عنها.
لتجاوز العملة المحلية لإحدى المعاملات، يمكنك طلب
setCurrencyCode عند إنشاء
Transaction
كما في المثال التالي:
/**
* In this example, the currency of the transaction is set to Euros. The
* currency values will appear in reports using the global currency
* type of the view (profile).
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
للحصول على قائمة كاملة بالعملات ورموز العملات المتوافقة، راجِع مرجع العملات المتوافقة.