विज्ञापन के नियम

IMA Android SDK टूल, पूरी तरह से ऑटोमेटेड विज्ञापन प्लेलिस्ट के साथ काम करता है. यह सुविधा आपके विज्ञापनों को ट्रैफ़िक करते समय Google Ad Manager में बताए गए तरीके से विज्ञापन में डालते है. यह वीडियो ब्रेक को आसान बनाने के लिए, वीडियो प्लेयर कोड की सुविधा को बहुत आसान भी बनाता है. इसमें प्री-रोल, मिड-रोल और पोस्ट-रोल शामिल हैं.

  • Ad Manager में विज्ञापन दिखाते समय, कई तरह के विज्ञापन नियमों का इस्तेमाल किया जा सकता है, जैसे कि "कॉन्टेंट की शुरुआत में हमेशा विज्ञापन के लिए ब्रेक चलाएं" या "हर 30 मिनट में एक मिनट का विज्ञापन ब्रेक चलाएं".
  • विज्ञापनों का अनुरोध करने पर, विज्ञापन सर्वर किसी विज्ञापन प्लेलिस्ट को वापस कर सकता है. SDK टूल, प्लेलिस्ट को प्रोसेस करता है और तय किए गए विज्ञापन के लिए ब्रेक को अपने-आप शेड्यूल कर देता है.
  • Android, विज्ञापन और कॉन्टेंट प्लेबैक, दोनों के लिए एक ही वीडियो प्लेयर का इस्तेमाल करता है. इसलिए, अगर आपने विज्ञापन से जुड़े नियम लागू करने की योजना बनाई है, तो आपको किसी विज्ञापन के शुरू होने पर अपने वीडियो के प्लेहेड की जगह को सेव करना होगा. इसके बाद, विज्ञापन खत्म होने पर उस पोज़िशन को देखना होगा. अपने वीडियो प्लेयर में VideoAdPlayer इंटरफ़ेस ज़रूर लागू करें. इससे विज्ञापन मैनेजर में बताए गए समय पर, विज्ञापन के लिए ब्रेक अपने-आप डालने की सुविधा चालू हो जाती है. 
    private boolean playingContent = true;
private int contentPosition = -1;
private List callbacks =
    new ArrayList();

@Override
public void addCallback(VideoAdPlayerCallback callback) {
  callbacks.add(callback);
}

@Override
public void removeCallback(VideoAdPlayerCallback callback) {
  callbacks.remove(callback);
}

public void loadContent()
  playingContent = true;
  load(CONTENT_URL);
}

@Override
public void loadAd(String mediaUrl) {
  playingContent = false;
  load(mediaUrl);
}

public void pauseContent() {
  savePosition();
  pause();
}

@Override
public void pauseAd() {
  pause();
}

private void pause() {
  myVideoView.pause();
  for (VideoAdPlayerCallback callback : callbacks) {
    callback.onPause();
  }
}

public void resumeContent() {
  loadContent();
  if (contentPosition > 0) {
    restorePosition();
  }
  resume();
}

@Override
public void resumeAd() {
  resume();
}

private void resume() {
  myVideoView.start();
  for (VideoAdPlayerCallback callback : callbacks) {
    callback.onResume();
  }
}

public void savePosition() {
  contentPosition = myVideoView.getCurrentPosition();
}

public void restorePosition() {
  myVideoView.seekTo(contentPosition);
}
  • CONTENT_PAUSE_REQUESTED और CONTENT_RESUME_REQUESTED इवेंट का इस्तेमाल, विज्ञापन के लिए ब्रेक चलने पर कॉन्टेंट को रोकने और फिर से शुरू करने के लिए किया जाता है. इन इवेंट के बारे में जानकारी पाने के लिए, एपीआई से जुड़े दस्तावेज़ देखें.

ध्यान दें: जब कॉन्टेंट दिखने के बाद उपयोगकर्ता ने प्लेबैक बंद कर दिया हो, तब AdsLoader.contentcomplete को कॉल करना न भूलें. इससे, SDK टूल को यह पता चल सकेगा कि कॉन्टेंट पूरा हो गया है. इसके बाद, अगर शेड्यूल किया गया हो, तो SDK टूल, वीडियो के बाद विज्ञापन के लिए ब्रेक तय करता है. ALL_ADS_COMPLETED इवेंट तब इकट्ठा किया जाता है, जब सभी विज्ञापन ब्रेक चलाए जा चुके हों. इसके अलावा, ध्यान रखें कि कॉन्टेंट ट्रैकिंग init() शुरू होने पर शुरू होती है. इसलिए, कॉन्टेंट चलाने से पहले आपको हमेशा init() को कॉल करना चाहिए.