このページは Cloud Translation API によって翻訳されました。

開始する

前提条件

Xcode 13 以降

このガイドでは、PAL SDK を呼び出してノンスを受信し、作成できます。ガイドをご覧になるには、 PAL tvOS サンプルアプリケーション:

プロジェクトに PAL SDK を追加する

Swift Package Manager を使用して PAL SDK をインストールする

プログラマティックアクセスライブラリ SDK は、Swift Packages の Manager の新しいバージョンです。詳しくは、 Swift パッケージをインポートする手順は以下のとおりです。

Xcode で、IMA SDK Swift パッケージをインストールします。 [ファイル] >Add Packages...」というメッセージが表示されます。
表示されたプロンプトで、「IMA SDK Swift Package GitHub」を検索します。リポジトリ:
```
https://github.com/googleads/swift-package-manager-google-programmatic-access-library-tvos
```
使用する PAL SDK Swift パッケージのバージョンを選択します。新しいプロジェクトでは、[Up to Next Major Version] を使用することをおすすめします。

完了すると、Xcode はパッケージの依存関係を解決し、バックグラウンドでダウンロードされます。パッケージを追加する方法の詳細依存関係については、以下をご覧ください。 Apple の記事。

PAL SDK を手動でダウンロードしてインストールする

Swift Package Manager を使用しない場合は、PAL SDK をダウンロードして、手動でプロジェクトに追加してください。

PAL SDK for iOS をダウンロードして展開します。
Apple デベロッパーガイドに沿って、プロジェクトにフレームワークを組み込んでください。

ノンスを生成する

「ノンス」は PAL によって生成される単一の暗号化された文字列で、 PALNonceLoader。PAL SDK では、新しいストリームリクエストに毎回返すことができます。ただし、ノンスは複数の広告で再利用できる同じストリーム内の複数のリクエストに対応できます

以下のコードスニペットはすべて、 ViewController.m（ PAL tvOS サンプルアプリケーション。

ノンスをリクエストするには、まず PAL ライブラリをインポートします。

@import ProgrammaticAccessLibrary;

次に、PALNonceLoader のインスタンスを作成し、2 つのスタブを追加します。デリゲートメソッド:

@interface ViewController () <PALNonceLoaderDelegate>
// The nonce loader to use for nonce requests.
@property(nonatomic) PALNonceLoader *nonceLoader;
// The view in which a video would play.
// In this sample, it is mocked for simplification.
@property(nonatomic, weak) IBOutlet UIView *videoView;
@end
...
- (void) viewDidLoad {
  [super viewDidLoad];
  // The default value for 'allowStorage' and
  // 'directedForChildOrUnknownAge' is 'NO', but should be updated once the
  // appropriate consent has been gathered. Publishers should either
  // integrate with a CMP or use a different method to handle storage consent.
  PALSettings *settings = [[PALSettings alloc] init];
  settings.allowStorage = YES;
  settings.directedForChildOrUnknownAge = NO;

  self.nonceLoader = [[PALNonceLoader alloc] initWithSettings:settings];
  self.nonceLoader.delegate = self;
}

#pragma mark - PALNonceLoaderDelegate methods

- (void)nonceLoader:(PALNonceLoader *)nonceLoader
            withRequest:(PALNonceRequest *)request
    didLoadNonceManager:(PALNonceManager *)nonceManager {
}

- (void)nonceLoader:(PALNonceLoader *)nonceLoader
         withRequest:(PALNonceRequest *)request
    didFailWithError:(NSError *)error {
}

次に、ノンスリクエストを開始し、そのプロパティを設定して、ノンスマネージャーを初期化します。

@interface ViewController () <PALNonceLoaderDelegate>
// The nonce loader to use for nonce requests.
@property(nonatomic) PALNonceLoader *nonceLoader;
// The nonce manager result from the last successful nonce request.
@property(nonatomic) PALNonceManager *nonceManager;
// The view in which a video would play. In this sample, it is mocked for
// simplification.
@property(nonatomic, weak) IBOutlet UIView *videoView;
@end

...

- (void)viewDidLoad {
  ...
  self.nonceLoader.delegate = self;
  [self requestNonceManager];
}

...

#pragma mark - UI Callback methods

/**
 * Requests a new nonce manager with a request containing arbitrary test values
 * like a (sane) user might supply. Displays the nonce or error on success. This
 * should be called once per stream.
 *
 * The PALNonceRequest parameters set here are example parameters.
 * You should set your parameters based on your own app characteristics.
 */
- (void)requestNonceManager {
  PALNonceRequest *request = [[PALNonceRequest alloc] init];
  request.continuousPlayback = PALFlagOff;
  request.descriptionURL = [NSURL URLWithString:@"https://example.com/desc?key=val"];
  request.iconsSupported = YES;
  request.playerType = @"AwesomePlayer";
  request.playerVersion = @"4.2.1";
  request.PPID = @"123987456";
  request.sessionID = @"Sample SID";
  // Sample API framework integer. See reference docs for more details.
  NSInteger SampleAPIFramework = 501;
  request.supportedApiFrameworks = [NSMutableSet setWithArray:@[ SampleAPIFramework ]];
  request.videoPlayerHeight = 480;
  request.videoPlayerWidth = 640;
  request.willAdAutoPlay = PALFlagOn;
  request.willAdPlayMuted = PALFlagOff;

  if (self.nonceManager) {
    // Detach the old nonce manager's gesture recognizer before destroying it.
    [self.videoView removeGestureRecognizer:self.nonceManager.gestureRecognizer];
    self.nonceManager = nil;
  }
  [self.nonceLoader loadNonceManagerWithRequest:request];
}

最後に、ノンスローダのデリゲートにデータを入力して、生成されたノンスをログに記録します。

#pragma mark - PALNonceLoaderDelegate methods

- (void)nonceLoader:(PALNonceLoader *)nonceLoader
            withRequest:(PALNonceRequest *)request
    didLoadNonceManager:(PALNonceManager *)nonceManager {
  NSLog(@"Programmatic access nonce: %@", nonceManager.nonce);
  // Capture the created nonce manager and attach its gesture recognizer to the video view.
  self.nonceManager = nonceManager;
  [self.videoView addGestureRecognizer:self.nonceManager.gestureRecognizer];
}

- (void)nonceLoader:(PALNonceLoader *)nonceLoader
         withRequest:(PALNonceRequest *)request
    didFailWithError:(NSError *)error {
  NSLog(@"Error generating programmatic access nonce: %@", error);
}

VAST 直接呼び出し（DVC）を行う場合は、ノンスを givn パラメータ。ノンスは URL セーフであり、URL エンコードの必要はありません。

最後に、コンテンツ再生セッションの送信を処理するメソッドを追加する必要があります。 SDK へのクリックに関する情報が含まれます次の実装例をご覧ください: メソッド sendPlaybackStart、sendPlaybackEnd、sendAdClick:

...

// Reports the start of playback for the current content session.
- (void)sendPlaybackStart {
  [self.nonceManager sendPlaybackStart];
}

// Reports the end of playback for the current content session.
- (void)sendPlaybackEnd {
  [self.nonceManager sendPlaybackEnd];
}

// Reports an ad click for the current nonce manager, if not nil.
- (void)sendAdClick {
  [self.nonceManager sendAdClick];
}

実装では、sendPlaybackStart を動画プレーヤーに対して呼び出す必要があります。開始」イベントに応答して、最初に再生が開始されたときにユーザー開始アクション（Click-to-Play）またはアプリ開始アクション（自動再生）再生が終了したら sendPlaybackEnd を呼び出し、sendAdClick はユーザーが広告をクリックするたびに呼び出すことができます。

（省略可）第三者広告サーバーを介して Google アドマネージャーのシグナルを送信する

第三者広告サーバーからのアドマネージャーのリクエストを設定します。Google Chat の設定次の手順を完了すると、ノンスパラメータが PAL SDK から伝播されます。中継サーバー経由で Google アドマネージャーに送信されますこれにより、 Google アドマネージャーを通じた収益化

第三者の広告サーバーを設定し、サーバーのアドマネージャーに送信します。このスライドは、指定することもできます。

https://pubads.serverside.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&...

詳しくは、Google アドマネージャーのサーバーサイドの実装ガイドをご覧ください。

アドマネージャーでは、givn= を探してノンスの値を識別します。第三者の広告独自のマクロをいくつかサポートする必要があります。 %%custom_key_for_google_nonce%% を実行し、ノンスクエリパラメータに置き換えます。確認します。詳細な手順第三者広告サーバーのドキュメントをご覧ください