Dieses Dokument bietet einen Überblick über die Messung von In-App-Zahlungen und -Umsätzen mit dem Google Analytics SDK für iOS v3.
Überblick
Mithilfe der E-Commerce-Messung können Sie In-App-Käufe und -Verkäufe an Google Analytics senden. E-Commerce-Daten in Google Analytics bestehen aus Transaktions- und Artikeltreffern, die durch eine gemeinsame Transaktions-ID verknüpft sind.
Transaktionen enthalten die folgenden Felder:
Feldname | Tracker-Feld | Typ | Erforderlich | Beschreibung |
---|---|---|---|---|
Transaktions-ID |
kGAITransactionId |
NSString |
Ja | Eine eindeutige ID, die die Transaktion darstellt. Diese ID sollte nicht mit anderen Transaktions-IDs in Konflikt stehen. |
Händler/Partner |
kGAITransactionAffiliation |
NSString |
Ja | Eine Entität, mit der die Transaktion verknüpft sein sollte (z.B. ein bestimmtes Geschäft) |
Umsatz |
kGAITransactionRevenue |
NSNumber |
Ja | Gesamtumsatz einer Transaktion, einschließlich Steuern und Versandkosten |
Steuer |
kGAITransactionTax |
NSNumber |
Ja | Die Gesamtsteuer für eine Transaktion |
Versand |
kGAITransactionShipping |
NSNumber |
Ja | Die Gesamtkosten für den Versand einer Transaktion |
Währungscode |
kGAICurrencyCode |
NSString |
Nein | Die Landeswährung einer Transaktion. Die Standardeinstellung ist die Währung der Datenansicht (des Profils), in der die Transaktionen aufgerufen werden. |
Elemente haben die folgenden Felder:
Feldname | Tracker-Feld | Typ | Erforderlich | Beschreibung |
---|---|---|---|---|
Transaktions-ID |
kGAITransactionId |
NSString |
Ja | Die Transaktions-ID, mit der der Artikel verknüpft werden soll |
Name |
kGAIItemName |
NSString |
Ja | Der Name des Produkts. |
Artikelnummer |
kGAIItemSku |
NSString |
Ja | Die Artikelnummer eines Produkts |
Kategorie |
kGAIItemCategory |
NSString |
Nein | Eine Kategorie, zu der das Produkt gehört |
Preis |
kGAIItemPrice |
NSNumber |
Ja | Der Preis eines Produkts |
Menge |
kGAIItemQuantity |
NSNumber |
Ja | Die Menge eines Produkts |
Währungscode |
kGAICurrencyCode |
NSString |
Nein | Die Landeswährung einer Transaktion. Die Standardeinstellung ist die Währung der Datenansicht (des Profils), in der die Transaktionen gemeldet werden. |
E-Commerce-Daten werden hauptsächlich in den folgenden Standardberichten verwendet:
- E-Commerce-Übersicht
- Produktleistung
- Verkaufsleistung
- Transaktionen
- Zeit bis zum Kauf
Implementierung
Zum Senden von Transaktions- und Artikeldaten an Google Analytics müssen die Transaktions- und Artikelfeldwerte im Tracker festgelegt und nacheinander gesendet werden. Beispiel:
/* * 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 den E-Commerce-Währungsfeldern werden negative Währungswerte unterstützt, wie es bei Erstattungen oder Retouren erforderlich sein kann.
Währungen angeben
Standardmäßig wird davon ausgegangen, dass Transaktionswerte die Währung der Datenansicht (des Profils) haben, in der sie gemeldet werden.
Wenn Sie die Landeswährung einer Transaktion und aller zugehörigen Produkte überschreiben möchten, legen Sie für das Feld „Währungscode“ der Transaktion und für die Artikeltreffer den neuen Währungscode fest. Eine vollständige Liste der unterstützten Währungen und Währungscodes finden Sie in der Referenz zu unterstützten Währungen.
/* 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 }