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

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

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

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

ज़रूरी और वैकल्पिक प्रॉपर्टी और पैरामीटर - रेफ़रंस दस्तावेज़ देखें और पता लगाएं कि एपीआई कॉल के लिए प्रॉपर्टी या पैरामीटर की ज़रूरत है या नहीं.
वाइल्डकार्ड नाम की खोज - ऑब्जेक्ट के नाम खोजते समय, तारे के निशान (*) वाइल्डकार्ड का इस्तेमाल किया जा सकता है. स्टार का निशान किसी भी वर्ण से शून्य या उससे ज़्यादा मैच करता है. एपीआई में दिखाने के लिए सेट की गई सबस्ट्रिंग का भी इस्तेमाल किया जा सकता है. इसलिए, "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)
```