Diese Seite wurde von der Cloud Translation API übersetzt.

Häufige Trafficking-Aufgaben
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite wird beschrieben, wie Sie einige der gängigsten Trafficking-Aufgaben mit der DCM/DFA Reporting and Trafficking API ausführen.

Allgemeine Programmiertipps

Erforderliche und optionale Eigenschaften und Parameter: In der Referenzdokumentation finden Sie Informationen dazu, ob eine Eigenschaft oder ein Parameter für einen API-Aufruf erforderlich ist.
Suche nach Platzhaltern: Sie können das Sternchen (*) als Platzhalter verwenden, wenn Sie nach Namen von Objekten suchen. Ein Sternchen bedeutet null oder mehr eines beliebigen Zeichens. Die API unterstützt auch eine implizite Teilstring-Suche, sodass die Suche nach „abc“ sucht implizit nach „*abc*“.
Aktualisieren und Patchen – Sie haben zwei Möglichkeiten, ein vorhandenes Objekt zu ändern: <ph type="x-smartling-placeholder">
1. Aktualisierung: Beim Aktualisieren eines Objekts werden alle Felder beim Einfügen überschrieben. Es ist wichtig, das Objekt, das Sie aktualisieren möchten, zu laden und Änderungen an diesem Objekt vorzunehmen. Andernfalls werden alle Felder, die nicht in der Aktualisierungsanfrage vorhanden sind, zurückgesetzt.
2. Patchen - Beim Patchen werden nur die angegebenen Felder beim Einfügen überschrieben. In diesem Fall kannst du ein neues Objekt erstellen, ihm dieselbe ID wie dem zu aktualisierenden Objekt zuweisen, die zu aktualisierenden Felder festlegen und die Patchanfrage ausführen.
Größen: Die physischen Abmessungen werden durch ein Size-Objekt dargestellt, das vom Größendienst definiert wird. Das Konto stellt eine Reihe von Standardgrößen bereit. Sie können dieser Liste Ihre eigenen benutzerdefinierten Größen hinzufügen.
Datums- und Uhrzeitwerte – Sie können Datum und Uhrzeit im RFC 3339-Format und in lokalen Zeitzonen speichern. Alle von der API zurückgegebenen Werte sind in UTC angegeben. Dies unterscheidet sich von der Website, auf der Datumsangaben und Uhrzeiten in Ihrer konfigurierten Zeitzone angezeigt werden (Standardeinstellung: Amerika/New York).

Werbetreibende erstellen

C#

Erstellen Sie ein Advertiser-Objekt und legen Sie die erforderlichen Attribute name und status fest.

// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.Name = advertiserName;
advertiser.Status = "APPROVED";

Rufen Sie advertisers.insert() auf, um den Werbetreibenden zu speichern.

// Create the advertiser.
Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();

Java

Erstellen Sie ein Advertiser-Objekt und legen Sie die erforderlichen Attribute name und status fest.

// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.setName(advertiserName);
advertiser.setStatus("APPROVED");

Rufen Sie advertisers.insert() auf, um den Werbetreibenden zu speichern.

// Create the advertiser.
Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();

PHP

Erstellen Sie ein Advertiser-Objekt und legen Sie die erforderlichen Attribute name und status fest.

$advertiser = new Google_Service_Dfareporting_Advertiser();
$advertiser->setName($values['advertiser_name']);
$advertiser->setStatus('APPROVED');

Rufen Sie advertisers.insert() auf, um den Werbetreibenden zu speichern.

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

Python

Erstellen Sie ein Advertiser-Objekt und legen Sie die erforderlichen Attribute name und status fest.

# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}

Rufen Sie advertisers.insert() auf, um den Werbetreibenden zu speichern.

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

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

Ruby

Erstellen Sie ein Advertiser-Objekt und legen Sie die erforderlichen Attribute name und status fest.

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

Rufen Sie advertisers.insert() auf, um den Werbetreibenden zu speichern.

# Insert the advertiser.
result = service.insert_advertiser(profile_id, advertiser)

Kampagne erstellen

C#

Erstellen Sie ein Campaign-Objekt und legen Sie die erforderlichen Attribute fest:
- advertiserId: Der Werbetreibende, mit dem diese Kampagne verknüpft werden soll.
- name: Dieser Wert muss in allen Kampagnen dieses Werbetreibenden eindeutig sein.
- defaultLandingPageId: Eine Landingpage, auf die Nutzer weitergeleitet werden, wenn sie auf eine Anzeige in dieser Kampagne klicken, sofern der Anzeige keine Anzeige zugewiesen ist. Sie können vorhandene Landingpages aufrufen, indem Sie advertiserLandingPages.list aufrufen, oder durch Aufrufen von advertiserLandingPages.insert eine neue Landingpage erstellen.
- Start- und Enddatum: Diese müssen in der Zukunft liegen und können bis zum Tag genau sein. Weitere Informationen finden Sie unter Allgemeine Informationen zur Codierung. Die Datumsangaben für einzelne Anzeigen können das Enddatum überschreiten, damit ein Publisher versuchen kann, einen Vertrag für eine bestimmte Anzahl von Aktionen zu erfüllen, wenn er bis zum Enddatum der Kampagne nicht ausgeführt wurde.
```
// 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));
```

Rufen Sie campaigns.insert() auf, um die Kampagne zu speichern.

// Insert the campaign.
Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();

Java

Erstellen Sie ein Campaign-Objekt und legen Sie die erforderlichen Attribute fest:
- advertiserId: Der Werbetreibende, mit dem diese Kampagne verknüpft werden soll.
- name: Dieser Wert muss in allen Kampagnen dieses Werbetreibenden eindeutig sein.
- defaultLandingPageId: Eine Landingpage, auf die Nutzer weitergeleitet werden, wenn sie auf eine Anzeige in dieser Kampagne klicken, sofern der Anzeige keine Anzeige zugewiesen ist. Sie können vorhandene Landingpages aufrufen, indem Sie advertiserLandingPages.list aufrufen, oder durch Aufrufen von advertiserLandingPages.insert eine neue Landingpage erstellen.
- Start- und Enddatum: Diese müssen in der Zukunft liegen und können bis zum Tag genau sein. Weitere Informationen finden Sie unter Allgemeine Informationen zur Codierung. Die Datumsangaben für einzelne Anzeigen können das Enddatum überschreiten, damit ein Publisher versuchen kann, einen Vertrag für eine bestimmte Anzahl von Aktionen zu erfüllen, wenn er bis zum Enddatum der Kampagne nicht ausgeführt wurde.
```
// 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);
```

Rufen Sie campaigns.insert() auf, um die Kampagne zu speichern.

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

PHP

Erstellen Sie ein Campaign-Objekt und legen Sie die erforderlichen Attribute fest:
- advertiserId: Der Werbetreibende, mit dem diese Kampagne verknüpft werden soll.
- name: Dieser Wert muss in allen Kampagnen dieses Werbetreibenden eindeutig sein.
- defaultLandingPageId: Eine Landingpage, auf die Nutzer weitergeleitet werden, wenn sie auf eine Anzeige in dieser Kampagne klicken, sofern der Anzeige keine Anzeige zugewiesen ist. Sie können vorhandene Landingpages aufrufen, indem Sie advertiserLandingPages.list aufrufen, oder durch Aufrufen von advertiserLandingPages.insert eine neue Landingpage erstellen.
- Start- und Enddatum: Diese müssen in der Zukunft liegen und können bis zum Tag genau sein. Weitere Informationen finden Sie unter Allgemeine Informationen zur Codierung. Die Datumsangaben für einzelne Anzeigen können das Enddatum überschreiten, damit ein Publisher versuchen kann, einen Vertrag für eine bestimmte Anzahl von Aktionen zu erfüllen, wenn er bis zum Enddatum der Kampagne nicht ausgeführt wurde.
```
$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'));
```

Rufen Sie campaigns.insert() auf, um die Kampagne zu speichern.

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

Python

Erstellen Sie ein Campaign-Objekt und legen Sie die erforderlichen Attribute fest:
- advertiserId: Der Werbetreibende, mit dem diese Kampagne verknüpft werden soll.
- name: Dieser Wert muss in allen Kampagnen dieses Werbetreibenden eindeutig sein.
- defaultLandingPageId: Eine Landingpage, auf die Nutzer weitergeleitet werden, wenn sie auf eine Anzeige in dieser Kampagne klicken, sofern der Anzeige keine Anzeige zugewiesen ist. Sie können vorhandene Landingpages aufrufen, indem Sie advertiserLandingPages.list aufrufen, oder durch Aufrufen von advertiserLandingPages.insert eine neue Landingpage erstellen.
- Start- und Enddatum: Diese müssen in der Zukunft liegen und können bis zum Tag genau sein. Weitere Informationen finden Sie unter Allgemeine Informationen zur Codierung. Die Datumsangaben für einzelne Anzeigen können das Enddatum überschreiten, damit ein Publisher versuchen kann, einen Vertrag für eine bestimmte Anzahl von Aktionen zu erfüllen, wenn er bis zum Enddatum der Kampagne nicht ausgeführt wurde.
```
# 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'
}
```

Rufen Sie campaigns.insert() auf, um die Kampagne zu speichern.

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

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

Ruby

Erstellen Sie ein Campaign-Objekt und legen Sie die erforderlichen Attribute fest:
- advertiserId: Der Werbetreibende, mit dem diese Kampagne verknüpft werden soll.
- name: Dieser Wert muss in allen Kampagnen dieses Werbetreibenden eindeutig sein.
- defaultLandingPageId: Eine Landingpage, auf die Nutzer weitergeleitet werden, wenn sie auf eine Anzeige in dieser Kampagne klicken, sofern der Anzeige keine Anzeige zugewiesen ist. Sie können vorhandene Landingpages aufrufen, indem Sie advertiserLandingPages.list aufrufen, oder durch Aufrufen von advertiserLandingPages.insert eine neue Landingpage erstellen.
- Start- und Enddatum: Diese müssen in der Zukunft liegen und können bis zum Tag genau sein. Weitere Informationen finden Sie unter Allgemeine Informationen zur Codierung. Die Datumsangaben für einzelne Anzeigen können das Enddatum überschreiten, damit ein Publisher versuchen kann, einen Vertrag für eine bestimmte Anzahl von Aktionen zu erfüllen, wenn er bis zum Enddatum der Kampagne nicht ausgeführt wurde.
```
# 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'
)
```

Rufen Sie campaigns.insert() auf, um die Kampagne zu speichern.

# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)

Placement erstellen

C#

Erstellen Sie ein Placement-Objekt und legen Sie die erforderlichen Placement-Eigenschaften fest (einschließlich campaignId und siteId). Achten Sie außerdem darauf, dass Sie Typ und Größe des Placements genau für das Placement festlegen, das Sie mit Ihrer Website verhandelt haben.

// Create the placement.
Placement placement = new Placement();
placement.Name = placementName;
placement.CampaignId = campaignId;
placement.Compatibility = "DISPLAY";
placement.PaymentSource = "PLACEMENT_AGENCY_PAID";
placement.SiteId = dfaSiteId;
placement.TagFormats = new List<string>() { "PLACEMENT_TAG_STANDARD" };

// Set the size of the placement.
Size size = new Size();
size.Id = sizeId;
placement.Size = size;