GAIDictionaryBuilder-Klassenreferenz

Überblick

Hilfsklasse zum Erstellen eines Wörterbuchs aus 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]];

Sie können einen auf dem Tracker festgelegten Wert überschreiben, indem Sie ihn zum Wörterbuch hinzufügen.

[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 mit [GAIDictionaryBuilder set] oder [GAIDictionaryBuilder setAll] festgelegten Werte überschreiben alle vorhandenen Werte im GAIDictionaryBuilder-Objekt (d. h. 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 von params in dieses Objekt und ignoriert alle Schlüssel, die nicht NSString sind, und alle Werte, die weder NSString noch NSNull sind. Mehr...
 
(NSString *)get:
 Gibt den Wert für den Eingabeparameter "paramName" zurück oder "nil", wenn "paramName" nicht vorhanden ist Mehr...
 
(NSMutableDictionary *)- Entwickeln
 Gibt ein NSMutableDictionary-Objekt zurück, in dem alle Parameter festgelegt sind. Mehr...
 
(GAIDictionaryBuilder *)setCampaignParametersFromUrl:
 Parst und übersetzt UTM-Kampagnenparameter in Analytics-Kampagnenparameter und gibt sie als Zuordnung zurück. Mehr...
 
(GAIDictionaryBuilder *)setProductAction:
 Legen Sie das Feld für die Produktaktion für diesen Treffer fest. Mehr...
 
(GAIDictionaryBuilder *)addProduct:
 Fügt diesem Treffer ein Produkt hinzu. Mehr...
 
(GAIDictionaryBuilder *)addProductImpression:impressionList:impressionSource:
 Diesem Treffer eine Produktimpression hinzufügen. Mehr...
 
(GAIDictionaryBuilder *)addPromotion:
 Füge diesem Treffer eine Werbeaktion hinzu. Mehr...
 

Klassenmethoden

(„Verwenden Sie stattdessen createScreenView.)+ 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 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 soziale Treffer spezifisch sind. Mehr...
 
(GAIDictionaryBuilder *)+ createTimingWithCategory:interval:name:label:
 Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für einen Zeittreffer 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 *) params

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

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

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

- (NSMutableDictionary *) Build

Gibt ein NSMutableDictionary-Objekt zurück, in dem alle Parameter festgelegt sind.

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

Parst und übersetzt UTM-Kampagnenparameter in Analytics-Kampagnenparameter und gibt sie als Zuordnung zurück.

Parameter
paramsURL mit UTM-Kampagnenparametern.

Gültige Kampagnenparameter sind:

  • utm_id
  • utm_campaign
  • utm_content
  • utm_medium
  • utm_source
  • utm_term
  • dclid
  • gclid
  • gmob_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 manuellen Tagging finden Sie unter Vorteile des automatischen und manuellen Taggings.

+ (GAIDictionaryBuilder *) createAppView

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

Beachten Sie, dass bei dieser Methode der Bildschirmname für Folgetreffer nicht festgelegt wird. Dazu müssen Sie „set:kGAIDescription value:<screenName>“ für die Instanz GAITracker aufrufen.

Diese Methode wurde eingestellt. Verwende stattdessen „createScreenView“.

+ (GAIDictionaryBuilder *) createScreenView

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

Beachten Sie, dass bei dieser Methode der Bildschirmname für Folgetreffer nicht festgelegt wird. Dazu müssen Sie „set:kGAIDescription value:<screenName>“ für die Instanz GAITracker 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 Schwerwiegend: (NSNumber *) schwerwiegend

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

+ (GAIDictionaryBuilder *) createItemWithTransactionId: (NSString *) transactionId
name: (NSString *) name
Artikelnummer: (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 *) network
Aktion: (NSString *) Aktion
Ziel: (NSString *) target

Gibt ein GAIDictionaryBuilder-Objekt mit Parametern zurück, die für soziale Treffer 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 Zeittreffer spezifisch sind.

+ (GAIDictionaryBuilder *) createTransactionWithId: (NSString *) transactionId
affiliation: (NSString *) affiliation
Umsatz: (NSNumber *) revenue
Steuern: (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 Feld für die Produktaktion für diesen Treffer fest.

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

Fügt diesem Treffer ein Produkt hinzu.

– (GAIDictionaryBuilder *) addProductImpression: (GAIEcommerceProduct *) product
ImpressionList: (NSString *) name
ImpressionSource: (NSString *) Quelle

Diesem Treffer eine Produktimpression hinzufügen.

– (GAIDictionaryBuilder *) addPromotion: (GAIEcommercePromotion *) Werbung

Füge diesem Treffer eine Werbeaktion hinzu.