# 入门指南

## 开始

要展示Adx3广告，第一步就是将Adx3移动广告SDK集成到应用中。集成广告SDK后，您可以继续植入一种或者多种支持的广告格式

## 前提条件

* 使用 Xcode 13.4.1 或者更高版本
* 以 iOS 10.0 或者更高版本为目标平台
* 推荐：管理端后台申请 SDK 和广告位 ID

## 导入移动广告SDK

1.下载SDK：

<https://pub-block.s3.ap-east-1.amazonaws.com/base/202306/4fd9e3ee1bfc0c6b.zip>

2.解压 SDK 框架，然后将以下框架导入您的 Xcode 项目：

* Adx3Framework.framework

3.在项目的 build 设置中，将 `-ObjC` 链接器标志添加到 **Other Linker Flags**：

<figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2F5pqUSmJLSHvrCLRJUCuN%2Fimage.png?alt=media&#x26;token=f425bc7d-f202-407a-8f73-5ce558ab693a" alt=""><figcaption></figcaption></figure>

## 更新您的 Info.plist 文件

更新应用的 Info.plist 文件添加以下键：

```
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
```

## 初始化广告 SDK

在加载广告之前，请在 <mark style="color:blue;">\[Adx3AdManager sharedManager]</mark> 上调用 initWithAppId:(NSString \*)appId success:(isSuccess)success 方法，该方法将初始化 SDK，并在初始化完成之后，回调初始化的结果。此操作仅需执行一次，最好是在应用启动时执行。建议您尽早调用 initWithAppId:(NSString \*)appId success:(isSuccess)success

以下示例展示了如何在 Appdelegate 中调用 initWithAppId:(NSString \*)appId success:(isSuccess)success 方法

#### AppDelegate.m 示例

{% tabs %}
{% tab title="Swift" %}

```swift
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        Adx3AdManager.shared().initWithAppId("Your App ID") { isSuccess in
            //result handler
        }
        // Override point for customization after application launch.
        return true
    }
    
    func applicationDidBecomeActive(_ application: UIApplication) {
        Adx3AdManager.shared().applicationDidBecomeActive(application)
    }
    
    func applicationDidEnterBackground(_ application: UIApplication) {
        Adx3AdManager.shared().applicationDidEnterBackground(application)
    }
   
}
```

{% endtab %}

{% tab title="Objective-C" %}

```objectivec
#import "Adx3Framework/Adx3Ad.h"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [[Adx3AdManager sharedManager] initWithAppId:@"Your App ID" success:^(BOOL isSuccess) {
       //result handler
    }];
    return YES;
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
    [[Adx3AdManager sharedManager] applicationDidBecomeActive:application];
}

- (void)applicationDidEnterBackground:(UIApplication *)application {
    [[Adx3AdManager sharedManager] applicationDidEnterBackground:application];
}


@end
```

{% endtab %}
{% endtabs %}

## 选择广告格式

### 开屏

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2FLoGjvbWJ8qZYRrWEikre%2F%E5%BC%80%E5%B1%8F%E5%B9%BF%E5%91%8A.png?alt=media&#x26;token=3de3ec16-9d08-4168-b2af-83ecfe100722" alt=""><figcaption></figcaption></figure></div>

开屏广告是一种特殊的广告格式，适合希望通过应用启动时加载广告的发布商。用户可以随时关闭开屏广告。

[植入开屏广告](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/kai-ping-guang-gao)

### 横幅

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2FUtK7nBOesqhdTHD7mPST%2F%E6%A8%AA%E5%B9%85%E5%B9%BF%E5%91%8A.png?alt=media&#x26;token=50c06e35-805f-462f-ade6-3586ae083b92" alt=""><figcaption></figcaption></figure></div>

横幅广告是在设备屏幕的顶部或底部展示的矩形广告。 用户与应用互动时，横幅广告会停留在屏幕上，并且可在一段时间后自动刷新。

[植入横幅广告](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/heng-fu-guang-gao)

### 插屏

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2FOsvFI6GPzA3eqPz8TAmh%2F%E6%8F%92%E5%B1%8F%E5%B9%BF%E5%91%8A.png?alt=media&#x26;token=ddb48bc2-85bb-4245-a4b3-da72db9e502b" alt=""><figcaption></figcaption></figure></div>

覆盖应用界面的全屏广告，直到用户将其关闭。 它们最适合在应用执行流程中的自然暂停位置展示，例如游戏关卡之间或是用户刚完成一项任务之后。

[<mark style="color:blue;">植入插页式广告</mark>](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/cha-ping-guang-gao)

### 原生

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2Fo9mDtu4fsrbinvEs1rsL%2F%E5%8E%9F%E7%94%9F%E5%B9%BF%E5%91%8A.png?alt=media&#x26;token=5328f0d2-665b-4db6-ac4d-fe96e63484a5" alt=""><figcaption></figcaption></figure></div>

与您的应用外观和风格相符的可定制广告。您可以决定这类广告的投放方式和位置，从而使布局与应用的设计更加一致。

[<mark style="color:blue;">植入原生广告</mark>](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/yuan-sheng-guang-gao)

### 激励

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2F3FPmOGCQUKm4QtwoPydR%2F%E6%BF%80%E5%8A%B1%E8%A7%86%E9%A2%91.png?alt=media&#x26;token=acbd3540-cd5b-4518-86de-f64e19f35e61" alt=""><figcaption></figcaption></figure></div>

为观看短视频和与试玩广告及问卷调查互动的用户予以奖励的广告。适合通过免费游戏用户创收。

[植入激励广告](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/ji-li-guang-gao)

## 多重

<div align="left"><figure><img src="https://3612726722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F79UQRI7S2eHbTf7duI78%2Fuploads%2FoKuDLuTUV5lYHkbrnw7x%2F%E5%A4%9A%E9%87%8D%E5%B9%BF%E5%91%8A.png?alt=media&#x26;token=acd1f559-868d-4f02-b681-3ff136d8f778" alt=""><figcaption></figcaption></figure></div>

为列表或瀑布流布局定制的广告。

[植入多重广告](https://docs.adx3.io/copy-of-cn/jie-kou-wen-dang/ios/guang-gao-ge-shi/duo-chong-guang-gao)