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"
}

इकाइयों के मौजूद न होने की सामान्य वजहें

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

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

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

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