きめ細かなネットワークトラフィック制御

リクエスト処理ポリシー

Braze では、ユーザーに対し、以下のプロトコルを使用してネットワーク トラフィックを制御するオプションが提供されます。

自動リクエスト処理

ABKRequestProcessingPolicy 列挙値: ABKAutomaticRequestProcessing

• これがデフォルトのリクエストポリシー値です。
• Braze SDK では、以下を含むすべてのサーバー通信が自動的に処理されます。
  • カスタムイベントと属性データの Braze サーバーへのフラッシュ
  • コンテンツカードとジオフェンスの更新
  • 新しいアプリ内メッセージのリクエスト
• アプリ内メッセージなどの Braze 機能にユーザー向けデータが必要である場合に、即時サーバーリクエストが実行されます。
• サーバーの負荷を最小限に抑えるため、Braze では新規ユーザーデータの定期フラッシュが数秒ごとに実行されます。

データは、次の方法を使用して、いつでも手動で Braze サーバーにフラッシュできます。

• objective-c
• swift

1
[[Appboy sharedInstance] flushDataAndProcessRequestQueue];

1
Appboy.sharedInstance()?.flushDataAndProcessRequestQueue()

手動リクエスト処理

ABKRequestProcessingPolicy 列挙値: ABKManualRequestProcessing

• このプロトコルは、次の点を除いて自動リクエスト処理と同じです。
  • カスタム属性とカスタムイベントデータが、ユーザーセッションを通じてサーバーに自動でフラッシュされません。
• Braze で、アプリ内メッセージのリクエスト、アプリ内メッセージの Liquid テンプレート、ジオフェンス、位置情報の追跡などの内部機能に対する自動ネットワークリクエストが実行されます。詳細については、Appboy.h で ABKRequestProcessingPolicy の宣言を参照してください。これらの内部リクエストが実行されると、リクエストのタイプによっては、ローカルに保存されたカスタム属性とカスタムイベントデータが Braze サーバーにフラッシュされる場合があります。

データは、次の方法を使用して、いつでも手動で Braze サーバーにフラッシュできます。

• objective-c
• swift

1
[[Appboy sharedInstance] flushDataAndProcessRequestQueue];

1
Appboy.sharedInstance()?.flushDataAndProcessRequestQueue()

リクエスト処理ポリシーの設定

起動時のリクエストポリシーの設定

これらのポリシーは、アプリの起動時に startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions メソッドから設定できます。appboyOptions ディクショナリで、次のコードスニペットに示すように ABKRequestProcessingPolicyOptionKey を設定します。

• objective-c
• swift

1
2
3
4
NSDictionary *appboyOptions = @{
  // Other entries
  ABKRequestProcessingPolicyOptionKey : @(ABKAutomaticRequestProcessing)
};

1
2
3
4
let appboyOptions: [AnyHashable: Any] = [
  // Other entries
  ABKRequestProcessingPolicyOptionKey: ABKRequestProcessingPolicy.automaticRequestProcessing.rawValue
]

実行時のリクエストポリシーの設定

リクエスト処理ポリシーは、requestProcessingPolicy プロパティを Appboy で使用することで実行時に設定することもできます。

• objective-c
• swift

1
2
// Sets the request processing policy to automatic (the default value)
[Appboy sharedInstance].requestProcessingPolicy = ABKAutomaticRequestProcessing;

1
2
// Sets the request processing policy to automatic (the default value)
Appboy.sharedInstance()?.requestProcessingPolicy = ABKRequestProcessingPolicy.automaticRequestProcessing

実行中のサーバー通信の手動シャットダウン

「実行中」のサーバー通信を停止する必要がある場合は、次のメソッドを呼び出す必要があります。

• objective-c
• swift

1
[[Appboy sharedInstance] shutdownServerCommunication];

1
Appboy.sharedInstance()?.shutdownServerCommunication();

このメソッドを呼び出した後、リクエスト処理モードを自動にリセットする必要があります。そのため、OS がバックグラウンドタスクなどの停止を強制している場合にのみ、これを呼び出すことをお勧めします。