GAIDictionaryBuilder-Klassenreferenz

Übersicht

Hilfsklasse zum Erstellen eines Wörterbuchs mit Trefferparametern und -werten.


Beispiele:

id<GAITracker> t = // get a tracker.
[t send:[[[GAIDictionaryBuilder createEventWithCategory:@"EventCategory"
                                                 action:@"EventAction"
                                                  label:nil
                                                  value:nil]
    set:"dimension1" forKey:[GAIFields customDimensionForIndex:1]] build]];

Dadurch wird ein Ereignistreffer mit den angegebenen Parametern und einem benutzerdefinierten Dimensionsparameter gesendet.
Wenn Sie einen Parameter mit allen Treffern senden möchten, legen Sie ihn direkt auf GAITracker fest.

[t set:kGAIScreenName value:@"Home"];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"PlusOne"
                                                target:@"SOME_URL"] build]];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"Share"
                                                target:@"SOME_POST"] build]];
[t send:[[GAIDictionaryBuilder createSocialWithNetwork:@"Google+"
                                                action:@"HangOut"
                                                target:@"SOME_CIRCLE"]
    build]];

Du kannst einen im Tracker festgelegten Wert überschreiben, indem du ihn dem Wörterbuch hinzufügst.

[t set:kGAIScreenName value:@"Home"];
[t send:...];
[t send[[[GAIDictionaryBuilder createEventWithCategory:@"click"
                                                action:@"popup"
                                                 label:nil
                                                 value:nil]
    set:@"popup title" forKey:kGAIScreenName] build]];

Die über [GAIDictionaryBuilder set] oder [GAIDictionaryBuilder setAll] festgelegten Werte überschreiben alle vorhandenen Werte im GAIDictionaryBuilder-Objekt (d. h. werden durch [GAIDictionaryBuilder createXYZ] initialisiert). Beispiel:

GAIDictionaryBuilder *m =
    GAIDictionaryBuilder createTimingWithCategory:@"category"
                                         interval:@0
                                             name:@"name"
                                            label:nil];
[t send:[m.set:@"10" forKey:kGAITimingVar] build];
[t send:[m.set:@"20" forKey:kGAITimingVar] build];

Übernimmt NSObject.

Instanzmethoden

(GAIDictionaryBuilder*)setAll:
 Kopiert alle Name/Wert-Paare aus Parametern in dieses Objekt und ignoriert dabei alle Schlüssel, die nicht NSString sind, sowie alle Werte, die weder NSString noch NSNull sind. Mehr...
 
(NSString *)get:
 Gibt den Wert für den Eingabeparameter „paramName“ oder „nil“ zurück, wenn „paramName“ nicht vorhanden ist. Mehr...
 
(NSMutableDictionary *)Erstellen
 Gibt ein NSMutableDictionary-Objekt mit allen in diesem Parameter festgelegten Parametern zurück. Mehr...
 
(GAIDictionaryBuilder*)setCampaignParametersFromUrl:
 Parst und übersetzt die utm-Kampagnenparameter in den Analytics-Kampagnenparameter und gibt sie als Karte zurück. Mehr...
 
(GAIDictionaryBuilder*)setProductAction:
 Legen Sie das Produktaktionsfeld für diesen Treffer fest. Mehr...
 
(GAIDictionaryBuilder *)addProduct:
 Fügt ein Produkt zu diesem Treffer hinzu. Mehr...
 
(GAIDictionaryBuilder *)addProductImpression:impressionList:impressionSource:
 Fügen Sie diesem Treffer eine Produktimpression hinzu. Mehr...
 
(GAIDictionaryBuilder *)addPromotion:
 Diesem Treffer ein Angebot hinzufügen. Mehr...
 

Klassenmethoden

(" stattdessen createScreenView verwenden&&t;)+ createAppView
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Appview-Treffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createScreenView
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Bildschirmaufruftreffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createEventWithCategory:action:label:value:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Ereignistreffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createExceptionWithDescription:withFatal:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Ausnahmetreffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createItemWithTransactionId:name:sku:category:price:quantity:currencyCode:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Elementtreffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createSocialWithNetwork:action:target:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Treffer in sozialen Netzwerken spezifisch sind. Mehr...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:name:label:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Timing-Treffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder*)+ createTransactionWithId:affiliation:revenue:tax:shipping:currencyCode:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Transaktionstreffer spezifisch sind. Mehr...
 

Methodendokumentation

- (GAIDictionaryBuilder *) setAll: (NSDictionary *) Parameter

Kopiert alle Name/Wert-Paare aus Parametern in dieses Objekt und ignoriert dabei alle Schlüssel, die nicht NSString sind, sowie alle Werte, die weder NSString noch NSNull sind.

- (NSString *) get: (NSString *) paramName

Gibt den Wert für den Eingabeparameter „paramName“ oder „nil“ zurück, wenn „paramName“ nicht vorhanden ist.

– (NSMutableDictionary *) Build

Gibt ein NSMutableDictionary-Objekt mit allen in diesem Parameter festgelegten Parametern zurück.

- (GAIDictionaryBuilder *) setCampaignParametersFromUrl: (NSString *) urlString

Parst und übersetzt die utm-Kampagnenparameter in den Analytics-Kampagnenparameter und gibt sie als Karte zurück.

Parameter
paramsURL mit utm-Kampagnenparametern.

Gültige Kampagnenparameter sind:

  • utm_id
  • utm_campaign
  • utm_content
  • utm_medium
  • utm_source
  • utm_term
  • DDlid
  • gclid
  • mob_t
  • aclid
  • anid

Beispiel: http://my.site.com/index.html?utm_campaign=wow&utm_source=source utm_campaign=wow&utm_source=source.

Weitere Informationen zum automatischen und zum manuellen Tagging finden Sie in diesem Artikel.

+ (GAIDictionaryBuilder *) createAppView

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Appview-Treffer spezifisch sind.

Hinweis: Bei dieser Methode wird nicht der Bildschirmname für Folgetreffer festgelegt. Dazu müssen Sie auf der Instanz GAITracker set:kGAIDescription value:<screenName> aufrufen.

Diese Methode wurde verworfen. Verwenden Sie stattdessen „createScreenView“.

+ (GAIDictionaryBuilder *) createScreenView

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Bildschirmaufruftreffer spezifisch sind.

Hinweis: Bei dieser Methode wird nicht der Bildschirmname für Folgetreffer festgelegt. Dazu müssen Sie auf der Instanz GAITracker set:kGAIDescription value:<screenName> aufrufen.

+ (GAIDictionaryBuilder *) createEventWithCategory: (NSString *) category
Aktion: (NSString *) Aktion
Label: (NSString *) label
value: (NSNumber *) value [Wert]

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Ereignistreffer spezifisch sind.

+ (GAIDictionaryBuilder *) createExceptionWithDescription: (NSString *) Beschreibung
mit Fatal: (NSNumber *) tödlich

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Ausnahmetreffer spezifisch sind.

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
name: (NSString *) name
SKU: (NSString *) SKU
Kategorie: (NSString *) category
Preis: (NSNumber *) price
Menge: (NSNumber *) quantity
currencyCode: (NSString *) currencyCode

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Elementtreffer spezifisch sind.

+ (GAIDictionaryBuilder *) createSocialWithNetwork: (NSString *) Netzwerk
Aktion: (NSString *) Aktion
Ziel: (NSString *) Ziel

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Treffer in sozialen Netzwerken spezifisch sind.

+ (GAIDictionaryBuilder *) createTimingWithCategory: (NSString *) category
Intervall: (NSNumber *) intervalMillis
name: (NSString *) name
Label: (NSString *) Label

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Timing-Treffer spezifisch sind.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
Zugehörigkeit: (NSString *) affiliation
Umsatz: (NSNumber *) revenue
Steuer: (NSNumber *) tax
Versand: (NSNumber *) shipping
currencyCode: (NSString *) currencyCode

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Transaktionstreffer spezifisch sind.

- (GAIDictionaryBuilder *) setProductAction: (GAIEcommerceProductAction*) productAction

Legen Sie das Produktaktionsfeld für diesen Treffer fest.

- (GAIDictionaryBuilder *) addProduct: (GAIEcommerceProduct*) product

Fügt ein Produkt zu diesem Treffer hinzu.

- (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) product
ImpressionList: (NSString *) name
Impression-Quelle: (NSString *) Quelle

Fügen Sie diesem Treffer eine Produktimpression hinzu.

- (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion*) Werbeaktion

Diesem Treffer ein Angebot hinzufügen.