SDK टूल की डेटिंग से जुड़ाव: तीसरे पक्ष के तकनीकी इंटिग्रेशन के निर्देश

Google, उपयोगकर्ता के डिवाइस पर एक ऐसा प्लैटफ़ॉर्म बना रहा है जो वर्टिकल के हिसाब से ऐप्लिकेशन साथ ही, उपयोगकर्ताओं को उनके हिसाब से कॉन्टेंट देखने का बेहतर अनुभव मिलता है. खोजने के लिए इस्तेमाल किया जा सकता है. फ़ुलस्क्रीन वाले इस अनुभव से डेवलपर पार्टनर को अपना सबसे अच्छा रिच कॉन्टेंट दिखाने का मौका ऐप्लिकेशन के बारे में ज़्यादा जानकारी मौजूद है.इस गाइड में डेवलपर पार्टनर के लिए, ऐसे निर्देश दिए गए हैं जो अपने डेटिंग कॉन्टेंट को इंटिग्रेट कर सकते हैं. इसके लिए, Engage SDK टूल का इस्तेमाल कर सकते हैं सरफ़ेस एरिया.

इंटिग्रेशन की जानकारी

शब्दावली

इस इंटिग्रेशन में ये तीन तरह के क्लस्टर शामिल होते हैं: सुझाव, चुनिंदा, और जारी रखें.

• सुझाव क्लस्टर में, आपके हिसाब से डेटिंग के सुझाव दिखाए जाते हैं को भी ऐक्सेस किया जा सकता है. ये सुझाव उपयोगकर्ता के हिसाब से बनाया गया है.

  • सुझावों के क्लस्टर को ArticleEntity, PersonEntity, या EventEntity हो, लेकिन अलग-अलग तरह की इकाइयों का मिला-जुला रूप न हो.

  आपके सुझावों के लिए यह तरीका अपनाया जाता है:

  • सुझाव क्लस्टर: ऐसा यूज़र इंटरफ़ेस (यूआई) व्यू जिसमें सुझाव देख सकते हैं.

  • इकाई: क्लस्टर में किसी एक आइटम को दिखाने वाला ऑब्जेक्ट. यह इंटिग्रेशन के लिए कुछ ऐसी इकाइयां उपलब्ध कराई जाती हैं जिन्हें सुझाव क्लस्टर:

    • articleEntity: लेखEntity, Search Console से मिला सुझाव डेटिंग से जुड़ा टेक्स्ट-आधारित कॉन्टेंट. लेख में शामिल आइटम डेवलपर को अलग-अलग तरह का टेक्स्ट और इमेज कॉन्टेंट उपलब्ध कराने की सुविधा देता है उपयोगकर्ताओं को जानकारी देने के लिए ज़्यादा मेटाडेटा जोड़ा जा सकता है.

      

    • PersonEntity: PersonEntity से किसी व्यक्ति की जानकारी मिलती है. कॉन्टेंट बनाने इन सुझावों में किसी व्यक्ति की डेट के बारे में बताया जा सकता है. उम्मीदें.

      

    • EventEntity: EventEntity में ऐसा इवेंट है आने वाले समय में इस्तेमाल करें. इवेंट की शुरुआत का समय एक अहम जानकारी है, जो उपयोगकर्ताओं को बताया जाना चाहिए.

      

• कंटिन्युएशन क्लस्टर में, हाल ही में इन उपयोगकर्ताओं का कॉन्टेंट दिखाया जाता है: एक यूज़र इंटरफ़ेस (यूआई) ग्रुपिंग में कई डेवलपर पार्टनर. हर डेवलपर पार्टनर इस प्रोसेस में, ज़्यादा से ज़्यादा 10 इकाइयों के ब्रॉडकास्ट की अनुमति दी जाएगी क्लस्टर.

  आपके मौजूदा कॉन्टेंट को इस तरह का बनाया जा सकता है:

  • articleEntity: लेखEntity, Search Console से मिला सुझाव डेटिंग से जुड़ा टेक्स्ट-आधारित कॉन्टेंट. इस इकाई का इस्तेमाल इन कामों के लिए किया जा सकता है ऐसे अधूरे समाचार लेख या अन्य कॉन्टेंट दिखाते हों जिन्हें उपयोगकर्ता करना जारी रखना है, जहां से उन्होंने उसे छोड़ा था.

    

  • EventReservationEntity: EventReservationEntity से पता चलता है किसी इवेंट के लिए बुकिंग करना और आने वाले या मौजूदा इवेंट को ट्रैक करने में उपयोगकर्ताओं की मदद करना डेटिंग और मीटअप इवेंट की बुकिंग.

    

• चुनिंदा क्लस्टर एक यूज़र इंटरफ़ेस (यूआई) व्यू है, जो चुने गए हीरो को दिखाता है एक यूज़र इंटरफ़ेस (यूआई) ग्रुपिंग में कई डेवलपर पार्टनर से GenericFeaturedEntity. इसमें एक चुनिंदा क्लस्टर है, जो यूज़र इंटरफ़ेस (यूआई) की इमेज, जिसमें सुझावों वाले सभी क्लस्टर के ऊपर प्राथमिकता दी गई है. हर डेवलपर पार्टनर को चुनिंदा में प्रकार, यहां से कई इकाइयों (अलग-अलग प्रकार की) के साथ चुनिंदा क्लस्टर में एक से ज़्यादा ऐप्लिकेशन डेवलपर शामिल होंगे.

  • जेनेरिक फ़ीचर की गई इकाई: जेनेरिक विशेषता इकाई इनसे अलग है उस चुनिंदा आइटम में सुझाया गया आइटम, किसी एक आइटम के लिए इस्तेमाल किया जाना चाहिए डेवलपर की ओर से सबसे ज़्यादा बार मिलने वाला कॉन्टेंट शामिल होना चाहिए. अहम कॉन्टेंट बनाना चाहिए, जो उपयोगकर्ताओं के लिए दिलचस्प और काम का हो.

    

सेशन की तैयारी

कम से कम एपीआई लेवल: 19

अपने ऐप्लिकेशन में com.google.android.engage:engage-core लाइब्रेरी जोड़ें:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

खास जानकारी

इसे बनाने का काम बाउंड सेवा.

क्लाइंट के पब्लिश किए जा सकने वाले डेटा पर, नीचे दी गई सीमाएं लागू होती हैं. ये सीमाएं, क्लस्टर के टाइप:

पहला चरण: इकाई का डेटा देना

SDK टूल ने हर तरह के आइटम को दिखाने के लिए अलग-अलग इकाइयां तय की हैं. हम सहायता करते हैं डेटिंग कैटगरी के लिए ये इकाइयां:

1. GenericFeaturedEntity
2. ArticleEntity
3. PersonEntity
4. EventEntity
5. EventReservationEntity

नीचे दिए गए चार्ट में हर तरह के एट्रिब्यूट और उनकी ज़रूरी शर्तों के बारे में बताया गया है.

GenericFeaturedEntity

ArticleEntity

PersonEntity

EventEntity

EventReservationEntity

इमेज की जानकारी

इमेज ऐसेट के लिए ज़रूरी जानकारी इस टेबल में दी गई है:

इमेज को सार्वजनिक सीडीएन पर होस्ट करना ज़रूरी है, ताकि Google उन्हें ऐक्सेस कर सके उन्हें.

फ़ाइल फ़ॉर्मैट

PNG, JPG, स्टैटिक GIF, WebP

फ़ाइल का ज़्यादा से ज़्यादा साइज़

5120 केबी

अन्य सुझाव

• इमेज के लिए सुरक्षित जगह: अपने मुख्य कॉन्टेंट को इमेज के बीच वाले 80% हिस्से में रखें इमेज.
• पारदर्शी बैकग्राउंड का इस्तेमाल करें, ताकि इमेज ठीक से दिख सके गहरे और हल्के रंग वाली थीम की सेटिंग.

सामग्री श्रेणी

कॉन्टेंट की कैटगरी के हिसाब से, ऐप्लिकेशन को एक से ज़्यादा श्रेणियां. यह कॉन्टेंट को पहले से तय की गई कुछ कैटगरी के साथ मैप करता है, जैसे कि:

• TYPE_EDUCATION
• TYPE_SPORTS
• TYPE_MOVIES_AND_TV_SHOWS
• TYPE_BOOKS
• TYPE_AUDIOBOOKS
• TYPE_MUSIC
• TYPE_DIGITAL_GAMES
• TYPE_TRAVEL_AND_LOCAL
• TYPE_HOME_AND_AUTO
• TYPE_BUSINESS
• TYPE_NEWS
• TYPE_FOOD_AND_DRINK
• TYPE_SHOPPING
• TYPE_HEALTH_AND_FITENESS
• TYPE_MEDICAL
• TYPE_PARENTING
• TYPE_DATING

इमेज को सार्वजनिक सीडीएन पर होस्ट करना ज़रूरी है, ताकि Google उन्हें ऐक्सेस कर सके उन्हें.

कॉन्टेंट की कैटगरी इस्तेमाल करने से जुड़े दिशा-निर्देश

1. लेखEntity और जेनेरिक विशेषता इकाई जैसी कुछ इकाइयां उनके लिए कॉन्टेंट की किसी भी कैटगरी का इस्तेमाल किया जा सकता है. इस तरह की दूसरी इकाइयों के लिए EventEntity, EventReservationEntity, PersonEntity, सिर्फ़ एक सबसेट इनमें से कैटगरी के प्रॉडक्ट ज़रूरी शर्तें पूरी करते हैं. ज़रूरी शर्तें पूरी करने वाली कैटगरी की सूची देखें इकाई का टाइप डालें.

2. कॉम्बिनेशन के बजाय, कॉन्टेंट की कुछ कैटगरी के लिए इकाई के खास टाइप का इस्तेमाल करें को सामान्य इकाइयों और ContentCategory के हिसाब से बनाना होगा:

   • TYPE_MOVIES_AND_TV_SHOWS - यहां से इकाइयां देखें पहले इंटिग्रेशन गाइड देखें सामान्य इकाइयां.
   • TYPE_BOOKS - EbookEntity का इस्तेमाल करने से पहले सामान्य इकाइयां.
   • TYPE_AUDIOBOOKS - देखें पहले AudiobookEntity का इस्तेमाल किया जा रहा हो सामान्य इकाइयों का इस्तेमाल करके.
   • TYPE_SHOPPING - चेक आउट ShoppingEntity पहले सामान्य इकाइयों का इस्तेमाल करके.
   • TYPE_FOOD_AND_DRINK - यहां से इकाइयां देखें इस्तेमाल करने से पहले फ़ूड इंटिग्रेशन गाइड सामान्य इकाइयां.

3. ContentCategory फ़ील्ड वैकल्पिक है और इसे खाली छोड़ा जाना चाहिए अगर: कॉन्टेंट, ऊपर बताई गई किसी भी कैटगरी से न जुड़ा हो.

4. अगर कॉन्टेंट की एक से ज़्यादा कैटगरी दी गई हैं, तो उन्हें उसी क्रम में डालें सबसे काम के कॉन्टेंट की कैटगरी को शामिल किया गया है सूची में पहले नंबर पर हैं.

दूसरा चरण: क्लस्टर डेटा उपलब्ध कराना

हमारा सुझाव है कि बैकग्राउंड में कॉन्टेंट पब्लिश करने का काम करें उदाहरण के लिए, WorkManager का इस्तेमाल करके और नियमित आधार पर या किसी इवेंट के आधार पर शेड्यूल किया गया हो. उदाहरण के लिए, हर बार उपयोगकर्ता ऐप्लिकेशन खोलता है या जब उपयोगकर्ता ने अपने कार्ट में कुछ जोड़ा होता है).

क्लस्टर पब्लिश करने की ज़िम्मेदारी AppEngagePublishClient की है.

क्लाइंट में क्लस्टर पब्लिश करने के लिए, यहां दिए गए एपीआई हैं:

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishContinuationCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteContinuationCluster
• deleteUserManagementCluster
• deleteClusters

isServiceAvailable

इस एपीआई का इस्तेमाल यह पता लगाने के लिए किया जाता है कि सेवा, इंटिग्रेशन और कि कॉन्टेंट को डिवाइस पर दिखाया जा सकता है या नहीं.

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

इस एपीआई का इस्तेमाल, RecommendationCluster ऑब्जेक्ट की सूची को पब्लिश करने के लिए किया जाता है.

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:

• डेवलपर पार्टनर से मिला, RecommendationCluster का मौजूदा डेटा हटा दिया जाता है.
• अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए सुझाव में सेव किया जाता है क्लस्टर.

कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.

publishFeaturedCluster

इस एपीआई का इस्तेमाल, FeaturedCluster ऑब्जेक्ट की सूची को पब्लिश करने के लिए किया जाता है.

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:

• डेवलपर पार्टनर से मिला, FeaturedCluster का मौजूदा डेटा हटा दिया जाता है.
• अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए चुनिंदा क्लस्टर में स्टोर किया जाता है.

कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.

publishContinuationCluster

इस एपीआई का इस्तेमाल, ContinuationCluster ऑब्जेक्ट को पब्लिश करने के लिए किया जाता है.

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:

• डेवलपर पार्टनर से मिला, ContinuationCluster का मौजूदा डेटा हटा दिया जाता है.
• अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए कंटिन्युएशन में स्टोर किया जाता है क्लस्टर.

कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.

publishUserAccountManagementRequest

इस एपीआई का इस्तेमाल साइन इन कार्ड को पब्लिश करने के लिए किया जाता है . साइन इन करने की कार्रवाई उपयोगकर्ता को यहां ले जाएगी: ऐप्लिकेशन के साइन इन पेज पर, ताकि ऐप्लिकेशन कॉन्टेंट पब्लिश कर सके (या ज़्यादा जानकारी उपलब्ध करा सके) आपके हिसाब से बनाया गया कॉन्टेंट)

नीचे दिया गया मेटाडेटा, साइन इन कार्ड का हिस्सा है -

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:

• डेवलपर पार्टनर से मिला मौजूदा UserAccountManagementCluster डेटा यह है हटाया गया.
• अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए UserAccountManagementCluster क्लस्टर.

कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.

updatePublishStatus

अगर किसी अंदरूनी कारोबारी वजह से, कोई भी क्लस्टर पब्लिश नहीं किया जाता है, तो हम खास तौर पर सुझाव दें कि updateपब्लिशStatus एपीआई. ऐसा इसलिए ज़रूरी है, क्योंकि :

• कॉन्टेंट पब्लिश होने के बाद भी, हर स्थिति में स्टेटस देना (STATUS == पब्लिश किया गया), इसका इस्तेमाल करने वाले डैशबोर्ड को भरने के लिए ज़रूरी है स्टेटस के बारे में भी बताएं.
• अगर कोई कॉन्टेंट पब्लिश नहीं हुआ है, लेकिन इंटिग्रेशन की स्थिति सही से काम नहीं करती है (STATUS == NOT_PUBLISHED), Google ऐप्लिकेशन में चेतावनियों को ट्रिगर होने से रोक सकता है हेल्थ डैशबोर्ड्स. यह पुष्टि करता है कि कॉन्टेंट को पब्लिश नहीं करने की वजह से उम्मीद के मुताबिक स्थिति हो सकती है.
• इससे डेवलपर को यह इनसाइट देने में मदद मिलती है कि डेटा कब पब्लिश किया गया है और कब नहीं.
• Google इन स्टेटस कोड का इस्तेमाल करके, उपयोगकर्ता को कुछ कार्रवाइयां करने के लिए कह सकता है ताकि वे ऐप्लिकेशन का कॉन्टेंट देख सकें या उससे उबर सकें.

पब्लिश करने की मंज़ूरी की स्थिति वाले कोड की सूची यहां दी गई है :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

अगर कॉन्टेंट को पब्लिश नहीं किया गया है, क्योंकि उपयोगकर्ता ने लॉग इन नहीं किया है, तो Google हमारा सुझाव है कि आप साइन इन कार्ड को पब्लिश करें. अगर किसी वजह से, सेवा देने वाली कंपनियां तो हमारा सुझाव है कि आप updatePublishStatus स्टेटस कोड के साथ एपीआई NOT_PUBLISHED_REQUIRES_SIGN_IN

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

इस एपीआई का इस्तेमाल, सुझाव क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.

client.deleteRecommendationClusters()

client.deleteRecommendationClusters();

जब सेवा को अनुरोध मिलता है, तो वह सुझाव क्लस्टर. कोई गड़बड़ी होने पर, पूरे अनुरोध को अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.

deleteFeaturedCluster

इस एपीआई का इस्तेमाल, चुनिंदा क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.

client.deleteFeaturedCluster()

client.deleteFeaturedCluster();

जब सेवा को अनुरोध मिलता है, तो वह चुनिंदा क्लस्टर. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.

deleteContinuationCluster

इस एपीआई का इस्तेमाल, कंटिन्युएशन क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.

client.deleteContinuationCluster()

client.deleteContinuationCluster();

जब सेवा को अनुरोध मिलता है, तो वह कंटिन्यूएशन क्लस्टर. कोई गड़बड़ी होने पर, पूरे अनुरोध को अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.

deleteUserManagementCluster

इस एपीआई का इस्तेमाल UserAccountManagement Cluster का कॉन्टेंट मिटाने के लिए किया जाता है.

client.deleteUserManagementCluster()

client.deleteUserManagementCluster();

जब सेवा को अनुरोध मिलता है, तो वह UserAccountManagement क्लस्टर. किसी गड़बड़ी की स्थिति में, पूरे अनुरोध को अस्वीकार कर दिया गया है और मौजूदा स्थिति में बदलाव नहीं किया गया है.

deleteClusters

इस एपीआई का इस्तेमाल किसी खास तरह के क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

जब सेवा को अनुरोध मिलता है, तो वह सभी सेवाओं से मौजूदा डेटा हटा देती है किसी खास तरह के क्लस्टर से मिलते-जुलते क्लस्टर. क्लाइंट इनमें से किसी एक तरीके को कई तरह के क्लस्टर हैं. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.

गड़बड़ी ठीक करना

हमारा सुझाव है कि आप Publishing API की मदद से बनाए गए टास्क के नतीजे को सुनें कि किसी सफल टास्क को वापस पाने और उसे फिर से सबमिट करने के लिए, फ़ॉलो-अप कार्रवाई की जा सकती है.

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

गड़बड़ी को AppEngageException के तौर पर दिखाया जाता है. इसके लिए, वजह भी बताई जाती है गड़बड़ी कोड.

तीसरा चरण: ब्रॉडकास्ट के इंटेंट मैनेज करना

किसी जॉब के ज़रिए, Publishing Content API कॉल करने के अलावा, यह सेट अप करने के लिए ज़रूरी है पाने के लिए BroadcastReceiver कॉन्टेंट पब्लिश करने का अनुरोध सबमिट करें.

ब्रॉडकास्ट इंटेंट का मकसद, मुख्य रूप से ऐप्लिकेशन को फिर से चालू करना और डेटा को ज़बरदस्ती लागू करना है सिंक. ब्रॉडकास्ट के इंटेंट, इस तरह से डिज़ाइन नहीं किए जाते कि उन्हें समय-समय पर भेजा जा सके. यह सिर्फ़ यह तब ट्रिगर होता है, जब Engage सेवा यह तय करती है कि कॉन्टेंट पुराना है या नहीं (इसके लिए उदाहरण के लिए, एक हफ़्ते पुराना). इस तरह, विज्ञापन देखने वाले को भरोसा होगा कि वह आपको एक नया कॉन्टेंट अनुभव मिलेगा, भले ही ऐप्लिकेशन को लंबे समय तक रोका है.

BroadcastReceiver को इन दो तरीकों से सेट अप किया जाना चाहिए:

• BroadcastReceiver क्लास के इंस्टेंस को डाइनैमिक तौर पर रजिस्टर करने के लिए, इनका इस्तेमाल करें Context.registerReceiver(). इसकी मदद से, ऐप्लिकेशन के ज़रिए बातचीत की जा सकती है जो अब भी मेमोरी में हैं.

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}

• अपने<receiver> AndroidManifest.xml फ़ाइल. इससे ऐप्लिकेशन को ब्रॉडकास्ट मिलने लगता है इंटेंट, जब वह नहीं चल रहा होता है, और ऐप्लिकेशन को प्रकाशित करने की अनुमति भी देता है या वीडियो कॉन्टेंट.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

ये इंटेंट सेवा:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION इसका सुझाव दिया जाता है इस इंटेंट के मुताबिक, publishRecommendationClusters कॉल शुरू करें.
• com.google.android.engage.action.PUBLISH_FEATURED हमारा सुझाव है कि आप यह इंटेंट मिलने पर, publishFeaturedCluster कॉल करें.
• com.google.android.engage.action.PUBLISH_CONTINUATION हमारा सुझाव है कि आप यह इंटेंट मिलने पर, publishContinuationCluster कॉल करें.

एकीकरण वर्कफ़्लो

इंटिग्रेशन पूरा हो जाने के बाद, उसकी पुष्टि करने से जुड़े सिलसिलेवार निर्देश के लिए, देखें डेवलपर इंटिग्रेशन वर्कफ़्लो का इस्तेमाल करना.

अक्सर पूछे जाने वाले सवाल

इनके बारे में जानने के लिए, जुड़ाव वाले SDK टूल के बारे में अक्सर पूछे जाने वाले सवाल देखें अक्सर पूछे जाने वाले सवाल.

संपर्क

संपर्क जानकारी engagement-developers@google.com पर, अगर वहां इंटिग्रेशन के दौरान पूछे गए किसी भी सवाल का जवाब दिया जा सकता है.

अगले चरण

इस इंटिग्रेशन को पूरा करने के बाद, आपको ये काम करने होंगे:

• इन्हें ईमेल भेजें engagement-developers@google.com और अपना इंटिग्रेट किया गया APK अटैच करें, जो Google के टेस्ट के लिए तैयार है.
• Google, अंदरूनी तौर पर पुष्टि और समीक्षा करता है. इससे यह पक्का किया जाता है कि इंटिग्रेशन उम्मीद के मुताबिक काम करता है. ज़रूरत पड़ने पर, Google आपसे संपर्क करेगा पर ईमेल करें.
• जांच पूरी हो जाने और किसी बदलाव की ज़रूरत न होने पर, Google आपसे संपर्क करेगा: आपको सूचित करेगा कि आप अपडेट किए गए और इंटिग्रेट किए गए APK को पब्लिश करना शुरू कर सकते हैं, Play Store.
• जब Google पुष्टि कर देगा कि आपका अपडेट किया गया APK Play Store, आपका सुझाव, चुनिंदा, और जारी रखना क्लस्टर पब्लिश किए जा सकते हैं और उपयोगकर्ताओं को दिख सकते हैं.