מעקב אחר מסחר אלקטרוני - iOS SDK

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

הערה: כדי להשתמש במעקב אחר מסחר אלקטרוני צריך לשלוח היטים transaction ו-item. לא כדאי להשתמש בשיטות שקשורות למסחר אלקטרוני משופר לצורך מעקב רגיל אחר מסחר אלקטרוני.

סקירה

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

העסקאות כוללות את השדות הבאים:

שם השדה	שדה מעקב	סוג	חובה	תיאור
מזהה עסקה	kGAITransactionId	NSString	כן	מזהה ייחודי שמייצג את העסקה. המזהה הזה לא יכול להתנגש עם מזהי עסקאות אחרים.
נתונים משויכים	kGAITransactionAffiliation	NSString	כן	הישות שאליה העסקה צריכה להיות משויכת (למשל, חנות מסוימת)
הכנסה	kGAITransactionRevenue	NSNumber	כן	ההכנסה הכוללת מעסקה, כולל מס ודמי משלוח
מס	kGAITransactionTax	NSNumber	כן	המס הכולל על עסקה
משלוח	kGAITransactionShipping	NSNumber	כן	העלות הכוללת של משלוח לעסקה
קוד מטבע	kGAICurrencyCode	NSString	לא	המטבע המקומי של העסקה. ערך ברירת המחדל הוא המטבע של התצוגה המפורטת (הפרופיל) שבה מוצגות העסקאות.

הפריטים כוללים את השדות הבאים:

שם השדה	שדה מעקב	סוג	חובה	תיאור
מזהה עסקה	kGAITransactionId	NSString	כן	מזהה העסקה שאליו הפריט צריך להיות משויך
שם	kGAIItemName	NSString	כן	שם המוצר
מק"ט	kGAIItemSku	NSString	כן	המק"ט של מוצר
קטגוריה	kGAIItemCategory	NSString	לא	הקטגוריה שהמוצר שייך אליה
מחיר	kGAIItemPrice	NSNumber	כן	מחיר של מוצר
כמות	kGAIItemQuantity	NSNumber	כן	כמות של מוצר
קוד מטבע	kGAICurrencyCode	NSString	לא	המטבע המקומי של העסקה. ערך ברירת המחדל הוא המטבע של התצוגה המפורטת (הפרופיל) שבה מדווחות העסקאות.

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

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

הטמעה

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

/*
 * Called when a purchase is processed and verified.
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

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

אזהרה: אין לכלול סמלי מטבע או פסיקים בשדות המטבע.

ציון מטבעות

כברירת מחדל, ערכי העסקאות מוצגים במטבע של התצוגה המפורטת (הפרופיל) שבה הם מדווחים.

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

/*
 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).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}