Search Ads 360 का नया

Search Ads 360 का नया वर्शन, उपयोगकर्ता खातों, कैंपेन, विज्ञापन ग्रुप, कीवर्ड (शर्त), और विज्ञापनों को नए आईडी असाइन करता है. इन आईडी के लिए व्यवहार में दो अन्य बदलाव होते हैं:

  • Search Ads 360 का नया वर्शन, मैनेजर, सब-मैनेजर, और क्लाइंट खातों को दुनिया भर में इस्तेमाल होने वाला यूनीक ग्राहक आईडी असाइन करता है. इन्हें आम तौर पर एजेंसियां, विज्ञापन देने वाले, और इंजन खाते कहा जाता है.

  • Search Ads 360 का नया वर्शन अब कीवर्ड और विज्ञापनों के लिए यूनीक आईडी असाइन नहीं करता.

अब कन्वर्ज़न एपीआई, Search Ads 360 के नए ग्राहक आईडी के साथ काम करता है. ऐसा उन जगहों पर किया जाता है जहां एजेंसी आईडी, विज्ञापन देने वाले का आईडी, और इंजन खाता आईडी स्वीकार किए जाते हैं. अगर आपने कस्टमर एपीआई के बारे में जानकारी दी है, तो एपीआई को उम्मीद है कि कैंपेन आईडी, विज्ञापन ग्रुप आईडी, कीवर्ड आईडी, और विज्ञापन आईडी को Search Ads 360 का नया आईडी माना जाएगा. Search Ads 360 के नए कीवर्ड या विज्ञापन आईडी का इस्तेमाल करते समय, जब भी आपके अनुरोध में किसी कीवर्ड या विज्ञापन आईडी का इस्तेमाल किया गया हो, आपको उससे जुड़े कैंपेन और विज्ञापन ग्रुप आईडी के बारे में बताना होगा.

अनुरोध में नए Search Ads 360 आईडी का इस्तेमाल करने पर, जवाब में Search Ads 360 के नए आईडी का इस्तेमाल किया जाएगा.

कन्वर्ज़न की सूची बनाना

सूची के अनुरोध के लिए, Search Ads 360 के नए आईडी के साथ एक नया एंडपॉइंट उपलब्ध है. आपको क्लाइंट खाते का ग्राहक आईडी देना होगा. इसके अलावा, क्वेरी पैरामीटर में शामिल करने के लिए, कैंपेन आईडी और विज्ञापन ग्रुप का आईडी अब भी डाला जा सकता है. साथ ही, endDate, rowCount, startDate, और startRow की अब भी ज़रूरत है.

एचटीटीपी अनुरोध

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

कन्वर्ज़न डालें/अपडेट करें

हम Search Ads 360 के नए आईडी का इस्तेमाल करके, नीचे दिए गए अनुरोध को स्वीकार करते हैं:

  • किसी कीवर्ड और विज्ञापन को कन्वर्ज़न एट्रिब्यूट करना
  • कन्वर्ज़न का श्रेय सिर्फ़ किसी कीवर्ड को देना
  • कन्वर्ज़न के criterionId (कीवर्ड आईडी) की मदद से कन्वर्ज़न अपडेट करें

एंडपॉइंट के एंडपॉइंट अब भी पहले जैसे हैं. आपको हर कन्वर्ज़न संसाधन में Search Ads 360 का नया आईडी देना चाहिए: आपको agencyId, advertiserId, और engineAccountId सेट करने के बजाय, customerId देना चाहिए. साथ ही, ज़रूरत पड़ने पर campaignId, adGroupId, criterionId, adId में Search Ads 360 के नए आईडी का इस्तेमाल करना चाहिए.

किसी कीवर्ड को कन्वर्ज़न एट्रिब्यूट करने के लिए, Search Ads 360 के नए आईडी का इस्तेमाल करने के तरीके के बारे में अनुरोध का उदाहरण यहां दिया गया है.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

उपलब्धता बताएं

Conversion.updateAvailability() तरीके में भी Search Ads 360 के नए आईडी का इस्तेमाल किया जा सकता है. आपको सब-मैनेजर ग्राहक आईडी का इस्तेमाल करना होगा. उदाहरण के लिए:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}