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"
}
CRITERION विज्ञापन ग्रुप लेवल की शर्तों के लिए आईडी मैपिंग: 
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) जोड़ा दुनिया भर में सबसे अलग है.
CampaignCriterion आईडी कैंपेन नहीं. (CampaignId, CriterionId) जोड़ा दुनिया भर में यूनीक होता है.
विज्ञापन एक्सटेंशन कैंपेन नहीं. (CampaignId, AdExtensionId) जोड़ा दुनिया भर में यूनीक होता है.
फ़ीड ID ग्लोबल हां
फ़ीड आइटम का आईडी ग्लोबल हां
फ़ीड एट्रिब्यूट आईडी फ़ीड नहीं
फ़ीड मैपिंग ID ग्लोबल हां
लेबल ID ग्लोबल हां
UserList आईडी ग्लोबल हां