इस पेज का अनुवाद Cloud Translation API से किया गया है.

सामान्य ट्रैफ़िकिंग टास्क

इस पेज में बताया गया है कि डीसीएम/डीएफ़ए रिपोर्टिंग और ट्रैफ़िकिंग एपीआई का इस्तेमाल करके ट्रैफ़िकिंग के सबसे आम काम कैसे किए जाएं.

कोडिंग से जुड़ी सामान्य सलाह

ज़रूरी और वैकल्पिक प्रॉपर्टी और पैरामीटर - एपीआई कॉल के लिए प्रॉपर्टी या पैरामीटर ज़रूरी है या नहीं, यह जानने के लिए पहचान फ़ाइल से जुड़ा दस्तावेज़ देखें.
वाइल्डकार्ड नाम की खोज - ऑब्जेक्ट के नाम खोजते समय आप तारे के निशान (*) वाइल्डकार्ड का इस्तेमाल कर सकते हैं. तारे का निशान, किसी भी वर्ण के शून्य या उससे ज़्यादा मेल खाता है. यह एपीआई, शामिल की गई सबस्ट्रिंग के साथ भी काम करता है. इसलिए, "abc" के लिए खोज की जा सकती है "*abc*" के लिए भी अनुमान लगाया जाएगा.
अपडेट करना बनाम पैच करना - किसी मौजूदा ऑब्जेक्ट में बदलाव करने के लिए, आपके पास दो विकल्प हैं:
1. अपडेट करना - किसी ऑब्जेक्ट को अपडेट करते समय, शामिल करने पर सभी फ़ील्ड ओवरराइट हो जाएंगे. आपको जिस ऑब्जेक्ट को अपडेट करना है उसे लोड करना और उस ऑब्जेक्ट में कोई भी बदलाव करना ज़रूरी है. ऐसा नहीं करने पर, उन फ़ील्ड को सेट नहीं किया जाएगा जो अपडेट के अनुरोध में मौजूद नहीं हैं.
2. पैचिंग - पैच करते समय, सिर्फ़ तय किए गए फ़ील्ड को इंसर्ट करने पर ओवरराइट किया जाएगा. इस स्थिति में, एक नया ऑब्जेक्ट बनाया जा सकता है. साथ ही, उसे वही आईडी असाइन किया जा सकता है जो ऑब्जेक्ट को अपडेट करना है. साथ ही, अपडेट किए जाने वाले फ़ील्ड सेट करें और पैच का अनुरोध करें.
साइज़ - फ़िज़िकल डाइमेंशन को एक Size ऑब्जेक्ट से दिखाया जाता है. यह ऑब्जेक्ट, साइज़ सर्विस के ज़रिए तय किया जाता है. खाता, स्टैंडर्ड साइज़ का एक सेट उपलब्ध कराता है. साथ ही, इस सूची में आपके पास कस्टम साइज़ जोड़ने का विकल्प भी होता है.
तारीख और समय - स्थानीय टाइम ज़ोन का इस्तेमाल करके, आरएफ़सी 3339 फ़ॉर्मैट में तारीख/समय सेव किए जा सकते हैं; एपीआई से मिलने वाली सभी वैल्यू यूटीसी में होती हैं. यह उस वेबसाइट से अलग है जहां आपके कॉन्फ़िगर किए गए टाइमज़ोन (डिफ़ॉल्ट रूप से, अमेरिका/न्यूयॉर्क का समय) में तारीखें और समय दिखाए जाते हैं.

विज्ञापन देने वाला बनाएं

C#

Advertiser ऑब्जेक्ट बनाएं और उसके लिए ज़रूरी नाम और स्टेटस प्रॉपर्टी सेट करें.
```
// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.Name = advertiserName;
advertiser.Status = "APPROVED";
```
विज्ञापन देने वाले को सेव करने के लिए, advertisers.insert() पर कॉल करें.
```
// Create the advertiser.
Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();
```

Java

Advertiser ऑब्जेक्ट बनाएं और उसके लिए ज़रूरी नाम और स्टेटस प्रॉपर्टी सेट करें.
```
// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.setName(advertiserName);
advertiser.setStatus("APPROVED");
```
विज्ञापन देने वाले को सेव करने के लिए, advertisers.insert() पर कॉल करें.
```
// Create the advertiser.
Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();
```

PHP

Advertiser ऑब्जेक्ट बनाएं और उसके लिए ज़रूरी नाम और स्टेटस प्रॉपर्टी सेट करें.
```
$advertiser = new Google_Service_Dfareporting_Advertiser();
$advertiser->setName($values['advertiser_name']);
$advertiser->setStatus('APPROVED');
```
विज्ञापन देने वाले को सेव करने के लिए, advertisers.insert() पर कॉल करें.
```
$result = $this->service->advertisers->insert(
    $values['user_profile_id'],
    $advertiser
);
```

Python

Advertiser ऑब्जेक्ट बनाएं और उसके लिए ज़रूरी नाम और स्टेटस प्रॉपर्टी सेट करें.
```
# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}
```

विज्ञापन देने वाले को सेव करने के लिए, advertisers.insert() पर कॉल करें.

request = service.advertisers().insert(
    profileId=profile_id, body=advertiser)

# Execute request and print response.
response = request.execute()

Ruby

Advertiser ऑब्जेक्ट बनाएं और उसके लिए ज़रूरी नाम और स्टेटस प्रॉपर्टी सेट करें.

# Create a new advertiser resource to insert.
advertiser = DfareportingUtils::API_NAMESPACE::Advertiser.new(
  name: format('Example Advertiser #%s', SecureRandom.hex(3)),
  status: 'APPROVED'
)

विज्ञापन देने वाले को सेव करने के लिए, advertisers.insert() पर कॉल करें.
```
# Insert the advertiser.
result = service.insert_advertiser(profile_id, advertiser)
```

कैंपेन बनाएं

C#

Campaign ऑब्जेक्ट बनाएं और उसकी ज़रूरी प्रॉपर्टी सेट करें:
- advertiserId - विज्ञापन देने वाला वह व्यक्ति या कंपनी जिससे इस कैंपेन को जोड़ा जाएगा.
- name - यह, विज्ञापन देने वाली इस कंपनी के सभी कैंपेन के लिए यूनीक होना चाहिए.
- defaultLandingPageId - अगर उपयोगकर्ताओं को इस कैंपेन में मौजूद किसी विज्ञापन पर क्लिक नहीं किया गया है, तो लैंडिंग पेज पर ले जाया जाएगा. मौजूदा लैंडिंग पेज देखने के लिए, advertiserLandingPages.list पर कॉल करें या advertiserLandingPages.insert पर कॉल करके, एक नया लैंडिंग पेज बनाएं.
- शुरू होने और खत्म होने की तारीखें - आगे की होनी चाहिए और ये आज की सटीक हो सकती हैं. ज़्यादा जानकारी के लिए, कोडिंग की सामान्य जानकारी में तारीख और समय वाला बुलेट पॉइंट देखें. अलग-अलग विज्ञापन की तारीखें, खत्म होने की तारीख के बाद की हो सकती हैं. ऐसा इसलिए, ताकि पब्लिशर, कैंपेन के खत्म होने की तय तारीख तक कानूनी समझौते को पूरा कर सके.
```
// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);

// Create the campaign structure.
Campaign campaign = new Campaign();
campaign.Name = campaignName;
campaign.AdvertiserId = advertiserId;
campaign.Archived = false;
campaign.DefaultLandingPageId = defaultLandingPage.Id;

// Set the campaign start date. This example uses today's date.
campaign.StartDate =
    DfaReportingDateConverterUtil.convertToDateString(DateTime.Now);

// Set the campaign end date. This example uses one month from today's date.
campaign.EndDate =
    DfaReportingDateConverterUtil.convertToDateString(DateTime.Now.AddMonths(1));
```
कैंपेन सेव करने के लिए campaigns.insert() पर कॉल करें.
```
// Insert the campaign.
Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();
```

Java

Campaign ऑब्जेक्ट बनाएं और उसकी ज़रूरी प्रॉपर्टी सेट करें:
- advertiserId - विज्ञापन देने वाला वह व्यक्ति या कंपनी जिससे इस कैंपेन को जोड़ना है.
- name - यह, विज्ञापन देने वाली इस कंपनी के सभी कैंपेन के लिए यूनीक होना चाहिए.
- defaultLandingPageId - अगर उपयोगकर्ताओं को इस कैंपेन में मौजूद किसी विज्ञापन पर क्लिक नहीं किया गया है, तो लैंडिंग पेज पर ले जाया जाएगा. मौजूदा लैंडिंग पेज देखने के लिए, advertiserLandingPages.list पर कॉल करें या advertiserLandingPages.insert पर कॉल करके, एक नया लैंडिंग पेज बनाएं.
- शुरू होने और खत्म होने की तारीखें - आगे की होनी चाहिए और ये आज की सटीक हो सकती हैं. ज़्यादा जानकारी के लिए, कोडिंग की सामान्य जानकारी में तारीख और समय वाला बुलेट पॉइंट देखें. अलग-अलग विज्ञापन की तारीखें, खत्म होने की तारीख के बाद की हो सकती हैं. ऐसा इसलिए, ताकि पब्लिशर, कैंपेन के खत्म होने की तय तारीख तक कानूनी समझौते को पूरा कर सके.
```
// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);

// Create the campaign structure.
Campaign campaign = new Campaign();
campaign.setName(campaignName);
campaign.setAdvertiserId(advertiserId);
campaign.setArchived(false);
campaign.setDefaultLandingPageId(defaultLandingPage.getId());

// Set the campaign start date. This example uses today's date.
Calendar today = Calendar.getInstance();
DateTime startDate = new DateTime(true, today.getTimeInMillis(), null);
campaign.setStartDate(startDate);

// Set the campaign end date. This example uses one month from today's date.
Calendar nextMonth = Calendar.getInstance();
nextMonth.add(Calendar.MONTH, 1);
DateTime endDate = new DateTime(true, nextMonth.getTimeInMillis(), null);
campaign.setEndDate(endDate);
```

कैंपेन सेव करने के लिए campaigns.insert() पर कॉल करें.

// Insert the campaign.
Campaign result = reporting.campaigns().insert(profileId, campaign).execute();

PHP

Campaign ऑब्जेक्ट बनाएं और उसकी ज़रूरी प्रॉपर्टी सेट करें:
- advertiserId - विज्ञापन देने वाला वह व्यक्ति या कंपनी जिससे इस कैंपेन को जोड़ना है.
- name - यह, विज्ञापन देने वाली इस कंपनी के सभी कैंपेन के लिए यूनीक होना चाहिए.
- defaultLandingPageId - अगर उपयोगकर्ताओं को इस कैंपेन में मौजूद किसी विज्ञापन पर क्लिक नहीं किया गया है, तो लैंडिंग पेज पर ले जाया जाएगा. मौजूदा लैंडिंग पेज देखने के लिए, advertiserLandingPages.list पर कॉल करें या advertiserLandingPages.insert पर कॉल करके, एक नया लैंडिंग पेज बनाएं.
- शुरू और खत्म होने की तारीखें - ये आने वाले समय की होनी चाहिए और इनमें आज की तारीख तक सटीक हो सकता है. ज़्यादा जानकारी के लिए, कोडिंग की सामान्य जानकारी में तारीख और समय वाला बुलेट पॉइंट देखें. अलग-अलग विज्ञापन की तारीखें, खत्म होने की तारीख के बाद की हो सकती हैं. ऐसा इसलिए, ताकि पब्लिशर, कैंपेन के खत्म होने की तय तारीख तक कानूनी समझौते को पूरा कर सके.
```
$startDate = new DateTime('today');
$endDate = new DateTime('+1 month');

$campaign = new Google_Service_Dfareporting_Campaign();
$campaign->setAdvertiserId($values['advertiser_id']);
$campaign->setDefaultLandingPageId($values['default_landing_page_id']);
$campaign->setName($values['campaign_name']);
$campaign->setStartDate($startDate->format('Y-m-d'));
$campaign->setEndDate($endDate->format('Y-m-d'));
```

कैंपेन सेव करने के लिए campaigns.insert() पर कॉल करें.

$result = $this->service->campaigns->insert(
    $values['user_profile_id'],
    $campaign
);

Python

Campaign ऑब्जेक्ट बनाएं और उसकी ज़रूरी प्रॉपर्टी सेट करें:
- advertiserId - विज्ञापन देने वाला वह व्यक्ति या कंपनी जिससे इस कैंपेन को जोड़ा जाएगा.
- name - यह, विज्ञापन देने वाली इस कंपनी के सभी कैंपेन के लिए यूनीक होना चाहिए.
- defaultLandingPageId - अगर उपयोगकर्ताओं को इस कैंपेन में मौजूद किसी विज्ञापन पर क्लिक नहीं किया गया है, तो लैंडिंग पेज पर ले जाया जाएगा. मौजूदा लैंडिंग पेज देखने के लिए, advertiserLandingPages.list पर कॉल करें या advertiserLandingPages.insert पर कॉल करके, एक नया लैंडिंग पेज बनाएं.
- शुरू और खत्म होने की तारीखें - ये आने वाले समय की होनी चाहिए और इनमें आज की तारीख तक सटीक हो सकता है. ज़्यादा जानकारी के लिए, कोडिंग की सामान्य जानकारी में तारीख और समय वाला बुलेट पॉइंट देखें. अलग-अलग विज्ञापन की तारीखें, खत्म होने की तारीख के बाद की हो सकती हैं. ऐसा इसलिए, ताकि पब्लिशर, कैंपेन के खत्म होने की तय तारीख तक कानूनी समझौते को पूरा कर सके.
```
# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                   advertiser_id)

# Construct and save campaign.
campaign = {
    'name': 'Test Campaign #%s' % uuid.uuid4(),
    'advertiserId': advertiser_id,
    'archived': 'false',
    'defaultLandingPageId': default_landing_page['id'],
    'startDate': '2015-01-01',
    'endDate': '2020-01-01'
}
```

कैंपेन सेव करने के लिए campaigns.insert() पर कॉल करें.

request = service.campaigns().insert(profileId=profile_id, body=campaign)

# Execute request and print response.
response = request.execute()

Ruby

Campaign ऑब्जेक्ट बनाएं और उसकी ज़रूरी प्रॉपर्टी सेट करें:
- advertiserId - विज्ञापन देने वाला वह व्यक्ति या कंपनी जिससे इस कैंपेन को जोड़ा जाएगा.
- name - यह, विज्ञापन देने वाली इस कंपनी के सभी कैंपेन के लिए यूनीक होना चाहिए.
- defaultLandingPageId - अगर उपयोगकर्ताओं को इस कैंपेन में मौजूद किसी विज्ञापन पर क्लिक नहीं किया गया है, तो लैंडिंग पेज पर ले जाया जाएगा. मौजूदा लैंडिंग पेज देखने के लिए, advertiserLandingPages.list पर कॉल करें या advertiserLandingPages.insert पर कॉल करके, एक नया लैंडिंग पेज बनाएं.
- शुरू और खत्म होने की तारीखें - ये आने वाले समय की होनी चाहिए और इनमें आज की तारीख तक सटीक हो सकता है. ज़्यादा जानकारी के लिए, कोडिंग की सामान्य जानकारी में तारीख और समय वाला बुलेट पॉइंट देखें. अलग-अलग विज्ञापन की तारीखें, खत्म होने की तारीख के बाद की हो सकती हैं. ऐसा इसलिए, ताकि पब्लिशर, कैंपेन के खत्म होने की तय तारीख तक कानूनी समझौते को पूरा कर सके.
```
# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
  advertiser_id)

# Create a new campaign resource to insert.
campaign = DfareportingUtils::API_NAMESPACE::Campaign.new(
  advertiser_id: advertiser_id,
  archived: false,
  default_landing_page_id: default_landing_page.id,
  name: format('Example Campaign #%s', SecureRandom.hex(3)),
  start_date: '2014-01-01',
  end_date: '2020-01-01'
)
```
कैंपेन सेव करने के लिए campaigns.insert() पर कॉल करें.
```
# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)
```