Search Ads 360 के नए वर्शन के लिए आईडी की मैपिंग

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

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

यहां दिखाई गई फ़ाइल का उदाहरण दिया गया है (UTF-8 में एन्कोड किया गया CSV फ़ॉर्मैट):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

CSV फ़ाइल में तीन कॉलम होते हैं:

  • Entity Type: इस पंक्ति का इकाई टाइप.

  • Legacy IDs: Search Ads 360 के पिछले वर्शन में मौजूद पूरे इकाई पाथ की JSON स्ट्रिंग

  • New IDs: Search Ads 360 के नए वर्शन में मौजूद पूरे इकाई पाथ की JSON स्ट्रिंग

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

किसकी शिकायत करना चाहते हैं ब्यौरा लेगसी आईडी नए आईडी
ग्राहक इनके लिए आईडी मैपिंग: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
कैंपेन कैंपेन के लिए आईडी मैपिंग. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP adGroup के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
साइटलिंक इनके लिए आईडी मैपिंग: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
एंडोरा (AD) विज्ञापन के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION इनके लिए आईडी मैपिंग: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP कैंपेन ग्रुप के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET कैंपेन ग्रुप के परफ़ॉर्मेंस टारगेट के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE फ़ीड टेबल के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM feedItem के लिए आईडी मैपिंग. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

रिपोर्ट डाउनलोड करना

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

ऑब्जेक्ट आईडी की खासियत

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

ऑब्जेक्ट आईडी यूनीकनेस का स्कोप क्या यह दुनिया भर में खास है?
बजट ID दुनिया भर में हां
कैंपेन आईडी दुनिया भर में हां
विज्ञापन समूह आईडी दुनिया भर में हां
विज्ञापन का आईडी विज्ञापन ग्रुप नहीं. (AdGroupId, AdId) जोड़ा दुनिया भर में खास है.
विज्ञापन समूह शर्तों का आईडी विज्ञापन ग्रुप नहीं. (AdGroupId, CriterionId) जोड़ा दुनिया भर में खास है.
अभियान मानदंड ID कैंपेन नहीं. (CampaignId, CriterionId) जोड़ा दुनिया भर में खास है.
विज्ञापन एक्सटेंशन कैंपेन नहीं. (CampaignId, AdExtensionId) जोड़ा दुनिया भर में खास है.
फ़ीड ID दुनिया भर में हां
फ़ीड आइटम की ID दुनिया भर में हां
फ़ीड विशेषता आईडी फ़ीड नहीं
फ़ीड मैपिंग ID दुनिया भर में हां
लेबल ID दुनिया भर में हां
उपयोगकर्ता सूची आईडी दुनिया भर में हां