पब्लिशर से मिले सिग्नल

विज्ञापन अनुरोधों में, ऑडियंस और कॉन्टेक्स्ट के हिसाब से डेटा को पब्लिशर से मिले सिग्नल (पीपीएस) के तौर पर भेजा जा सकता है. पीपीएस की मदद से, प्रोग्रामैटिक तरीके से कमाई करने की सुविधा को बेहतर बनाने के लिए, अपने उपयोगकर्ता डेटा का इस्तेमाल किया जा सकता है. इसके लिए, आपको स्टैंडर्ड टैक्सोनॉमी का इस्तेमाल करके, सभी ट्रांज़ैक्शन टाइप में बिड करने वालों को अपनी ऑडियंस की विशेषताओं के बारे में बताना होगा. इसके लिए, आपको उपयोगकर्ता आइडेंटिफ़ायर शेयर करने की ज़रूरत नहीं होगी. ऑडियंस की कैटगरी में, उपयोगकर्ता के व्यवहार और दिलचस्पी के आधार पर डेटा (IAB ऑडियंस टेक्सॉनमी 1.1) और कॉन्टेक्स्ट के हिसाब से डेटा (IAB कॉन्टेंट टेक्सॉनमी 2.2) शामिल हो सकता है. पब्लिशर से मिले स्ट्रक्चर्ड सिग्नल भी भेजे जा सकते हैं. ये सिग्नल, Google तय करता है. साथ ही, इनसे ज़्यादा सिग्नल भेजने की अनुमति मिलती है.

उपयोगकर्ता सिग्नल का JSON बनाना

सबसे ऊपर, एक की-वैल्यू पेयर वाला JSON ऑब्जेक्ट बनाएं. कुंजी PublisherProvidedTaxonomySignals होनी चाहिए और इसकी वैल्यू ऑब्जेक्ट का कलेक्शन होनी चाहिए. कलेक्शन में मौजूद हर ऑब्जेक्ट में दो की-वैल्यू पेयर होने चाहिए:

  • taxonomy कुंजी, जो यहां दी गई वैल्यू स्वीकार करती है. ये वैल्यू, IAB के इन सार्वजनिक स्पेसिफ़िकेशन के हिसाब से मैप की गई हैं:

    • ऑडियंस टेक्सॉनमी 1.1 के लिए IAB_AUDIENCE_1_1
    • कॉन्टेंट टेक्सॉनमी 2.2 के लिए IAB_CONTENT_2_2

  • values कुंजी, जिसमें स्ट्रिंग टैक्सोनॉमी वैल्यू का अरे शामिल है.

स्ट्रक्चर्ड सिग्नल का कलेक्शन बनाना

स्ट्रक्चर्ड सिग्नल के लिए, ऑब्जेक्ट के कलेक्शन की वैल्यू के साथ PublisherProvidedStructuredSignals कुंजी जोड़ें. सिग्नल के मुख्य वैल्यू की इस सूची के आधार पर ऑब्जेक्ट बनाएं:

स्ट्रक्चर्ड सिग्नल की टेबल को देखने के लिए टॉगल करें

सिग्नल <code" dr="ltr" translate="no">"type" वैल्यू</code"> "single_value" की संभावित वैल्यू "values" की संभावित वैल्यू
ऑडियो फ़ीड टाइप "audio_feed"
  • "af_1": संगीत
  • "af_2": ब्रॉडकास्ट करें
  • "af_3": पॉडकास्ट
 लागू नहीं
सामग्री रेटिंग "content_rating"
  • "cr_1": ग्रा॰
  • "cr_2": पीजी
  • "cr_3": T
  • "cr_4": एमए
 लागू नहीं
कॉन्टेंट डिलीवरी "delivery" लागू नहीं
  • "cd_1": स्ट्रीम हो रही है
  • "cd_2": प्रोग्रेसिव
  • "cd_3": डाउनलोड करें
प्रोडक्शन क्वालिटी "prodq"
  • "pq_1": पेशेवर तरीके से बनाया गया
  • "pq_2": प्रोसुमर
  • "pq_3": यूज़र जनरेटेड (यूजीसी)
 लागू नहीं

नीचे दिया गया उदाहरण देखें, जो टेक्सॉनमी सिग्नल के लिए IAB_AUDIENCE_1_1 और IAB_CONTENT_2_2 का इस्तेमाल करता है. इसमें स्ट्रक्चर्ड सिग्नल शामिल हैं.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

विज्ञापन अनुरोध कॉन्फ़िगर करना

अपने AdsRequest के साथ पीपीएस भेजने के लिए, यह तरीका अपनाएं:

  • उपयोगकर्ता की दिलचस्पी, व्यवहार या काम के डेटा का इस्तेमाल करके JSON स्ट्रिंग बनाएं.
  • ऊपर दी गई JSON स्ट्रिंग से, Base64 में एन्कोड की गई ASCII स्ट्रिंग बनाएं.
  • &ppsj= पैरामीटर के साथ, कोड में बदली गई स्ट्रिंग को अपने विज्ञापन टैग के यूआरएल में जोड़ें.
JSONObject userSignalsObject = new JSONObject();
JSONArray userSignalsArray = new JSONArray();
JSONObject audienceTaxonomyObject = new JSONObject();
JSONArray valuesArray = new JSONArray();
valuesArray.put("1");
valuesArray.put("284");
try {
  audienceTaxonomyObject.put("taxonomy", "IAB_AUDIENCE_1_1");
  audienceTaxonomyObject.put("values", valuesArray);
} catch (JSONException e) {
  e.printStackTrace();
}

userSignalsArray.put(audienceTaxonomyObject);

try {
  userSignalsObject.put("PublisherProvidedTaxonomySignals", userSignalsArray);
} catch (JSONException e) {
  e.printStackTrace();
}

String userSignals = userSignalsObject.toString();

byte[] userSignalsByte=new byte[0];
try {
  userSignalsByte = userSignals.getBytes(StandardCharsets.UTF_8);
  String encodedBas64Signals = android.util.Base64.encodeToString(
    userSignalsByte,
    android.util.Base64.URL_SAFE);
  encodedSignals = URLEncoder.encode(encodedBas64Signals, "UTF-8");
} catch (java.io.UnsupportedEncodingException error) {
  Log.w("Sample app", error);
}

String finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;