Merge pull request #553 from adjust/docs_update

Docs update

doc/english/sdk-to-sdk/admob.md

@@ -0,0 +1,30 @@
+# Track AdMob ad revenue with Adjust SDK
+
+[Adjust iOS SDK README][ios-readme]
+
+Minimum SDK version required for this feature:
+
+- **Adjust SDK v4.29.0**
+
+> Note: In order to enable this feature, please reach out to your Google point of contact. Your point of contact will be able to activate the feature for you to access it.
+
+If you want to track your ad revenue with the Admob SDK, you can use our SDK-to-SDK integration to pass this information to the Adjust backend. To do this, you will need to construct an Adjust ad revenue object containing the information you wish to record, then pass the object to the `trackAdRevenue` method.
+
+> Note: If you have any questions about ad revenue tracking with Admob, please contact your dedicated account manager or send an email to [support@adjust.com](mailto:support@adjust.com).
+### Example
+
+```objc
+- (void)requestRewardedAd {
+    self.rewardedAd = [[GADRewardedAd alloc] initWithAdUnitID:@"ad unit ID"];
+    ViewController *strongSelf = weakSelf;
+    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value) {
+        // ...
+        // send ad revenue info to Adjust
+        ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAdMob];
+        [adRevenue setRevenue:value.value currency:value.currencyCode];
+        [Adjust trackAdRevenue:adRevenue];
+    }
+};
+```
+
+[ios-readme]:    ../../../README.md

doc/english/sdk-to-sdk/applovin-max.md

@@ -0,0 +1,28 @@
+# Track AppLovin MAX ad revenue with Adjust SDK
+
+[Adjust iOS SDK README][ios-readme]
+
+Minimum SDK version required for this feature:
+
+- **Adjust SDK v4.29.0**
+
+If you want to track your ad revenue with the AppLovin MAX SDK, you can use our SDK-to-SDK integration to pass this information to the Adjust backend. To do this, you will need to construct an Adjust ad revenue object containing the information you wish to record, then pass the object to the `trackAdRevenue` method.
+
+> Note: If you have any questions about ad revenue tracking with AppLovin MAX, please contact your dedicated account manager or send an email to [support@adjust.com](mailto:support@adjust.com).
+
+### Example
+
+```objc
+- (void)didPayRevenueForAd:(MAAd *)ad {
+    ADJAdRevenue *adjustAdRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX];
+
+    adjustAdRevenue.setRevenue(ad.revenue, "USD");
+    adjustAdRevenue.setAdRevenueNetwork(ad.networkName);
+    adjustAdRevenue.setAdRevenueUnit(ad.adUnitIdentifier);
+    adjustAdRevenue.setAdRevenuePlacement(ad.placement);
+
+    Adjust.trackAdRevenue(adjustAdRevenue);
+}
+```
+
+[ios-readme]:    ../../../README.md

doc/english/sdk-to-sdk/ironsource.md

@@ -0,0 +1,28 @@
+# Track ironSource ad revenue with Adjust SDK
+
+[Adjust iOS SDK README][ios-readme]
+
+Minimum SDK version required for this feature:
+
+- **Adjust SDK v4.29.0**
+
+If you want to track your ad revenue with the ironSource SDK, you can use our SDK-to-SDK integration to pass this information to the Adjust backend. To do this, you will need to construct an Adjust ad revenue object containing the information you wish to record, then pass the object to the `trackAdRevenue` method.
+
+> Note: If you have any questions about ad revenue tracking with ironSource, please contact your dedicated account manager or send an email to [support@adjust.com](mailto:support@adjust.com).
+
+### Example
+
+```objc
+- (void)impressionDataDidSucceed:(ISImpressionData *)impressionData {
+    ADJAdRevenue *adjustAdRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceIronSource];
+    [adjustAdRevenue setRevenue:impressionData.revenue currency:@"USD"];
+    // optional fields
+    [adjustAdRevenue setAdRevenueNetwork:impressionData.ad_network];
+    [adjustAdRevenue setAdRevenueUnit:impressionData.ad_unit];
+    [adjustAdRevenue setAdRevenuePlacement:impressionData.placement];
+    // track Adjust ad revenue
+    [Adjust trackAdRevenue:adjustAdRevenue];
+}
+```
+
+[ios-readme]:    ../../../README.md