Vorlagenanzeigen

Vorlagenanzeigen bieten eine flexible Möglichkeit, neue Anzeigenformate zusätzlich zu den in die AdWords API integrierten Anzeigentypen zu erstellen.

Eine Vorlagenanzeige besteht aus einer Vorlage (durch die Vorlagen-ID festgelegt) und den Daten, mit denen die Felder der Vorlage gefüllt werden. Mit Vorlagenanzeigen können Sie eine Anzeige erstellen, die nicht als feststehender Anzeigentyp verfügbar ist, wie etwa Gmail-Anzeigen oder gesponserte YouTube-Videoanzeigen. Auf der Referenzseite für Vorlagenanzeigen finden Sie eine vollständige Liste der unterstützten Vorlagenanzeigen.

In diesem Leitfaden wird beispielhaft die Erstellung einiger Arten von Vorlagenanzeigen beschrieben.

App-Anzeigen

Mit der AdWords API können App-Anzeigen erstellt werden. Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer App-Anzeige:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
          <ad xsi:type="TemplateAd">
            <url>http://play.google.com/store/apps/details?id=INSERT_ANDROID_APP_PACKAGE_HERE</url>
            <displayUrl>play.google.com/store</displayUrl>
            <templateId>353</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>appId</name>
                <type>TEXT</type>
                <fieldText>XXXXX</fieldText>
              </fields>
              <fields>
                <name>appStore</name>
                <type>ENUM</type>
                <fieldText>XXXXX</fieldText>
              </fields>
              <fields>
                <name>headline</name>
                <type>TEXT</type>
                <fieldText>My awesome app</fieldText>
              </fields>
              <fields>
                <name>description1</name>
                <type>TEXT</type>
                <fieldText>Must download</fieldText>
              </fields>
              <fields>
                <name>description2</name>
                <type>TEXT</type>
                <fieldText>Best app ever</fieldText>
              </fields>
            </templateElements>
            <name>My App Promotion Ad</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sie können Anzeigen für erneute App-Interaktion für Kampagnen mit App-Interaktions-Anzeigen für das Suchnetzwerk erstellen. Diese Anzeigen sind auf Nutzer ausgerichtet, die Ihre App bereits installiert haben.

Eine Anzeige für erneute App-Interaktion enthält einen Deep-Link zu einer bestimmten Aktion in Ihrer App, um Nutzer zu ermutigen, die Aktion auszuführen.

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Anzeige für erneute App-Interaktion:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ns1:RequestHeader xmlns:ns1="https://adwords.google.com/api/adwords/cm/v201702"
        soapenv:mustUnderstand="0">
      <ns1:clientCustomerId>...</ns1:clientCustomerId>
      <ns1:developerToken>...</ns1:developerToken>
      <ns1:userAgent>...</ns1:userAgent>
      <ns1:validateOnly>false</ns1:validateOnly>
      <ns1:partialFailure>false</ns1:partialFailure>
    </ns1:RequestHeader>
  </soapenv:Header>
  <soapenv:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
          <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201702" xsi:type="ns2:TemplateAd">
            <!-- Deep link -->
            <url>android-app://com.example.android/exampleapp/productid_1234</url>
            <displayUrl>example.com</displayUrl>
            <templateId>453</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>appStore</name>
                <type>ENUM</type>
                <fieldText>2</fieldText>
              </fields>
              <fields>
                <name>appId</name>
                <type>TEXT</type>
                <fieldText>com.example.app</fieldText>
              </fields>
              <fields>
                <name>headline</name>
                <type>TEXT</type>
                <fieldText>Intergalactic cruise</fieldText>
              </fields>
              <fields>
                <name>description1</name>
                <type>TEXT</type>
                <fieldText>Free pretzels</fieldText>
              </fields>
              <fields>
                <name>description2</name>
                <type>TEXT</type>
                <fieldText>In-flight movies available</fieldText>
              </fields>
            </templateElements>
            <name>My App Reengagement Ad</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </soapenv:Body>
</soapenv:Envelope>

Gmail-Anzeigen

In den folgenden Abschnitten wird beschrieben, wie Sie mehrere unterschiedliche Typen von Gmail-Anzeigen erstellen.

Gmail-Bildanzeige

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Bildanzeige:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201702" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>459</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_image_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Round trip to Mars</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruise</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail image ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Gmail-Anzeige für eine einzelne Werbeaktion

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Anzeige für eine einzelne Werbeaktion:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201702" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>464</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_single_promotion_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionUrl1</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/booktrip</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1ButtonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1TextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1</name>
                            <type>TEXT</type>
                            <fieldText>Book trip</fieldText>
                        </fields>
                        <fields>
                            <name>content</name>
                            <type>TEXT</type>
                            <fieldText>Great deals on Venus</fieldText>
                        </fields>
                        <fields>
                            <name>headlineTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f9</fieldText>
                        </fields>
                        <fields>
                            <name>headline</name>
                            <type>TEXT</type>
                            <fieldText>Book now</fieldText>
                        </fields>
                        <fields>
                            <name>image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Space flights</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruises</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail single promotion ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Gmail-Anzeige für mehrere Produkte

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Anzeige für mehrere Produkte:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201702" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>466</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_multi_product_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>content</name>
                            <type>TEXT</type>
                            <fieldText>Choose your destination</fieldText>
                        </fields>
                        <fields>
                            <name>headlineTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f9</fieldText>
                        </fields>
                        <fields>
                            <name>headline</name>
                            <type>TEXT</type>
                            <fieldText>Multiple destinations available</fieldText>
                        </fields>
                        <fields>
                            <name>header</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>product_5_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_5_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_5_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonText</name>
                            <type>TEXT</type>
                            <fieldText>Cruise to Venus</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonUrl</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/venus</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_title</name>
                            <type>TEXT</type>
                            <fieldText>Book Venus trip</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>product_0_buttonText</name>
                            <type>TEXT</type>
                            <fieldText>Cruise to Mars</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonUrl</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/mars</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_title</name>
                            <type>TEXT</type>
                            <fieldText>Book Mars trip</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Travel to your favorite planet</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruises</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail multi-product ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

HTML5-Anzeigen

Mit der API können Sie HTML5-Anzeigen erstellen.

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer HTML5-Anzeige mit einer ZIP-Datei als Quelle:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
            <ad xsi:type="TemplateAd">
            <displayUrl>www.example.com/html5</displayUrl>
            <finalUrls>http://example.com/html5</finalUrls>
            <templateId>419</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>Custom_layout</name>
                <type>MEDIA_BUNDLE</type>
                <fieldMedia xsi:type="MediaBundle">
                  <type>MEDIA_BUNDLE</type>
                  <data>INSERT_BASE_64_ENCODED_BYTES_FROM_ZIP_FILE_HERE</data>
                  <entryPoint>carousel/index.html</entryPoint>
                </fieldMedia>
              </fields>
              <fields>
                <name>layout</name>
                <type>ENUM</type>
                <fieldText>Custom</fieldText>
              </fields>
            </templateElements>
            <dimensions>
              <width>300</width>
              <height>250</height>
            </dimensions>
            <name>Ad for HTML5</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

HTML5-MediaBundles

Sie können HTML5-MediaBundles (z. B. ZIP-Dateien mit HTML5-Inhalten) mithilfe von MediaService hochladen.

Im Beispiel sehen Sie eine Anforderung zum Hochladen von HTML5-Inhalten mit dem MediaService:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <upload xmlns="https://adwords.google.com/api/adwords/cm/v201702">
      <media xsi:type="MediaBundle">
        <type>MEDIA_BUNDLE</type>
        <data>INSERT_BASE_64_ENCODED_BYTES_FROM_ZIP_FILE_HERE</data>
      </media>
    </upload>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Feedback geben zu...