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

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

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"
}
मानदंड इनके लिए आईडी मैपिंग: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "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) जोड़ा दुनिया भर में सबसे अलग है.
अभियान मापदंड आईडी कैंपेन नहीं. (CampaignId, CriterionId) जोड़ा दुनिया भर में सबसे अलग है.
विज्ञापन एक्सटेंशन कैंपेन नहीं. (CampaignId, AdExtensionId) जोड़ा दुनिया भर में सबसे अलग है.
फ़ीड ID ग्लोबल हां
फ़ीड आइटम की ID ग्लोबल हां
फ़ीड विशेषता आईडी फ़ीड नहीं
फ़ीड मैपिंग ID ग्लोबल हां
लेबल ID ग्लोबल हां
UserList ID ग्लोबल हां