From f7ba12a2e628891df42767cd19c3ce90ff449c6b Mon Sep 17 00:00:00 2001 From: ivosam3 Date: Fri, 17 Nov 2023 17:13:12 +0100 Subject: [PATCH] Updated articles according to feedback --- .../configuration/external-device-id.mdx | 2 +- .../en/sdk/android/features/ad-revenue.mdx | 2 +- .../docs/en/sdk/android/features/events.mdx | 4 +- src/content/docs/en/sdk/android/index.mdx | 4 +- .../en/sdk/android/integrations/admob.mdx | 22 - .../en/sdk/android/integrations/applovin.mdx | 18 - .../en/sdk/android/integrations/batch.mdx | 28 -- .../en/sdk/android/integrations/helium.mdx | 24 - .../sdk/android/integrations/ironsource.mdx | 20 - .../en/sdk/android/integrations/mixpanel.mdx | 42 -- .../en/sdk/android/integrations/unity.mdx | 26 - .../docs/en/sdk/android/plugins/criteo.mdx | 446 +----------------- .../en/sdk/android/plugins/imei-plugin.mdx | 26 +- .../en/sdk/android/plugins/oaid-plugin.mdx | 26 +- .../en/sdk/android/plugins/sociomatic.mdx | 440 +---------------- .../docs/en/sdk/android/plugins/trademob.mdx | 165 +------ .../en/sdk/android/reference/adjust/index.mdx | 1 + .../docs/en/sdk/android/reference/index.mdx | 3 +- .../en/sdk/android/setup/preinstall-tool.mdx | 14 +- 19 files changed, 57 insertions(+), 1256 deletions(-) diff --git a/src/content/docs/en/sdk/android/configuration/external-device-id.mdx b/src/content/docs/en/sdk/android/configuration/external-device-id.mdx index e1c7dab929..0d60e8c90b 100644 --- a/src/content/docs/en/sdk/android/configuration/external-device-id.mdx +++ b/src/content/docs/en/sdk/android/configuration/external-device-id.mdx @@ -33,7 +33,7 @@ If you want to use the external device ID in your business analytics, you can pa -See [Session parameters](/android/recording/session-parameters.md) for more information. +See [Session parameters](/en/sdk/android/features/session-parameters) for more information. diff --git a/src/content/docs/en/sdk/android/features/ad-revenue.mdx b/src/content/docs/en/sdk/android/features/ad-revenue.mdx index c2820ffcbc..0730249fef 100644 --- a/src/content/docs/en/sdk/android/features/ad-revenue.mdx +++ b/src/content/docs/en/sdk/android/features/ad-revenue.mdx @@ -111,7 +111,7 @@ Add callback parameters to your event by calling the `addCallbackParame The Adjust SDK measures the event and sends a request to your URL with the callback parameters. For example, if you register the URL `https://www.mydomain.com/callback`, your callback looks like this: -```http +```http "key=value" "foo=bar" https://www.mydomain.com/callback?key=value&foo=bar ``` diff --git a/src/content/docs/en/sdk/android/features/events.mdx b/src/content/docs/en/sdk/android/features/events.mdx index 348c9c592b..f34a294eee 100644 --- a/src/content/docs/en/sdk/android/features/events.mdx +++ b/src/content/docs/en/sdk/android/features/events.mdx @@ -86,7 +86,7 @@ Add callback parameters to your event by calling the `addCallbackParame The Adjust SDK measures the event and sends a request to your URL with the callback parameters. For example, if you register the URL `https://www.mydomain.com/callback`, your callback looks like this: -```http +```http "key=value" "foo=bar" https://www.mydomain.com/callback?key=value&foo=bar ``` @@ -115,7 +115,7 @@ This example demonstrates how to record an event with the token `g3mfiw` wheneve The resulting callback URL looks like this: -```http +```http "event_token=g3mfiw" "revenue_amount=0.05" http://www.mydomain.com/callback?event_token=g3mfiw&revenue_amount=0.05 ``` diff --git a/src/content/docs/en/sdk/android/index.mdx b/src/content/docs/en/sdk/android/index.mdx index 21153f3659..f3ffac9995 100644 --- a/src/content/docs/en/sdk/android/index.mdx +++ b/src/content/docs/en/sdk/android/index.mdx @@ -79,7 +79,7 @@ If your app doesn't target the Google Play Store, add the following permission t The Adjust SDK includes the `com.google.android.gms.AD_ID` permission by default. If you need to make your app COPPA (Children's Online Privacy Protection Act) compliant or if your app doesn't target the Google Play Store, you must remove this permission using a `remove` directive. -```xml +```xml "tools:node="remove"" ``` @@ -116,7 +116,7 @@ An install referrer is a unique identifier used to attribute an install to a sou The Google Play Referrer API is available to apps that target the Google Play Store. -To support the Google Play Referrer API, add the following to your {file}`build.gradle` file: +To support the Google Play Referrer API, add the following to your `build.gradle` file: ```groovy dependencies { diff --git a/src/content/docs/en/sdk/android/integrations/admob.mdx b/src/content/docs/en/sdk/android/integrations/admob.mdx index be20b8a8a2..59b216e782 100644 --- a/src/content/docs/en/sdk/android/integrations/admob.mdx +++ b/src/content/docs/en/sdk/android/integrations/admob.mdx @@ -54,27 +54,5 @@ adRequest, new RewardedAdLoadCallback(){ }); ``` - - - -### C# - -```c# -this.rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; -public void HandleAdPaidEvent(object sender, AdValueEventArgs args) -{ - // for more information, please check AdMob official docs at: - // https://developers.google.com/admob/unity/impression-level-ad-revenue - AdValue adValue = args.AdValue; - AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.GetResponseInfo().GetLoadedAdapterResponseInfo(); - - // send ad revenue info to Adjust - AdjustAdRevenue adRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAdMob); - adRevenue.setRevenue(adValue.Value / 1000000f, adValue.CurrencyCode); - adRevenue.setAdRevenueNetwork(loadedAdapterResponseInfo.AdSourceName) - Adjust.trackAdRevenue(adRevenue); -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/applovin.mdx b/src/content/docs/en/sdk/android/integrations/applovin.mdx index 35f6420dfd..d49ac91a43 100644 --- a/src/content/docs/en/sdk/android/integrations/applovin.mdx +++ b/src/content/docs/en/sdk/android/integrations/applovin.mdx @@ -36,24 +36,6 @@ public void onAdRevenuePaid(final MaxAd ad) { } ``` - - - -### C# - -```c# -private void OnRewardedAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) -{ - var adRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAppLovinMAX); - adRevenue.setRevenue(adInfo.Revenue, "USD"); - adRevenue.setAdRevenueNetwork(adInfo.NetworkName); - adRevenue.setAdRevenueUnit(adInfo.AdUnitIdentifier); - adRevenue.setAdRevenuePlacement(adInfo.Placement); - - Adjust.trackAdRevenue(adRevenue); -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/batch.mdx b/src/content/docs/en/sdk/android/integrations/batch.mdx index 6093e59c13..c3c6054061 100644 --- a/src/content/docs/en/sdk/android/integrations/batch.mdx +++ b/src/content/docs/en/sdk/android/integrations/batch.mdx @@ -51,33 +51,5 @@ config.setOnAttributionChangedListener(new OnAttributionChangedListener() { Adjust.onCreate(config); ``` - - - -### Swift - -```swift -func adjustAttributionChanged(_ attribution: ADJAttribution?) { - // initiate Batch user editor to set new attributes - let editor = BatchUser.editor() - - if attribution?.network != nil { - editor?.setAttribute(attribution?.network, forKey: "adjust_network") - } - if attribution?.campaign != nil { - editor?.setAttribute(attribution?.campaign, forKey: "adjust_campaign") - } - if attribution?.adgroup != nil { - editor?.setAttribute(attribution?.campaign, forKey: "adjust_adgroup") - } - if attribution?.creative != nil { - editor?.setAttribute(attribution?.creative, forKey: "adjust_creative") - } - - // send new attribute to Batch servers - editor.save() -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/helium.mdx b/src/content/docs/en/sdk/android/integrations/helium.mdx index ed1ce6ff71..1faa8c7a34 100644 --- a/src/content/docs/en/sdk/android/integrations/helium.mdx +++ b/src/content/docs/en/sdk/android/integrations/helium.mdx @@ -47,29 +47,5 @@ public void ilrdObserver (final HeliumImpressionData impData) { Adjust.trackAdRevenue(adjustAdRevenue); } ``` - - - -### C# - -```c# -void DidReceiveImpressionLevelRevenueData(string placement, Hashtable impressionData) -{ - var json = HeliumJSON.Serialize(impressionData); - - ParsedJsonObject parsedJsonObject = foobar.parse(json); //app developer defined function to parse Helium impressionData JSON string - - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceHeliumChartboost); - adjustAdRevenue.setRevenue(parsedJsonObject.ad_revenue, parsedJsonObject.currency_type); - - // optional fields - adjustAdRevenue.setAdRevenueNetwork(parsedJsonObject.network_name); // Helium demand network name - adjustAdRevenue.setAdRevenueUnit(parsedJsonObject.placement_name); // Helium placement name - adjustAdRevenue.setAdRevenuePlacement(parsedJsonObject.line_item_name); // Helium line item name - // track Adjust ad revenue - Adjust.trackAdRevenue(adjustAdRevenue); -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/ironsource.mdx b/src/content/docs/en/sdk/android/integrations/ironsource.mdx index 9d2c187cab..be3be75e18 100644 --- a/src/content/docs/en/sdk/android/integrations/ironsource.mdx +++ b/src/content/docs/en/sdk/android/integrations/ironsource.mdx @@ -35,25 +35,5 @@ public void onImpressionSuccess (ImpressionData impressionData) { Adjust.trackAdRevenue(adjustAdRevenue); } ``` - - - -### C# - -```c# -IronSourceEvents.onImpressionDataReadyEvent += ImpressionDataReadyEvent; -private void ImpressionDataReadyEvent(IronSourceImpressionData impressionData) -{ - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceIronSource); - adjustAdRevenue.setRevenue(impressionData.revenue, "USD"); - // optional fields - adjustAdRevenue.setAdRevenueNetwork(impressionData.adNetwork); - adjustAdRevenue.setAdRevenueUnit(impressionData.adUnit); - adjustAdRevenue.setAdRevenuePlacement(impressionData.placement); - // track Adjust ad revenue - Adjust.trackAdRevenue(adjustAdRevenue); -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/mixpanel.mdx b/src/content/docs/en/sdk/android/integrations/mixpanel.mdx index db387494b5..ca33260047 100644 --- a/src/content/docs/en/sdk/android/integrations/mixpanel.mdx +++ b/src/content/docs/en/sdk/android/integrations/mixpanel.mdx @@ -70,47 +70,5 @@ public class YourApplicationClass extends Application { } ``` - - - -### Swift - -```swift -func adjustAttributionChanged(_ attribution: ADJAttribution?) { - let mixpanel = Mixpanel.sharedInstance() - - // The adjust properties will be sent - // with all future track calls. - if attribution?.network != nil { - if let network = attribution?.network { - mixpanel?.registerSuperProperties([ - "[Adjust]Network": network - ]) - } - } - if attribution?.campaign != nil { - if let campaign = attribution?.campaign { - mixpanel?.registerSuperProperties([ - "[Adjust]Campaign": campaign - ]) - } - } - if attribution?.adgroup != nil { - if let adgroup = attribution?.adgroup { - mixpanel?.registerSuperProperties([ - "[Adjust]Adgroup": adgroup - ]) - } - } - if attribution?.creative != nil { - if let creative = attribution?.creative { - mixpanel?.registerSuperProperties([ - "[Adjust]Creative": creative - ]) - } - } -} -``` - diff --git a/src/content/docs/en/sdk/android/integrations/unity.mdx b/src/content/docs/en/sdk/android/integrations/unity.mdx index 8bad4ed913..a0fb55988f 100644 --- a/src/content/docs/en/sdk/android/integrations/unity.mdx +++ b/src/content/docs/en/sdk/android/integrations/unity.mdx @@ -52,31 +52,5 @@ ImpressionEventPublisher.subscribe(impressionListener); // unsubscribe the impression listener from the impression event publisher ImpressionEventPublisher.unsubscribe(impressionListener); ``` - - - -### C# - -```c# -static void OnImpression(object sender, ImpressionEventArgs e) -{ - var impressionData = e.ImpressionData != null ? JsonUtility.ToJson(e.ImpressionData, true) : "null"; - Debug.Log($"Impression event from ad unit id {e.AdUnitId} : {impressionData}"); - - // send impression data to Adjust - if (e.ImpressionData != null) - { - AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceUnity); - adjustAdRevenue.setRevenue(e.ImpressionData.PublisherRevenuePerImpression, e.ImpressionData.Currency); - // optional fields - adjustAdRevenue.setAdRevenueNetwork(e.ImpressionData.AdSourceName); - adjustAdRevenue.setAdRevenueUnit(e.ImpressionData.AdUnitId); - adjustAdRevenue.setAdRevenuePlacement(e.ImpressionData.AdSourceInstance); - // track Adjust ad revenue - Adjust.trackAdRevenue(adjustAdRevenue); - } -} -``` - diff --git a/src/content/docs/en/sdk/android/plugins/criteo.mdx b/src/content/docs/en/sdk/android/plugins/criteo.mdx index 25bdb2b2d9..a467aa55d0 100644 --- a/src/content/docs/en/sdk/android/plugins/criteo.mdx +++ b/src/content/docs/en/sdk/android/plugins/criteo.mdx @@ -30,38 +30,7 @@ Once you have set up your environment, you can start recording Criteo events wit ### View listing - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewListingEventToken}"]; - -NSArray *productIds = @[@"productId1", @"productId2", @"product3"]; - -[ADJCriteo injectViewListingIntoEvent:event productIds:productIds]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{viewListingEventToken}") - -let productIds = ["productId1", "productId2", "product3"] - -ADJCriteo.injectViewListing(into: event, productIds: productIds) - -Adjust.trackEvent(event) -``` - - + ### Java @@ -80,35 +49,7 @@ Adjust.trackEvent(event); ### View product - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewProductEventToken}"]; - -[ADJCriteo injectViewProductIntoEvent:event productId:@"productId1"]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{viewProductEventToken}") - -ADJCriteo.injectViewProduct(into: event, productId: "productId1") - -Adjust.trackEvent(event) -```kEvent(event) -``` - - + ### Java @@ -126,44 +67,7 @@ Adjust.trackEvent(event); ### Cart - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{cartEventToken}"]; - -ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0 quantity:1]; -ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3]; -ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2]; -NSArray *products = @[product1, product2, product3]; - -[ADJCriteo injectCartIntoEvent:event products:products]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{cartEventToken}") - -let product1 = ADJCriteoProduct(id: "productId1", price: 100.0, quantity: 1) -let product2 = ADJCriteoProduct(id: "productId2", price: 77.7, quantity: 3) -let product3 = ADJCriteoProduct(id: "productId3", price: 50, quantity: 2) -let products = [product1, product2, product3] - -ADJCriteo.injectCart(into: event, products: products) - -Adjust.trackEvent(event) -``` - - + ### Java @@ -186,45 +90,7 @@ Adjust.trackEvent(event); ### Transaction confirmed - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{transactionConfirmedEventToken}"]; - -ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0 quantity:1]; -ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3]; -ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2]; -NSArray *products = @[product1, product2, product3]; - -[ADJCriteo injectTransactionConfirmedIntoEvent:event products:products - transactionId:@"transactionId1" newCustomer:@"newCustomerId"]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{transactionConfirmedEventToken}") - -let product1 = ADJCriteoProduct(id: "productId1", price: 100.0, quantity: 1) -let product2 = ADJCriteoProduct(id: "productId2", price: 77.7, quantity: 3) -let product3 = ADJCriteoProduct(id: "productId3", price: 50, quantity: 2) -let products = [product1, product2, product3] - -ADJCriteo.injectTransactionConfirmed(into: event, products: products) - -Adjust.trackEvent(event) -``` - - + ### Java @@ -247,34 +113,7 @@ Adjust.trackEvent(event); ### User level - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{userLevelEventToken}"]; - -[ADJCriteo injectUserLevelIntoEvent:event uiLevel:1]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{userLevelEventToken}") - -ADJCriteo.injectUserLevel(into: event, uiLevel: 1) - -Adjust.trackEvent(event) -``` - - + ### Java @@ -292,35 +131,7 @@ Adjust.trackEvent(event); ### User status - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{userStatusEventToken}"]; - -[ADJCriteo injectUserStatusIntoEvent:event uiStatus:@"uiStatusValue"]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{userStatusEventToken}") - -ADJCriteo.injectUserStatus(into: event, uiStatus: "uiStatusValue") - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -338,35 +149,7 @@ Adjust.trackEvent(event); ### Achievement unlocked - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{achievementUnlockedEventToken}"]; - -[ADJCriteo injectAchievementUnlockedIntoEvent:event uiAchievement:@"uiAchievementValue"]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent.eventToken("{achievementUnlockedEventToken}") - -ADJCriteo.injectAchievementUnlocked(into: event, uiAchievement: "uiAchievementValue") - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -385,35 +168,7 @@ Adjust.trackEvent(event); ### Custom event - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEventEventToken}"]; - -[ADJCriteo injectCustomEventIntoEvent:event uiData:@"uiDataValue"]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent.eventToken("{customEventEventToken}") - -ADJCriteo.injectCustomEvent(into: event, uiData: "uiDataValue") - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -431,35 +186,7 @@ Adjust.trackEvent(event); ### Custom event 2 - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEvent2EventToken}"]; - -[ADJCriteo injectCustomEvent2IntoEvent:event uiData2:@"uiDataValue2" uiData3:3]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{customEvent2EventToken}" - -ADJCriteo.injectCustomEvent2(into: event, uiData2: "uiDataValue2", uiData3: 3) - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -479,27 +206,7 @@ Adjust.trackEvent(event); You can attach a hashed email to every Criteo event. To do this, call the `injectHashedEmailIntoCriteoEvents` method. The SDK will send a hashed email with every Criteo event throughout the app lifecycle. This means it will need to be set again when the app is re-launched. You can remove the hashed email by setting the `injectHashedEmailIntoCriteoEvents` value to `nil`. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -[ADJCriteo injectHashedEmailIntoCriteoEvents:@"8455938a1db5c475a87d76edacb6284e"]; -``` - - - - -### Swift - -```swift -ADJCriteo.injectHashedEmail(intoCriteoEvents: "8455938a1db5c475a87d76edacb6284e") -``` - - - + ### Java @@ -519,27 +226,7 @@ You can attach a check-in and check-out date to every Criteo event. To do this, You can remove the search dates by setting the `injectViewSearchDatesIntoCriteoEvent` values to `nil`. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -[ADJCriteo injectViewSearchDatesIntoCriteoEvents:@"2015-01-01" checkOutDate:@"2015-01-07"]; -``` - - - - -### Swift - -```swift -ADJCriteo.injectViewSearchDates(intoCriteoEvents: "2015-01-01", checkoutDate: "2015-01-07") -``` - - - + ### Java @@ -559,27 +246,7 @@ You can attach a partner ID to every Criteo event. To do this, call the `injectP You can remove the partner ID by setting the `injectPartnerIdIntoCriteoEvents` value to null. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -[ADJCriteo injectPartnerIdIntoCriteoEvents:@"{criteoPartnerId}"]; -``` - - - - -### Swift - -```swift -ADJCriteo.injectPartnerId(intoCriteoEvents: "{criteoPartnerId}" -``` - - - + ### Java @@ -597,50 +264,7 @@ AdjustCriteo.injectPartnerIdIntoCriteoEvents("{CriteoPartnerId}"); You can add deep link information to Criteo events. To do this, call the `injectDeeplinkIntoEvent` method with the event and URL. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -- (BOOL) application:(UIApplication *)application openURL:(NSURL *)url - sourceApplication:(NSString *)sourceApplication annotation:(id)annotation -{ - ADJEvent *event = [ADJEvent eventWithEventToken:@"{deeplinkEventToken}"]; - - [ADJCriteo injectDeeplinkIntoEvent:event url:url]; - - [Adjust trackEvent:event]; - - //... -} -``` - - - - -### Swift - -```swift -func application( - _ application: UIApplication?, - open url: URL?, - sourceApplication: String?, - annotation: Any? -) -> Bool { - let event = ADJEvent(eventToken: "{deeplinkEventToken}") - - ADJCriteo.injectDeeplink(into: event, url: url) - - Adjust.trackEvent(event) - - //... -} -``` - - - + ### Java @@ -669,27 +293,7 @@ You can attach a customer ID to every Criteo event. To do this, call the `inject You can remove the customer ID by setting the `injectCustomerIdIntoCriteoEvents` value to nil. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -[ADJCriteo injectCustomerIdIntoCriteoEvents:@"{CriteoCustomerId}"]; -``` - - - - -### Swift - -```swift -ADJCriteo.injectCustomerId(intoCriteoEvents: "{CriteoCustomerId}") -``` - - - + ### Java @@ -709,27 +313,7 @@ You can attach the user segment to every Criteo event. To do this, call the `inj You can remove the user segment by setting the `injectUserSegmentIntoCriteoEvents` value to nil. - - -### Objective-C - -```objc -#import "ADJCriteo.h" - -[ADJCriteo injectUserSegmentIntoCriteoEvents:@"{CriteoUserSegment}"]; -``` - - - - -### Swift - -```swift -ADJCriteo.injectUserSegment(intoCriteoEvents: "{CriteoUserSegment}") -``` - - - + ### Java diff --git a/src/content/docs/en/sdk/android/plugins/imei-plugin.mdx b/src/content/docs/en/sdk/android/plugins/imei-plugin.mdx index 945654e89a..08e00da7dc 100644 --- a/src/content/docs/en/sdk/android/plugins/imei-plugin.mdx +++ b/src/content/docs/en/sdk/android/plugins/imei-plugin.mdx @@ -63,7 +63,7 @@ The IMEI and MEID are persistent identifiers. You are responsible for ensuring t Once you have set up the plugin, you can gather the device's IMEI and MEID. To do this, call the `AdjustImei.readImeie` method before starting the Adjust SDK. - + ### Java @@ -73,26 +73,13 @@ AdjustImei.readImei(); Adjust.onCreate(config); ``` - - - -### C# - -```c# -AdjustImei.ReadImei(); -// ... -Adjust.start(config); -``` - - - If you want to prevent the SDK from reading the IMEI and MEID, call the `AdjustImei.doNotReadImei` method. - + ### Java @@ -100,14 +87,5 @@ If you want to prevent the SDK from reading the IMEI and MEID, call the `AdjustI AdjustImei.doNotReadImei(); ``` - - - -### C# - -```c# -AdjustImei.doNotReadImei(); -``` - diff --git a/src/content/docs/en/sdk/android/plugins/oaid-plugin.mdx b/src/content/docs/en/sdk/android/plugins/oaid-plugin.mdx index 12bb6dc60d..24dc3cb2b6 100644 --- a/src/content/docs/en/sdk/android/plugins/oaid-plugin.mdx +++ b/src/content/docs/en/sdk/android/plugins/oaid-plugin.mdx @@ -123,7 +123,7 @@ If you are adding the MSA SDK AAR as a dependency, add the following rules: Once you have set up the plugin, you can gather the device's OAID. To do this, call the `AdjustOaid.readOaid(applicationContext)` method before starting the Adjust SDK. - + ### Java @@ -135,26 +135,13 @@ AdjustOaid.readOaid(applicationContext); Adjust.onCreate(config); ``` - - - -### C# - -```c# -AdjustOaid.ReadOaid(); - -// ... - -Adjust.start(config); -``` - If you want to prevent the SDK from reading the OAID, call the `AdjustOaid.doNotReadOaid()` method. - + ### Java @@ -163,14 +150,5 @@ AdjustOaid.doNotReadOaid(); ``` - - - -### C# - -```c# -AdjustOaid.DoNotReadOaid(); -``` - diff --git a/src/content/docs/en/sdk/android/plugins/sociomatic.mdx b/src/content/docs/en/sdk/android/plugins/sociomatic.mdx index 8ed566f40c..4728cce52b 100644 --- a/src/content/docs/en/sdk/android/plugins/sociomatic.mdx +++ b/src/content/docs/en/sdk/android/plugins/sociomatic.mdx @@ -54,27 +54,7 @@ Once you have installed the Sociomantic plugin, you will have access to the Soci Before sending any Sociomantic events, you should set a partner ID as shown below: - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -[ADJSociomantic injectPartnerIdIntoSociomanticEvents:@"{sociomanticPartnerId}"]; -``` - - - - -### Swift - -```swift -ADJSociomantic.injectPartnerId(intoSociomanticEvents: "{sociomanticPartnerId}") -``` - - - + ### Java @@ -94,39 +74,7 @@ Once you have set your partner ID, you can integrate the different Sociomantic e ### Customer event - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:ANY_TOKEN]; -NSDictionary *customerData = @{ - SCMCustomerID: @"123456" -}; - -[ADJSociomantic injectCustomerDataIntoEvent:event withData:customerData]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: ANY_TOKEN) -let customerData = [ - SCMCustomerID: "123456" -] - -ADJSociomantic.injectCustomerData(into: event, withData: customerData) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -147,33 +95,7 @@ Adjust.trackEvent(event); ### View home page - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:HOMEPAGE_TOKEN]; - -[ADJSociomantic injectHomePageIntoEvent:event]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: HOMEPAGE_TOKEN) - -ADJSociomatic.injectHomePage(into: event) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -190,41 +112,7 @@ Adjust.trackEvent(event); ### View listing - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:LISTING_TOKEN]; -NSArray *categories = @[@"category_1", @"category_2", @"category_3"]; -NSString *date = @"1427792434"; - -[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories]; -// You also can provide a date like this -[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories withDate:date]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: LISTING_TOKEN) -let categories = ["category_1", "category_2", "category_3"] -let date = "1427792434" - -ADJSociomantic.injectViewListing(into: event, withCategories: categories) -// You also can provide a date like this -ADJSociomantic.injectViewListing(into: event, withCategories: categories, withDate: date) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -255,43 +143,7 @@ If you're not sure what setup you should use, please contact your technical acco - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:PRODUCT_VIEW_TOKEN]; -NSDictionary *params = @{ - SCMCategory : @[@"cat1", @"cat2"], - SCMProductName : @"stuff", - SCMDescription : @"pure awesomeness" -}; - -[ADJSociomantic injectViewProductIntoEvent:event productId:@"productId_4" withParameters:params]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: PRODUCT_VIEW_TOKEN) -let params = [ - SCMCategory: ["cat1", "cat2"], - SCMProductName: "stuff", - SCMDescription: "pure awesomeness" -] - -ADJSociomantic.injectViewProduct(into: event, productId: "productId_4", withParameters: params) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -339,59 +191,7 @@ Adjust.trackEvent(event); ### Cart - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:CART_TOKEN]; -NSDictionary *product5 = @{ - SCMAmount : @100, - SCMCurrency : @"EUR", - SCMQuantity : @1, - SCMProductID : @"productId_5", -}; -NSString *product6 = @"productId_6"; -NSDictionary *product7 = @{ - SCMProductID : @"productId_7" -}; - - -NSArray * productList = @[product5, product6, product7]; - -[ADJSociomantic injectCartIntoEvent:event cart:productList]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: CART_TOKEN) -let product5 = [ - SCMAmount: NSNumber(value: 100), - SCMCurrency: "EUR", - SCMQuantity: NSNumber(value: 1), - SCMProductID: "productId_5" -] -let product6 = "productId_6" -let product7 = [ - SCMProductID: "productId_7" -] - - -let productList = [product5, product6, product7] - -ADJSociomantic.injectCart(into: event, cart: productList) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -434,45 +234,7 @@ Adjust.trackEvent(event); ### Unconfirmed transaction - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN]; -NSString *product5 = @"productId_5"; -NSDictionary *product6 = @{ - SCMQuantity : @3, - SCMProductID : @"productId_6" -}; -NSArray * productList = @[product5, product6]; - -[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: TRANSACTION_TOKEN) -let product5 = "productId_5" -let product6 = [ - SCMQuantity: NSNumber(value: 3), - SCMProductID: "productId_6" -] -let productList = [product5, product6] - -ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -501,51 +263,7 @@ Adjust.trackEvent(event); Or with parameters: - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN]; -NSString *product5 = @"productId_5"; -NSDictionary *product6 = @{ - SCMQuantity : @3, - SCMProductID : @"productId_6" -}; -NSArray *productList = @[product5, product6]; -NSDictionary *parameters = @{ - SCMQuantity: @4 // 3 times product6 and 1 product5 -}; - -[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: TRANSACTION_TOKEN) -let product5 = "productId_5" -let product6 = [ - SCMQuantity: NSNumber(value: 3), - SCMProductID: "productId_6" -] -let productList = [product5, product6] -let parameters = [ - SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */) -] - -ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -579,45 +297,7 @@ Adjust.trackEvent(event); ### Confirmed transactions - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN]; -NSString *product5 = @"productId_5"; -NSDictionary *product6 = @{ - SCMQuantity : @3, - SCMProductID : @"productId_6" -}; -NSArray * productList = @[product5, product6]; - -[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: TRANSACTION_TOKEN) -let product5 = "productId_5" -let product6 = [ - SCMQuantity: NSNumber(value: 3), - SCMProductID: "productId_6" -] -let productList = [product5, product6] - -ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -646,51 +326,7 @@ Adjust.trackEvent(event); Or with parameters: - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN]; -NSString *product5 = @"productId_5"; -NSDictionary *product6 = @{ - SCMQuantity : @3, - SCMProductID : @"productId_6" -}; -NSArray *productList = @[product5, product6]; -NSDictionary *parameters = @{ - SCMQuantity: @4 // 3 times product6 and 1 product5 -}; - -[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: TRANSACTION_TOKEN) -let product5 = "productId_5" -let product6 = [ - SCMQuantity: NSNumber(value: 3), - SCMProductID: "productId_6" -] -let productList = [product5, product6] -let parameters = [ - SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */) -] - -ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters) -Adjust.trackEvent(event) -``` - - - + ### Java @@ -735,33 +371,7 @@ Adjust.trackEvent(event); ### Lead event - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN]; - -[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789"]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: LEAD_TOKEN) - -ADJSociomantic.injectLead(into: event, leadID: "123456789") -Adjust.trackEvent(event) -``` - - - + ### Java @@ -779,33 +389,7 @@ Adjust.trackEvent(event); Or confirmed lead: - - -### Objective-C - -```objc -#import "ADJSociomantic.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN]; - -[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789" andConfirmed:YES]; -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: LEAD_TOKEN) - -ADJSociomantic.injectLead(into: event, leadID: "123456789", andConfirmed: true) -Adjust.trackEvent(event) -``` - - - + ### Java diff --git a/src/content/docs/en/sdk/android/plugins/trademob.mdx b/src/content/docs/en/sdk/android/plugins/trademob.mdx index 594e61663b..10fd9b34b9 100644 --- a/src/content/docs/en/sdk/android/plugins/trademob.mdx +++ b/src/content/docs/en/sdk/android/plugins/trademob.mdx @@ -34,46 +34,7 @@ You can also add the plugin as a JAR file from the [releases page](https://githu ### View listing - - -### Objective-C - -```objc -#import "ADJTrademob.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewListingEventToken}"]; - -NSArray *itemIds = @[@"itemId1", @"itemId2", @"itemId3"]; - -NSDictionary *metadata = @{@"info1":@"value1", @"info2":@"value2"}; - -[ADJTrademob injectViewListingIntoEvent:event itemIds:itemIds metadata:metadata]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{viewListingEventToken}") - -let itemIds = ["itemId1", "itemId2", "itemId3"] - -let metadata = [ - "info1": "value1", - "info2": "value2" -] - -ADJTrademob.injectViewListing(into: event, itemIds: itemIds, metadata: metadata) - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -96,42 +57,7 @@ Adjust.trackEvent(event); ### View item - - -### Objective-C - -```objc -#import "ADJTrademob.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewItemEventToken}"]; - -NSDictionary *metadata = @{@"info1":@"value1", @"info2":@"value2"}; - -[ADJTrademob injectViewItemIntoEvent:event itemId:@"itemId" metadata:metadata]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{viewItemEventToken}") - -let metadata = [ - "info1": "value1", - "info2": "value2" -] - -ADJTrademob.injectViewItem(into: event, itemId: "itemId", metadata: metadata) - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -153,45 +79,7 @@ Adjust.trackEvent(event); ### Add to basket - - -### Objective-C - -```objc -#import "ADJTrademob.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{addToBasketEventToken}"]; - -ADJTrademobItem *item1 = [[ADJTrademobItem alloc] initWithId:@"itemId1" price:120.4 quantity:1]; -ADJTrademobItem *item2 = [[ADJTrademobItem alloc] initWithId:@"itemId2" price:20.1 quantity:4]; - -NSArray *items = @[item1, item2]; - -[ADJTrademob injectAddToBasketIntoEvent:event items:items metadata:nil]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{addToBasketEventToken}") - -let item1 = ADJTrademobItem(id: "itemId1", price: 120.4, quantity: 1) -let item2 = ADJTrademobItem(id: "itemId2", price: 20.1, quantity: 4) - -let items = [item1, item2] - -ADJTrademob.injectAddToBasket(into: event, items: items, metadata: nil) - -Adjust.trackEvent(event) -``` - - - + ### Java @@ -215,52 +103,7 @@ Adjust.trackEvent(event); ### Checkout - - -### Objective-C - -```objc -#import "ADJTrademob.h" - -ADJEvent *event = [ADJEvent eventWithEventToken:@"{checkoutEventToken}"]; - -ADJTrademobItem *item1 = [[ADJTrademobItem alloc] initWithId:@"itemId1" price:120.4 quantity:1]; -ADJTrademobItem *item2 = [[ADJTrademobItem alloc] initWithId:@"itemId2" price:20.1 quantity:4]; - -NSArray *items = @[item1, item2]; - -NSDictionary *metadata = @{@"info1":@"value1", @"info2":@"value2"}; - -[ADJTrademob injectCheckoutIntoEvent:event items:items metadata:metadata]; - -[Adjust trackEvent:event]; -``` - - - - -### Swift - -```swift -let event = ADJEvent(eventToken: "{checkoutEventToken}") - -let item1 = ADJTrademobItem(id: "itemId1", price: 120.4, quantity: 1) -let item2 = ADJTrademobItem(id: "itemId2", price: 20.1, quantity: 4) - -let items = [item1, item2] - -let metadata = [ - "info1": "value1", - "info2": "value2" -] - -ADJTrademob.injectCheckout(into: event, items: items, metadata: metadata) - -Adjust.trackEvent(event) -``` - - - + ### Java diff --git a/src/content/docs/en/sdk/android/reference/adjust/index.mdx b/src/content/docs/en/sdk/android/reference/adjust/index.mdx index 09c7ba5723..3f62d5e315 100644 --- a/src/content/docs/en/sdk/android/reference/adjust/index.mdx +++ b/src/content/docs/en/sdk/android/reference/adjust/index.mdx @@ -3,6 +3,7 @@ title: Adjust class description: Use the Adjust class send information about your application and users to Adjust category-title: Adjust class slug: en/sdk/android/reference/adjust +type: category --- The Adjust class can be used to send information about your application and users to Adjust. This can be used for attribution as well as recording events for analytics. diff --git a/src/content/docs/en/sdk/android/reference/index.mdx b/src/content/docs/en/sdk/android/reference/index.mdx index d45a59ad08..ec4bff2655 100644 --- a/src/content/docs/en/sdk/android/reference/index.mdx +++ b/src/content/docs/en/sdk/android/reference/index.mdx @@ -2,5 +2,6 @@ title: SDK reference description: SDK reference information for the Android SDK category-title: Reference -slug: en/sdk/android/reference/index +slug: en/sdk/android/reference +type: category --- diff --git a/src/content/docs/en/sdk/android/setup/preinstall-tool.mdx b/src/content/docs/en/sdk/android/setup/preinstall-tool.mdx index 687848a99f..7e04dbcd97 100644 --- a/src/content/docs/en/sdk/android/setup/preinstall-tool.mdx +++ b/src/content/docs/en/sdk/android/setup/preinstall-tool.mdx @@ -1,7 +1,7 @@ --- title: Adjust Store & Pre-Install Tool description: Set up the Adjust SDK's pre-install tool. -slug: en/sdk/android/configuration/preinstall-tool +slug: en/sdk/android/setup/preinstall-tool --- @@ -36,6 +36,8 @@ All of these tools must by present in your system's `PATH` to run `adjust-dtt`. + + ### Ruby @@ -55,6 +57,10 @@ Follow the instructions for your distribution on the [ruby-lang website](https:/ + + + + ### Apktool @@ -81,6 +87,10 @@ Follow the instructions for your distribution on [the Apktool website](https://i + + + + ### Jarsigner @@ -108,6 +118,8 @@ If you're using the Oracle JDK, follow the instructions on [Oracle's website](ht + + ## Add preinstall tracker information ### Step 1. Get keystore file