Google AdWords API – Teil 3

Anzeigen und Keywords – mm dritten Teil der Google AdWords Artikelreihe geht es um Anzeigen, Keywords und Placements.

Anzeigen

Anzeigen kann man mit dem AdGroupAdService auslesen. Anders als bei Kampagnen und Anzeigegruppen hat man hier nun auch die Zahlen, für die man sich eigentlich interessiert. Auslesen kann man unterschiedliche Dinge, die wichtigsten sind:

• Klicks
• Impressionen
• CPC (Cost per Click)
• Conversions
• CTR (Click trough rate)
• Position
• …

Die vollständige Liste aller Werte ist hier zu finden.

So lese ich die Werte der Anzeigen aus:

function GetTextAds(AdWordsUser $user, $adGroupId, $days, $adwords_version) {
    // Get the service, which loads the required classes.
    $adGroupAdService = $user->GetService('AdGroupAdService', $adwords_version);

    // Create selector.
    $selector = new Selector();
    $selector->fields = array('Headline', 'Id', 'Description1', 'Description2', 'DisplayUrl', 'Url', 'Status', 'AverageCpc', 'AveragePosition', 'Clicks', 'Conversions', 'Cost', 'Ctr', 'Impressions');
    $selector->ordering[] = new OrderBy('Headline', 'ASCENDING');

    // Create predicates.
    $selector->predicates[] = new Predicate('AdGroupId', 'IN', array($adGroupId));
    $selector->predicates[] = new Predicate('AdType', 'IN', array('TEXT_AD'));
    // By default disabled ads aren't returned by the selector. To return them
    // include the DISABLED status in a predicate.
    $selector->predicates[] = new Predicate('Status', 'NOT_IN', array('DISABLED', 'PAUSED'));
    $selector->predicates[] = new Predicate('Impressions', 'GREATER_THAN', array('1'));
    $dateRange = new DateRange();
    $str1 = '-1 days';
    $str2 = '-1 days';
    if($days > 0)
    {
        $str1 = '-'.$days.' days';
        $str2 = '-'.$days.' days';
    }
    $dateRange->min = date('Ymd', strtotime($str1));
    $dateRange->max = date('Ymd', strtotime($str2));
    $selector->dateRange = $dateRange;

    // Create paging controls.
    $selector->paging = new Paging(0, AdWordsConstants::RECOMMENDED_PAGE_SIZE);

    $ret = array();
    do {
        // Make the get request.
        $page = $adGroupAdService->get($selector);

        // Display results.
        if (isset($page->entries)) {
            foreach ($page->entries as $adGroupAd) {
                $cr = 0;
                if($adGroupAd->stats->clicks > 0)
                    $cr = $adGroupAd->stats->conversions / $adGroupAd->stats->clicks;

                $ret[] = array(
                    'headline' => $adGroupAd->ad->headline,
                    'id' => $adGroupAd->ad->id,
                    'textrow1' => $adGroupAd->ad->description1,
                    'textrow2' => $adGroupAd->ad->description2,
                    'view_url' => $adGroupAd->ad->displayUrl,
                    'target_url' => $adGroupAd->ad->url,
                    'active' => (strcmp($adGroupAd->status,'ENABLED')==0)?1:0,
                    'clicks' => $adGroupAd->stats->clicks,
                    'cpc' => $adGroupAd->stats->averageCpc->microAmount / 1000000,
                    'conversions' => $adGroupAd->stats->conversions,
                    'cost' => $adGroupAd->stats->cost->microAmount / 1000000,
                    'ctr' => $adGroupAd->stats->ctr,
                    'impressions' => $adGroupAd->stats->impressions,
                    'cr' => $cr,
                    'position' => $adGroupAd->stats->averagePosition
                );
                }
            } else {
                //print "No text ads were found.\n";
            }

            // Advance the paging index.
            $selector->paging->startIndex += AdWordsConstants::RECOMMENDED_PAGE_SIZE;
        } while ($page->totalNumEntries > $selector->paging->startIndex);
    return $ret;
}

Neu ist hier, dass ich im Selector eine dateRange angebe. In diesem Beispiel übergebe ich die Variable days, welche angibt, den wievielten Tag in der Vergangenheit geholt werden soll. Es wird so genau eine Zeile Daten für einen Tage geliefert. Hier kann man natürlich auch Zeitspannen angeben (zum Beispiel eine Woche). Dann bekommt man die Werte auf eine Woche aufsummiert.

Eine Anzeige wird über folgende Werte definiert:

• Headline
  Die Überschrift der Textwerbung.
• Description1
  Die erste Zeile der Textwerbung.
• Description2
  Die zweite Zeile.
• DisplayUrl
  Die angezeigte Url.
• Url
  Die Url die hinterlegt ist.

Keywords/Placements

Keywords und Placements holt man sich mit dem selben Service: dem AdGroupCriterionService. Hier der Code wie ich mir die Keywords hole. Dieser entspricht fast zur Gänze dem Code für die Anzeigen:

function GetKeywords(AdWordsUser $user, $adGroupId, $days, $adwords_version) {
    // Get the service, which loads the required classes.
    $adGroupCriterionService =
    $user->GetService('AdGroupCriterionService', $adwords_version);

    // Create selector.
    $selector = new Selector();

    $selector->fields = array('KeywordText', 'KeywordMatchType', 'Id', 'AverageCpc', 'AveragePosition', 'Clicks', 'Conversions', 'Cost', 'Ctr', 'Impressions', 'QualityScore', 'Status');
    $selector->ordering[] = new OrderBy('KeywordText', 'ASCENDING');

    // Create predicates.
    $selector->predicates[] = new Predicate('AdGroupId', 'IN', array($adGroupId));
    $selector->predicates[] = new Predicate('CriteriaType', 'IN', array('KEYWORD'));
    $selector->predicates[] = new Predicate('Status', 'IN', array('ACTIVE'));
    $selector->predicates[] = new Predicate('Impressions', 'GREATER_THAN', array('1'));

    $dateRange = new DateRange();
    $str1 = '-1 days';
    $str2 = '-1 days';
    if($days > 0)
    {
        $str1 = '-'.$days.' days';
        $str2 = '-'.$days.' days';
    }
    $dateRange->min = date('Ymd', strtotime($str1));
    $dateRange->max = date('Ymd', strtotime($str2));
    $selector->dateRange = $dateRange;

    // Create paging controls.
    $selector->paging = new Paging(0, AdWordsConstants::RECOMMENDED_PAGE_SIZE);

    $ret = array();

    do {
        // Make the get request.
        $page = $adGroupCriterionService->get($selector);

        // Display results.
        if (isset($page->entries)) {
            foreach ($page->entries as $adGroupCriterion) {
                $cr = 0;
                if($adGroupCriterion->stats->clicks > 0)
                    $cr = $adGroupCriterion->stats->conversions / $adGroupCriterion->stats->clicks;

                $ret[] = array(
                    'name' => $adGroupCriterion->criterion->text,
                    'type' => $adGroupCriterion->criterion->matchType,
                    'id' => $adGroupCriterion->criterion->id,
                    'clicks' => $adGroupCriterion->stats->clicks,
                    'cpc' => $adGroupCriterion->stats->averageCpc->microAmount / 1000000,
                    'conversions' => $adGroupCriterion->stats->conversions,
                    'cost' => $adGroupCriterion->stats->cost->microAmount / 1000000,
                    'ctr' => $adGroupCriterion->stats->ctr,
                    'impressions' => $adGroupCriterion->stats->impressions,
                    'qualityfactor' => $adGroupCriterion->qualityInfo->qualityScore,
                    'cr' => $cr,
                    'position' => $adGroupCriterion->stats->averagePosition
                );
                }
            } else {
                //print "No keywords were found.\n";
            }

            // Advance the paging index.
            $selector->paging->startIndex += AdWordsConstants::RECOMMENDED_PAGE_SIZE;
        } while ($page->totalNumEntries > $selector->paging->startIndex);
    return $ret;
}

Für die Placements kann man zusätzlich zu diesen Daten noch den Namen und die Url holen.

Nun haben wir alles um die Daten aus AdWords abzufragen. Ich speichere mir die Tageswerte in einer Datenbank und berechne mir daraus gegebenenfalls wieder Wochen oder Monatswerte. Für die Kampagnen und Anzeigegruppen muss man die Summe aller Daten ihrer Keywords, Placements und Anzeigen zusammenzählen.

Soweit mein Ausflug in die Welt von Google und der AdWords API. Ich freue mich auf Kommentare!

Teil 1 | Teil 2 | Teil 3 | Teil 4 | Teil 5 | Teil 6