מעקב אחר מסחר אלקטרוני - Android SDK גרסה 2 (מדור קודם)

במסמך הזה מפורטת סקירה כללית של אופן המדידה של ההכנסות והתשלומים מתוך האפליקציה באמצעות Google Analytics SDK ל-Android v2.

סקירה

מדידת מסחר אלקטרוני מאפשרת לשלוח מכירות ורכישות מתוך האפליקציה ל-Google Analytics. נתוני המסחר האלקטרוני ב-Google Analytics מורכבים בדרך כלל מעסקאות ומפריטים שקשורים למזהה עסקה משותף. ב-Google Analytics SDK ל-Android, הקשר הזה נוצר על ידי יצירת אובייקט עסקה והוספת פריטים אליו.

השימוש בנתוני מסחר אלקטרוני הוא הראשי בדוחות הבאים:

  • סקירה כללית על מסחר אלקטרוני
  • ביצועי מוצרים
  • ביצועי מכירות
  • טרנזקציות
  • זמן לביצוע רכישה

הטמעה

ישנם שלושה שלבים למדידת עסקה באמצעות Google Analytics:

  1. בונים אובייקט של עסקה.
  2. בונים אובייקטים של פריטים ומוסיפים אותם לאובייקט העסקה.
  3. שולחים את העסקה באמצעות 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.
}

סוגי מטבע

ב-Google Analytics SDK ל-Android, שדות המטבע של המסחר האלקטרוני צריכים להיות במיקרו (מיליוניות של מטבעות).

לדוגמה, על מנת לשלוח ערך מטבע של 4.5991, יש להמיר את הערך הזה ל-micros (כלומר 4599100) כששולחים את העסקה ל-Google Analytics, כמו בדוגמאות למעלה. כשה-SDK שולח את העסקה הזו ל-Google Analytics, הערך מומר באופן אוטומטי לערך עשרוני עם נקודה קבועה ונשלח כ-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);
}

הרשימה המלאה של קודי המטבעות והמטבעות הנתמכים זמינה בחומר העזר בנושא מטבעות נתמכים.