AMP

İlk AMP e-postanızı oluşturun

Important: this documentation is not applicable to your currently selected format stories!

E-posta için AMP, e-posta gönderenlerin bir dizi yeni özelliği desteklemek için e-posta mesajlarında AMP kullanmasına izin verir. AMP ile yazılan e-postalar, resim döngüleri veya akordeonları gibi etkileşimli öğeler içerebilir, içerik mesajda güncel kalır ve alıcıların gelen kutularını terk etmeden bir forma yanıt vermek gibi eylemler gerçekleştirme yeteneği olabilir.

E-posta için AMP mevcut e-postalarla uyumludur. Mesajın AMP sürümü, HTML ve düz metne ek olarak, tüm e-posta istemcilerinde uyumluluk sağlayan yeni bir MIME parçası olarak e-postaya gömülür.

İpucu: E-posta için AMP'yi destekleyen e-posta platformlarının (ESP'ler), istemcilerin ve sağlayıcıların listesi için SSS bölümündeki Desteklenen E-posta Platformlarına göz atın.

AMP tarafından desteklenen ilk dinamik e-postanızı oluşturmak ve göndermek için bu öğreticiyi izleyin. Bitmiş kodu buradan görüntüleyebilirsiniz.

AMP e-posta standart metniyle başlayın

AMP playground, E-posta için AMP biçimini destekler ve AMP e-postalarınızı geliştirmenize, test etmenize ve doğrulamanıza olanak tanır. AMP Playground'u açın ve sol üst köşesindeki biçimin AMP for Email olarak ayarlandığından emin olun. Aşağıdaki kodu görmelisiniz:

<!DOCTYPE html>
<html 4email data-css-strict>
  <head>
    <meta charset="utf-8" />
    <script async src="https://cdn.ampproject.org/v0.js"></script>
    <style amp4email-boilerplate>
      body {
        visibility: hidden;
      }
    </style>
    <style amp-custom>
      h1 {
        margin: 1rem;
      }
    </style>
  </head>
  <body>
    <h1>Hello, I am an AMP EMAIL!</h1>
  </body>
</html>

Bu, geçerli bir AMP e-postası olmak için gerekli tüm işaretlemeyi ve minimum kodu içerir. Ayrıca, sağ üst açılır menüdeki açılır listede yer alan diğer birçok geçerli e-posta şablonu örneğine de dikkat edin.

Klasik HTML e-postalarından bazı önemli farklılıkları aramak için bir dakikanızı ayıralım:

  • AMP e-postaları, html etiketine ⚡4email veya amp4email ekleyerek kendilerini bu şekilde tanımlamalıdır.
  • <head> etiketi, AMP çalışma zamanını yükleyen bir <script> etiketi de içermelidir. <script async src="https://cdn.ampproject.org/v0.js"></script>
  • Başlangıçta içeriği AMP yüklenene kadar gizlemek için bir CSS standart metni. <style amp4email-boilerplate>body{visibility:hidden}</style>

Daha önce e-postalarla çalıştıysanız, bir e-postaya bir komut dosyası yerleştirme fikri kafanızdaki alarm zillerini tetikleyebilir! Emin olun, AMP e-postalarını destekleyen e-posta sağlayıcıları, yalnızca doğrulanmış AMP komut dosyalarının istemcilerinde çalışmasına izin veren şiddetli güvenlik kontrolleri uygular. Bu, dinamik ve etkileşimli özelliklerin doğrudan alıcıların posta kutularında herhangi bir güvenlik açığı olmadan çalışmasına izin verir! AMP e-postaları için gerekli biçimlendirme hakkında daha fazla bilgi için buraya bakın.

AMP e-postalarına yalnızca desteklenen bileşenler için AMP komut dosyaları eklenebilir.

Bir resim ekleyin

E-postalarda kullanılan HTML etiketlerinin çoğu AMP e-postalarında kullanılabilir. Bununla birlikte, <img> etiketi gibi bazı etiketler, AMP eşdeğeri <amp-img> ile değiştirilir.

<amp-img> etiketi, görüntünün genişliğinin ve yüksekliğinin tanımlanmasını gerektirir. <img>'den farklı olarak <amp-img>, ile açıkça kapatılmalıdır.

<amp-img
  src="https://link/to/img.jpg"
  alt="photo description"
  width="100"
  height="100"
>
</amp-img>

Ayrıca, GIF dosyaları <amp-anim> aracılığıyla desteklenir.

E-postalar sunucunuzda barındırılmadığından, URL'ler AMP e-postalarında mutlak yollar kullanmalı ve HTTPS olmalıdır.

Placekitten, yavru kedi görüntülerini yer tutucu olarak kullanan bir web sitesidir. Bir görüntünün boyutunu doğrudan URL'de seçmenize izin veriyorlar!

Aşağıdaki kodu ekleyerek ilk e-postamıza bir resim ekleyebiliriz.

<body>
  <amp-img
    src="https://placekitten.com/800/400"
    alt="Welcome"
    width="800"
    height="400"
  >
  </amp-img>
</body>

Duyarlı hale getirin

E-postalar, çeşitli cihazlarda ve ekran boyutlarında görüntülenir ve AMP yerleşik bir düzen sistemi ile birlikte gelir! amp-layout sistemi ve medya sorguları ile duyarlı e-postaların uygulanması kolaydır. Yerleştirilen yavru kedi resmimizi uygun ekranlara boyutlandırmak için <amp-image>'e layout="responsive" özniteliğini ekleyin.

<amp-img layout="responsive" src="https://placekitten.com/800/400" alt="Welcome" height="400" width="800"></amp-img>

Görüntüyü yeniden boyutlandırmak için tarayıcı penceresini büyütün ve küçültün! Desteklenen yerleşime özgü bileşenlerin listesini buradan görüntüleyin.

Sunum ve yerleşimi değiştirin

Bir görüntü iyidir, peki ya daha fazlasını görüntülemek istersek? E-posta için AMP, akordiyonlar ve kenar çubukları gibi yerleşim öğelerini destekler.

Bu eğitimde, sahiplendirmek üzere kedilerin fotoğraflarını görüntülemek için <amp-carousel> kullanacağız.

E-postanızın başına amp-carousel komut dosyasını ekleyin.

<script
  async
  custom-element="amp-carousel"
  src="https://cdn.ampproject.org/v0/amp-carousel-0.1.js"
></script>

Ardından ilk görüntümüzü <amp-carousel> etiketlerine yerleştirin.

<amp-carousel layout="responsive" width="800" height="400" type="slides">
  <amp-img
    layout="fill"
    src="https://placekitten.com/800/400"
    alt="Welcome"
    height="400"
    width="800"
  ></amp-img>
</amp-carousel>

Hiçbir şeyin değişmediğini fark edebilirsiniz ve bu iyi bir şeydir! Resim döngüsüne, type=slides özniteliği verildi, bu da bir seferde bir fotoğraf göstereceği anlamına geliyor. Etiketlere sadece bir fotoğraf yerleştirdiğimizden, kullanıcıya kaydırıcı oklar sunulmaz.

Ardından, yerleştirilen kedi yavrusu görüntüsünü, <amp-carousel> içinde sahiplendirmek için AMP kedilerinizle değiştirin.

<amp-carousel
  id="carousel-with-preview"
  width="800"
  height="400"
  layout="responsive"
  type="slides"
  on="slideChange:AMP.setState({currentCat: event.index})"
>
  <amp-img
    layout="fill"
    src="https://amp.dev/static/img/docs/tutorials/firstemail/photo_by_caleb_woods.jpg"
    alt="photo courtesy of Unsplash"
  ></amp-img>
  <amp-img
    layout="fill"
    src="https://amp.dev/static/img/docs/tutorials/firstemail/photo_by_craig_mclaclan.jpg"
    alt="photo courtesy of Unsplash"
  ></amp-img>
  <amp-img
    layout="fill"
    src="https://amp.dev/static/img/docs/tutorials/firstemail/photo_by_lightscape.jpg"
    alt="photo courtesy of Unsplash"
  ></amp-img>
  <amp-img
    layout="fill"
    src="https://amp.dev/static/img/docs/tutorials/firstemail/photo_by_nick_karvounis.jpg"
    alt="photo courtesy of Unsplash"
  ></amp-img>
</amp-carousel>

Artık resim döngüsünün sol veya sağ tarafındaki gezinme oklarını tıklayarak fotoğrafları değiştirebilmelisiniz!

Stil ile gönderin

AMP, belgenin başlığına <style amp-custom> etiketi içinde stil oluşturmanıza olanak tanır. Ayrıca, daha önce yasaklanmış CSS sınıfları ve sözde sınıflar artık kullanılabilir. Buradan tam listeyi okuyun.

Hello, AMP4EMAIL world öğesini gerçek bir başlıkla güncelleyelim.

<body>
  <h1>Adorable Adoptable Animals</h1>
  ...
</body>

Ve sonra başa biraz stil ekleyin.

<head>
  ...
  <style amp-custom>
    h1 {
      font-family: arial;
      margin: 10px;
    }
    .center {
      text-align: center;
    }
    .carousel-preview {
      margin-top: 10px;
    }
  </style>
</head>

Dinamik Yetenekler Ekleyin

Klasik olarak, e-postalar yalnızca durağan içeriğe izin verir. AMP sayesinde, e-postalar tamamen yeni bir olasılık dünyasına açılıyor! Kullanıcılar artık formlara yanıt verebilir, içeriği dinamik olarak listeleyebilir ve içerikle etkileşime girebilir.

Bu eğitimde, kullanıcı o kedinin slaytında olduğunda, sahiplendirilebilir kedimizin adını ve açıklamasını görüntülemek için <amp-bind> kullanacağız. amp-bind komut dosyasını e-postanızın başına ekleyerek başlayın.

<script
  async
  custom-element="amp-bind"
  src="https://cdn.ampproject.org/v0/amp-bind-0.1.js"
></script>

Ardından, bir <amp-state> etiketi içinde bir JSON dizesi olarak bir "myState" AMP bind değişkenini tanımlayacağız. Dört kedi fotoğrafımız olduğu için, dördü için de durum ekleyeceğiz.

<body>
  <amp-state id="myState">
    <script type="application/json">
      {
        "cats": [
          {
            "name": "Aakash",
            "description": "Very sweet gentleman that is quite shy in a shelter environment. He may hide under his blanket upon initial approach, but he is an affectionate lovebug."
          },
          {
            "name": "Filip",
            "description": "Friendly and enjoys pets and head rubs. Is known to sit on keyboards and refuses to touch anything with catnip on it."
          },
          {
            "name": "Julian",
            "description": "Both bold and extremely sweet. Wastes no time in investigating new smells, objects, and places, but enjoys lazing in the sun!"
          },
          {
            "name": "John",
            "description": "This playful and spirited cat would like to be outside his kennel and will be so happy when he gets to his forever home with more room to move."
          }
        ]
      }
    </script>
  </amp-state>
</body>

AMP eylemleri ve olayları farklı durumları tetikler. Bizim durumumuzda, kullanıcı resim döngüsündeki gezinti oklarına tıkladığında durumu güncellemek istiyoruz. amp-carousel, AMP.setState kullanarak currentCat değişkenini güncelleyeceğimiz bir slideChange olayını tetikler.

<h1>Adorable Adoptable Animals</h1>
<amp-carousel
  width="800"
  height="400"
  layout="responsive"
  type="slides"
  on="slideChange:AMP.setState({ currentCat: event.index} )"
>
  ...
</amp-carousel>

Bu kod, currentCat durumunu, resim döngüsü dizinindeki kedi fotoğrafıyla eşleşecek şekilde ayarlar. Dolayısıyla, event.index=2 slaytındaysak, durum dizinin 2. dizinindeki öğeyle eşleşecektir.

Geriye kalan tek şey kedimizin adını ve açıklamalarını göstermektir. Kapanış amp-carousel etiketinin altına aşağıdaki kodu ekleyin.

</amp-carousel>
<div class="center">
  <h1>
    <span [text]="myState.cats[currentCat].name">Aakash</span>  is available for adoption!
  </h1>
</div>

amp-bind eklentisi, içeriği dinamik olarak değiştirmek için ifadeler ve bağlamalar kullanır. Yukarıdaki kod örneği, "myState.cats[currentCat].name" ifadesini değerlendirerek durumu her değiştirdiğinizde <span> etiketindeki metni güncellemek için [text] bağlamasını kullanır.

Performans için ve beklenmedik içerik atlama riskini önlemek için, amp-bind sayfa yükündeki ifadeleri değerlendirmez. Bu, görsel öğelere varsayılan bir durum verilmesi ve ilk işleme için amp-bind güvenmemesi gerektiği anlamına gelir.

</div> etiketinden sonra kedi açıklamalarımızı eklemeyi unutmayın!

  </div>
  <p class="center">About <span [text]="myState.cats[currentCat].name"> Aakash</span></p>
  <p class="center" [text]="myState.cats[currentCat].description">Very sweet gentleman that is quite shy in a shelter environment. He may hide under his blanket upon initial approach, but he is an affectionate lovebug.</p>
</body>

Artık resim döngüsü, kedi fotoğrafını değiştirdiğinizde, isimleri ve açıklamaları da güncellenmelidir!

AMP e-postanızı gönderin

E-postanızı gelen kutunuza nasıl göndereceğinizi öğrenmek için AMP e-postalarını test etme hakkında daha fazla bilgi edinin

Tebrikler! İlk AMP e-postanızı gönderdiniz!

Sonraki adımlar için, e-posta temelleri için AMP hakkında daha fazla bilgi edinin.