From 514f03a813a428f5f891524767ee0e8bde0ccaae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Mon, 21 Jun 2021 11:03:53 +0100 Subject: [PATCH 1/6] Add new admob documentation Replaces #189 --- doc/english/sdk-to-sdk/admob.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 doc/english/sdk-to-sdk/admob.md diff --git a/doc/english/sdk-to-sdk/admob.md b/doc/english/sdk-to-sdk/admob.md new file mode 100644 index 000000000..e0e42ab35 --- /dev/null +++ b/doc/english/sdk-to-sdk/admob.md @@ -0,0 +1,29 @@ +# 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 From 23084daace22d2ae01d4c4707e05c288a17641ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Mon, 21 Jun 2021 11:08:39 +0100 Subject: [PATCH 2/6] Split up comment line --- doc/english/sdk-to-sdk/admob.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/english/sdk-to-sdk/admob.md b/doc/english/sdk-to-sdk/admob.md index e0e42ab35..b721ba677 100644 --- a/doc/english/sdk-to-sdk/admob.md +++ b/doc/english/sdk-to-sdk/admob.md @@ -7,6 +7,7 @@ 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). From 527124329f6abf5501cdf358d995ca6126ccc835 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Fri, 18 Jun 2021 16:13:10 +0100 Subject: [PATCH 3/6] Add documentation for ironSource SDK integration Add documentation for ironSource SDK postbacks. --- doc/english/sdk-to-sdk/ironsource.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 doc/english/sdk-to-sdk/ironsource.md diff --git a/doc/english/sdk-to-sdk/ironsource.md b/doc/english/sdk-to-sdk/ironsource.md new file mode 100644 index 000000000..e574bcc78 --- /dev/null +++ b/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 From 1e64fb1c75c594c22d956f35cc82f95ec6444402 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Fri, 18 Jun 2021 16:09:08 +0100 Subject: [PATCH 4/6] Add AppLovin MAX postback documentation Add documentation for SDK postbacks with AppLovin MAX --- doc/english/sdk-to-sdk/applovin-max.md | 36 ++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 doc/english/sdk-to-sdk/applovin-max.md diff --git a/doc/english/sdk-to-sdk/applovin-max.md b/doc/english/sdk-to-sdk/applovin-max.md new file mode 100644 index 000000000..65533bd8d --- /dev/null +++ b/doc/english/sdk-to-sdk/applovin-max.md @@ -0,0 +1,36 @@ +# 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 +// initialise with AppLovin MAX source +ADJAdRevenue *adjustAdRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; + +// set revenue and currency +[adjustAdRevenue setRevenue:66.6 currency:@"USD"]; + +// optional parameters +[adjustAdRevenue setAdImpressionsCount:10]; +[adjustAdRevenue setAdRevenueNetwork:@"network"]; +[adjustAdRevenue setAdRevenueUnit:@"unit"]; +[adjustAdRevenue setAdRevenuePlacement:@"placement"]; + +// callback & partner parameters +[adjustAdRevenue addCallbackParameter:key value:value]; +[adjustAdRevenue addPartnerParameter:key value:value]; + +// track ad revenue +[Adjust trackAdRevenue:adjustAdRevenue]; +``` + +[ios-readme]: ../../../README.md From 753a0e2db8f4177dc38c46cdd413f6a1985a1bff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= Date: Mon, 21 Jun 2021 10:18:26 +0100 Subject: [PATCH 5/6] Update to new code snippet --- doc/english/sdk-to-sdk/applovin-max.md | 29 ++++++++++---------------- 1 file changed, 11 insertions(+), 18 deletions(-) diff --git a/doc/english/sdk-to-sdk/applovin-max.md b/doc/english/sdk-to-sdk/applovin-max.md index 65533bd8d..18f764fca 100644 --- a/doc/english/sdk-to-sdk/applovin-max.md +++ b/doc/english/sdk-to-sdk/applovin-max.md @@ -13,24 +13,17 @@ If you want to track your ad revenue with the AppLovin MAX SDK, you can use our ### Example ```objc -// initialise with AppLovin MAX source -ADJAdRevenue *adjustAdRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; - -// set revenue and currency -[adjustAdRevenue setRevenue:66.6 currency:@"USD"]; - -// optional parameters -[adjustAdRevenue setAdImpressionsCount:10]; -[adjustAdRevenue setAdRevenueNetwork:@"network"]; -[adjustAdRevenue setAdRevenueUnit:@"unit"]; -[adjustAdRevenue setAdRevenuePlacement:@"placement"]; - -// callback & partner parameters -[adjustAdRevenue addCallbackParameter:key value:value]; -[adjustAdRevenue addPartnerParameter:key value:value]; - -// track ad revenue -[Adjust trackAdRevenue:adjustAdRevenue]; +- (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 From c2dde3d5017ca77a7f07b0ac61166324dae758fb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uglje=C5=A1a=20Erceg?= Date: Mon, 21 Jun 2021 12:11:01 +0200 Subject: [PATCH 6/6] update code style --- doc/english/sdk-to-sdk/applovin-max.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/english/sdk-to-sdk/applovin-max.md b/doc/english/sdk-to-sdk/applovin-max.md index 18f764fca..a02a8e7c3 100644 --- a/doc/english/sdk-to-sdk/applovin-max.md +++ b/doc/english/sdk-to-sdk/applovin-max.md @@ -13,8 +13,7 @@ If you want to track your ad revenue with the AppLovin MAX SDK, you can use our ### Example ```objc -- (void)didPayRevenueForAd:(MAAd *)ad -{ +- (void)didPayRevenueForAd:(MAAd *)ad { ADJAdRevenue *adjustAdRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; adjustAdRevenue.setRevenue(ad.revenue, "USD");